激活契约
当需要审计、重构、规范化或改进现有的 SKILL.md 文件时，使用本技能。若需从可复用模式创建全新技能，请使用 gentle-ai-skill-creator。
硬性规则
- 首先阅读
docs/skill-style-guide.md，并将其视为规范性风格契约。 - 将
SKILL.md视为事实来源；保留作者意图、关键规则、激活语义和输出要求。 - 当可用时，使用
.atl/skill-registry.md作为技能名称、触发条件、作用域和精确路径的索引。 - 默认仅审计。仅当用户明确要求应用改进时才修改文件。
- 切勿在未经说明的情况下删除有意义的内容；将冗长的说明、示例、模板或模式移至本地的
references/或assets/目录。 - 不要虚构触发条件、策略或领域规则。对于模糊不清的情况，标记为以供人工审查。
决策门
| 情景 | 操作 |
|---|---|
| 前导元数据缺失或无效 | 修正 name、带引号的一行 description、license 和 metadata |
| 技能内容像教程文档 | 转换为运行时指令，并将背景信息移至 references/ |
| 主体内容超出预算 | 保留规则，将示例/背景移至辅助文件 |
| 分支逻辑隐藏在散文叙述中 | 转换为简洁的决策表 |
| 规则冲突或意图不明确 | 报告该问题；不要自动重写那条规则 |
执行步骤
- 阅读
docs/skill-style-guide.md。 - 阅读
.atl/skill-registry.md；使用列出的路径选择技能。如果缺失，扫描已知的技能目录以查找*/SKILL.md。 - 对每个选中的技能，审计其元数据、触发条件清晰度、章节顺序、主体预算、可操作性、决策门、输出契约和本地引用。
- 返回一个按技能分组、包含严重性和精确建议更改的审计报告。
- 在应用模式中，仅编辑安全的问题，保留内容，在需要时创建辅助文件，然后刷新或请求
/skill-registry:refresh。
输出契约
返回：
- 所审计的技能及使用的路径。
- 发现的问题，按严重性分组。
- 如果请求了应用模式，则列出更改的文件。
- 当技能元数据或路径发生更改时，给出注册表刷新建议。
- 需要人工审查的模糊之处。
参考文献
docs/skill-style-guide.md— 规范的 LLM 优先技能风格指南。skills/skill-registry/SKILL.md— 注册表刷新和索引契约。