技能介绍

解决技能开发的“过早实现”问题

在构建 AI Agent 技能时，开发者常犯的错误是跳过设计直接编写 SKILL.md 或脚本。这往往导致技能边界模糊、资源滥用，甚至把一次性的主观判断硬编码进 scripts/ 目录。Spec Skill Builder 的核心目的是强制引入“设计前置”流程，确保每个技能都是经过深思熟虑的可复用能力模块，而非杂乱无章的代码堆砌。

核心工作流与设计工件

该技能首先通过场景提取（Scenario Intake）梳理用户目标、触发条件与重用频率，随后在四种类型中选定主类型：

Type A：纯提示词，适用于推理与规划。
Type B：提示词加脚手架，适用于需要模板与参考的工作流。
Type C：逆向工程，从现有项目中提取可复用行为。
Type D：铺路脚本，将脆弱或数据密集型任务沉淀为确定性脚本。

技能会优先生成包含资源决策和验证清单的设计工件。只有在用户明确要求“实现”时，才会交接给底层的 skill-creator 工作流去生成可执行文件，并严格校验 references/、scripts/ 和 assets/ 的合理性。

适用边界与注意事项

该技能最易被误用的环节是“脚本沉积（Script Deposition）”。规范明确指出，纯主观写作或一次性判断不应转化为脚本。对于 Type C 和 Type D，技能设定了严格的准入阈值，要求开发者在设计前必须阅读特定的反向工程或铺路模式参考文档。此外，铺路脚本必须输出到任务目录而非技能自身的 scripts/ 目录，且必须附带完整的调度与参数文档，避免产出无法维护的“死代码”。