开发技能

本文以“缺陷报告规范化”技能为例，演示从输入需求、生成技能包、预览测试，到发现问题后继续迭代和回归验证的完整过程。

准备工作

开始前先确定以下内容：

项目	要说明的内容
目标	技能要稳定解决什么问题
输入	用户会提供哪些文本、文件或字段
规则	分类、校验、优先级和异常处理方式
输出	返回格式、字段、语言和质量要求
边界	哪些情况必须追问、拒绝或标记待补充
测试	正常、缺字段、边界和敏感信息用例

步骤一：输入技能需求

进入 AI 编程，选择 技能。在输入框中说明技能目标、输入输出、判断规则和测试要求。

本例需求的关键内容为：将未经整理的缺陷描述转换为中文 Markdown 报告；严重级别只允许“阻塞、严重、一般、建议”；不得虚构缺失信息；手机号、邮箱、访问令牌和密钥必须隐藏；同时生成正常、缺少关键信息和包含敏感信息三类测试用例。

建议使用可验证的表达。例如，不要只写“自动判断严重程度”，而应写出允许值以及每个值对应的条件。

步骤二：检查生成结果

提交后，AI 会在 Agent Studio 中创建项目，并根据需求生成技能目录、SKILL.md、脚本、参考规则、测试用例和打包产物。左侧会显示生成过程和版本，右侧可打开预览。

生成完成后重点检查：

• SKILL.md 是否准确说明触发条件、执行步骤和限制。
• 脚本是否只处理确定性逻辑，并对错误输入给出可见结果。
• 参考规则是否与需求一致，是否存在互相冲突的判定。
• 测试用例是否覆盖正常、缺失、异常和安全场景。
• 打包产物是否已生成，且不包含凭证或不应公开的数据。

步骤三：预览并测试技能

在右侧预览区输入真实案例。测试文本应包含足够的业务影响信息，也可加入敏感数据验证隐藏规则。

查看技能是否生成了目标格式，并逐项核对字段、分类、缺失信息、敏感信息和建议操作。

本次真实测试发现两个问题：脚本把核心流程完全中断误判为“一般”，敏感信息处理说明仍可能保留原值片段。这说明“生成时自测通过”不能替代右侧预览中的真实验收。

步骤四：输入新需求修复问题

在左侧输入框直接描述可复现输入、实际结果、期望结果和安全要求。应指出需要修改的规则，并要求补充回归测试。

修复完成后，平台会生成新版本并展示变更内容。本例新增了阻塞级别回归条件，并要求所有输出和说明统一使用 [已隐藏]，不得保留原值、掩码片段或后缀。

步骤五：运行回归测试

修改完成后，先单击预览区的清空按钮清除旧对话；如仍显示旧结果，刷新项目页面并重新打开预览。然后使用与首次测试完全相同的输入再次验证。

回归时至少确认：

• 原问题已经修复，并且最终输出符合技能约定。
• 新规则没有破坏正常输入和缺失信息处理。
• 正文、说明、日志和示例均未泄露敏感数据。
• 预览使用的是最新版本，而不是修改前的旧会话。

选择开发模型

左侧输入区可打开 选择模型。保持“自动”可由平台选择模型；也可以根据项目权限选择列表中的其他模型。更换模型可能影响生成速度和结果风格，重要技能应固定测试输入重新验收。

查看和回退版本

单击项目名称旁的历史按钮，可查看每次生成或修复对应的版本、时间和变更记录。回退前先查看修改记录，确认不会覆盖仍需保留的更改。

配置部署

测试通过后，打开 部署，选择已验证的版本、CPU、内存和生产环境变量。不要把凭证写入技能文件或需求文本；如技能确实依赖外部服务，应通过受控环境变量提供。

部署只负责让技能项目按指定版本运行；要面向技能市场或企业成员分发，还需进入 发布技能 完成上架。