your-skill-name

name	your-skill-name
description	用一句中文描述这个 skill 的触发场景。

技能标题

适用场景

• 描述会触发这个 skill 的用户请求或仓库状态。

必要输入

• 列出这个 skill 运行所需的最小输入。
• 明确哪些输入可以省略并通过自动探测补齐。

自动探测

• 说明这个 skill 应该优先检查什么。
• 写清显式输入、工作区线索和默认值之间的优先级。

执行步骤

1. 按顺序描述执行流程。
2. 保持足够具体，确保执行安全。
3. 明确默认命令、模式或产物偏好。

失败分流

• 将常见失败映射到 shared/failure-taxonomy.md 中的分类。
• 说明在什么情况下应该停下来询问，而不是继续猜测。

平台说明

• 只保留会影响本 skill 执行的宿主平台差异。

输出约定

• 定义预期的状态、摘要、证据和下一步动作。
• 列出这个 skill 会为 Project Profile 新增或更新哪些字段。

交接关系

• 说明在成功、部分成功或阻塞后，应该推荐哪个下游 skill。