By name: your-skill-name description: 用一句中文描述这个 skill 的触发场景。
技能标题
适用场景
- 描述会触发这个 skill 的用户请求或仓库状态。
必要输入
- 列出这个 skill 运行所需的最小输入。
- 明确哪些输入可以省略并通过自动探测补齐。
自动探测
- 说明这个 skill 应该优先检查什么。
- 写清显式输入、工作区线索和默认值之间的优先级。
执行步骤
- 按顺序描述执行流程。
- 保持足够具体，确保执行安全。
- 明确默认命令、模式或产物偏好。
失败分流
- 将常见失败映射到
shared/failure-taxonomy.md中的分类。 - 说明在什么情况下应该停下来询问，而不是继续猜测。
平台说明
- 只保留会影响本 skill 执行的宿主平台差异。
输出约定
- 定义预期的状态、摘要、证据和下一步动作。
- 列出这个 skill 会为
Project Profile新增或更新哪些字段。
交接关系
- 说明在成功、部分成功或阻塞后，应该推荐哪个下游 skill。