用途：这是面向指令系统设计的 skill，核心目标是诊断具体失败模式、减少歧义、把规则放到正确层级，持续改进 AGENTS.md、SKILL.md、prompt 架构、skill description 与 routing。适用场景包括评估或重写 AGENTS.md、把大 prompt 拆成多个 skills、重写 skill description 提高触发精度、判断规则应放在 global、skill、repo-local AGENTS、tooling 还是 MCP、为 prompt/skill 设计 regression tests 或 eval prompts、诊断反复出现的 prompt failure。不适用普通编码调试、知识创作或领域决策支持。
诊断流程：先判断是否真属于 prompt、routing 或 instruction design 问题；若更可能是 context 不足、tooling/MCP 缺口、repo 局部约束缺失、模型能力边界或缺少 eval，应先在这些地方修。随后明确 symptom 或重复摩擦，给 failure 分类，判断修复层级，只提最小有效改动，并说明收益、回归与受影响任务，指定如何用最小 eval 包验证。失败类型包括 mode-selection、scope-control、evidence/verification、quality-bar、format/delivery、knowledge-traceability、decision-calibration、over/under-constraint、routing-description、instruction redundancy/contradiction。
层级划分：global AGENTS 只保留总是生效、跨任务、低歧义规则；skill 承载可复用专项工作流、领域协议、模板、负例与质量门槛；repo 或目录级 AGENTS 放仓库特定命令、约定与局部 routing 提示；确定性约束优先交给 tests、linters、formatters、scripts 或 evals；缺外部系统访问能力时优先考虑 tool 或 MCP 集成。
变更记录模板按顺序输出：observed symptom、evidence、likely root cause、failure class、placement layer、minimal change、eval plan、rollback signal。description 规则：单行文本，只写触发场景，不写 Do not use when、Outputs、Success；中文优先并补常见英文 trigger words；它是 routing 逻辑而非营销文案，边界、反例、输出要求与完成标准放正文；误触发或漏触发先改 description。
改动策略：规则少而强，合并或删除重叠指令，用可观察行为替代抽象口号；写入 DSL、Preset、Reference、字段 schema 前先确认对象边界、目标使用者与评估函数稳定；无行为改变不新增规则；运行时提示保持精简。验证上至少准备 2 个 should-trigger、2 个 near-miss should-not-trigger、1 个 baseline 对照和 1 个 held-out case；跨任务 routing 改动应维护稳定任务集。输出时要求给出具体改写文本，诊断与建议改动分开，拆分时同时给出拆出 skills 与剩余 global prompt。反模式包括膨胀 global prompt、为完整而加规则、问题在 description 却堆正文、保留矛盾重复规则、未做真实回归就接受改动。