skill-system-auditor

用途

Skill System Auditor 用于把技能集合当作一个系统来审计，而不是把技能当作彼此孤立的文件逐个检查。当用户提出对某技能仓库做全局一致性审计，或新增技能可能导致 README、AGENTS、CLAUDE、生命周期分类、角色分类过时，或需要对齐跨技能路由、配对指引与记忆回写期望时，可使用本技能。它也可用于把用户观察到的智能体回归转化为更强的路由规则、执行契约、模板或校验检查，清理已实现但仍被标为“未来技能”的引用、过时 TODO，以及对辅助路径、模板、前言、校验脚本做维护。

本技能不用于从零设计单个新技能；技能设计的机制应使用 skill-creator，然后用本技能检查设计产出的集合是否仍保持一致。

配对使用

skill-creator：当审计发现需要新增或修订技能说明时使用。
research-project-memory：当技能集合的路线图与决策需要持久化时使用。
update-docs：当文档漂移范围较广但不针对具体技能时使用。
safe-git-ops：在提交或从 Git 状态问题中恢复前使用。

技能目录结构

<installed-skill-dir>/
├── SKILL.md
└── references/
    ├── audit-rubric.md
    ├── doc-sync-map.md
    ├── agent-regression-hardening.md
    └── report-template.md

渐进式加载

始终阅读 references/audit-rubric.md 与 references/doc-sync-map.md。当审计由重复的智能体错误、未关闭的陈旧会话、技能未被激活、token 浪费、命令形态漂移或工作流回归触发时，阅读 references/agent-regression-hardening.md。撰写审计报告前阅读 references/report-template.md。如果仓库自带校验脚本或 AGENTS 说明，在做编辑前先阅读它们。

核心原则

审计生命周期行为，而不仅是文件是否存在。
技能集合应有清晰的阶段覆盖、角色覆盖、路由与交接点。
顶层文档必须与实际清单一致。
“未来技能”引用不应指向已经存在的技能。
记忆回写期望应覆盖每个会改变项目持久状态的技能。
保持修复最小化，不要仅为统一措辞而重写成熟技能。
把重复出现的智能体错误转化为更早的触发器、更硬的契约、具体的回退与可继承模板，而不仅是增加解释性文字。
在提交、推送或重装前先本地校验。

步骤 1 - 恢复仓库规则

阅读 AGENTS.md、CLAUDE.md、README 或等价仓库指引、校验脚本、技能目录布局、最近的审计报告或路线图记忆（如有）。记录期望的安装命令、校验命令，以及必须保持同步的文档文件。

步骤 2 - 盘点技能

从 skills/*/SKILL.md 构建实际清单。对每个技能记录：名称、描述触发器、生命周期阶段、角色类别、配对路由、辅助引用、记忆回写行为，以及它是计划中、已实现、已弃用还是重复。将其与 README、AGENTS、CLAUDE、清单与审计报告中的顶层表格进行比较。

步骤 3 - 审计生命周期覆盖

阅读 references/audit-rubric.md，检查以下环节：想法验证、文献与定位、算法设计、项目搭建、实验设计、基线选择、实验执行、结果诊断、证据捕获、写作与论文证据、审稿人模拟、引用覆盖与正确性、投稿、反驳、camera-ready、制品评估、发布与维护、导师或合作者沟通、技能系统维护。将缺口分类为：real-gap（缺少有用能力）、covered-by-existing（已有技能覆盖）、not-in-scope（超出仓库目的）、hardening（需要测试、示例或文档而非新技能）。

步骤 4 - 审计跨技能路由

检查每个技能在其输出自然流向另一阶段时是否路由到相邻技能。留意以下环节的缺失或过时引用：文献 -> 基线 -> 实验设计；实验结果 -> 诊断 -> 论文证据 -> 写作；审稿人模拟 -> 证据板 -> 实验/写作；反驳 -> camera-ready -> 制品/发布；导师反馈 -> 决策/行动/记忆；审计发现 -> 技能创建/文档更新。不要添加所有可能的交叉引用，只添加会改变用户下一步动作的交接。

步骤 5 - 审计记忆回写

检查会产生持久状态的技能是否更新或路由到记忆：决策、主张、证据、风险、行动、论文状态、代码/工作树状态、审稿与反驳状态、制品与发布状态、导师反馈、技能系统路线图决策。如果已存在记忆协议，应更新它，而不是在所有技能中重复记忆规则。

步骤 6 - 审计文档与过时引用

阅读 references/doc-sync-map.md，搜索：已实现但仍列为未来的技能、顶层表格中缺失的技能、旧的生命周期计数、过时的安装示例、过时的辅助路径、损坏的引用链接、重复表格条目、不一致的技能名称。可用时使用仓库校验脚本。

步骤 7 - 撰写审计报告

阅读 references/report-template.md。如需保存且未给出路径，使用 docs/audits/global-consistency-audit_YYYY-MM-DD.md。报告必须包含：范围、清单数量、生命周期决策、已修复的发现、未解决的发现、真正剩余的缺口、校验结果、推荐的下一技能或加固步骤。

步骤 8 - 修复、校验与交接

当用户要求实施修复时：做能恢复一致性的最小编辑；运行仓库校验命令；对过时技能名重新执行定向搜索；总结变更文件与剩余风险。仅在用户要求或本地工作流需要时提交、推送并重装。

最终检查

完成前确认：实际技能清单与顶层文档一致；生命周期与角色分类包含所有已实现技能；跨技能路由覆盖重要反馈回路；记忆回写覆盖会改变状态的技能；未来技能引用准确；校验通过；审计报告区分已修复问题与剩余缺口。

限制

本技能的基本信息来自其技能说明页面，未提供其他版本、收费、价格或平台信息。