用途：这是 Claude Code 智能体与技能触发失败问题的参考目录，把真实插件中观察到的触发错误整理成清单，供发布前检查，也用于排查插件安装成功却无反应的情况。
主要能力：提供症状到成因的快速分诊表，例如技能目录存在却不加载、智能体无法按名调用、触发不稳定、多个技能争抢同一查询、描述匹配到无关查询、模型字段缺失等。归纳九类典型反模式，按 P0/P1/P2 分级并给出修复方向，包括缺少 YAML frontmatter、使用已废弃的 agent: true、描述只写做什么不写何时用、缺少 <example> 块、YAML 描述中混入 Windows/文档样板、未设置 model: inherit、触发短语重叠、描述超长或触发词稀释。还给出描述长度上限：400-1000 字符为推荐目标，1024 字符为 API 硬上限，1536 字符为列表上限，并建议把触发词前置。
使用方式：从仓库根目录按 P0 到 P2 优先级运行审计扫描，定位触发缺陷；用 scripts/validate_plugins.py 作为质量门禁，可运行 python scripts/validate_plugins.py、--plugin my-plugin 或 --strict。发布前执行 26 项检查清单，并运行代码样例检查，确保围栏代码块内无智能标点、每个代码块带语言标签、可执行片段标明平台。提交前还有大小门禁与 DRY 门禁。
适用场景：编写或审计 Claude Code 插件、智能体与技能时使用。
限制：审计时需先做意图检查，避免把有意精简的编排器误判为缺陷；具体规则以校验器为准。部分细节位于引用文件中，资料未提供其完整内容。