技能常见问题

为什么“选择编程技能”中没有目标技能？

先确认当前工作空间和账号正确，并检查技能是否已在 技能管理 中启用。市场技能需先添加或使用；本地技能需先通过 上传技能 导入。随后重新打开选择面板并按名称搜索。

支持上传哪些文件？

当前 AI 编程技能选择器支持 .zip 和 .skill。上传前应确认包内包含有效的 SKILL.md，目录结构正确，并且不包含密码、令牌、密钥或个人数据。

一个项目可以选择多少个技能？

当前面板显示上限为 50 个。建议只选择与当前任务直接相关的技能；技能越多，越容易出现规则重复或冲突。

为什么选择技能后结果没有变化？

检查以下事项：

1. 技能是否已经出现在已选列表，并在确认后保存。
2. 需求是否明确说明该技能负责的范围和期望结果。
3. 输入是否满足技能的触发条件和必填信息。
4. 当前项目是否仍在使用旧技能版本或旧预览会话。

更新技能后，先清空右侧预览历史；如仍显示旧结果，刷新项目页面并重新打开预览，再用相同案例验证。

生成时显示测试通过，是否还需要预览？

需要。生成过程中的测试只能证明已执行预设用例，不能替代真实场景验收。应在右侧预览中至少验证正常、缺失、边界和敏感信息四类输入，并逐项核对实际输出。

技能预览结果不符合规则，怎样修改？

在左侧输入框说明：可复现输入、实际结果、期望结果、需修改的规则和新增回归用例。修改完成后查看新版本，再使用完全相同的输入进行回归测试。

部署和上架有什么区别？

部署在 Agent Studio 中选择运行版本、CPU、内存和生产环境变量；上架在技能管理中决定分发到技能商店或企业，并填写展示、计费和审核信息。部署成功不等于已经在技能市场公开。

为什么没有“上架到企业”入口？

确认当前处于企业工作空间，并检查账号是否具备企业技能发布权限。企业审批配置也可能限制该入口。

为什么商店上架后没有立即可用？

公开商店申请需要审核。当前页面提示预计约 5 个工作日，实际以审核状态为准。不要重复提交同一内容版本。

如何避免技能泄露敏感信息？

• 不把凭证或生产地址写入 SKILL.md、脚本、参考资料和测试样例。
• 对正文、处理说明、日志和示例统一执行脱敏，不保留原值片段或后缀。
• 外部服务参数使用受控环境变量。
• 发布前用包含手机号、邮箱、令牌和密钥的专门用例验证。

是否可以回退技能版本？

可以在 Agent Studio 的历史记录中查看版本和修改记录，并使用回退入口。回退会改变后续开发基线，操作前先确认需要保留的改动，并在回退后重新测试。