mcpField
S
skill-system-auditor

skill-system-auditor

github.com/a-green-hand-jackAgent 工作流36 次安装
代码仓库

关于 skill-system-auditor

用于将一组技能作为整体进行审计的维护技能。它检查生命周期覆盖、技能路由、记忆更新要求和文档一致性，并指导针对性修复。

主要功能

  1. 01盘点技能与类别
  2. 02检查生命周期覆盖
  3. 03核对跨技能路由
  4. 04发现过时文档引用
  5. 05指导修复与验证

适用场景

  1. 01审计不断扩展的技能仓库
  2. 02新增或修订技能后检查文档
  3. 03将反复出现的 Agent 错误转化为更强规则

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/a-green-hand-jack/ml-research-skills --skill skill-system-auditor

安装后在 Claude Code 中输入/skill-system-auditor确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
agent-regression-hardening.md
audit-rubric.md
doc-sync-map.md
report-template.md

详细介绍

技能系统审计员

将技能集合视为一个系统进行审计，而不是孤立地检查技能文件。

在以下情况下使用此技能：

  • 用户要求对技能仓库进行全局一致性审计
  • 新增技能可能导致 README、AGENTS、CLAUDE、生命周期类别或角色类别过时
  • 跨技能路由、配套指导或记忆回写要求需要协调
  • 需要将用户观察到的 Agent 回归问题转化为更强的路由规则、执行契约、模板或验证检查
  • 需要清理对未来技能的引用、过时的 TODO 或已实现差距的提及
  • 辅助文件路径、模板、前置元数据或验证脚本需要维护
  • 用户想决定接下来还缺少哪些技能

不要使用此技能从头设计单个新技能。使用 skill-creator 掌握技能设计方法，然后使用此技能检查最终的技能集合是否仍然协调一致。

将此技能与以下技能配合使用：

  • 当审计结果需要新增或修订技能说明时，使用 skill-creator
  • 当技能集合的路线图和决策需要持久保存时，使用 research-project-memory
  • 当文档偏差范围广泛且不限于技能时，使用 update-docs
  • 在提交或处理 Git 状态问题前，使用 safe-git-ops

技能目录布局

<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。
  • 如果审计由 Agent 反复出错、会话过期未关闭、技能未激活、令牌浪费、命令格式偏差或工作流回归触发，则阅读 references/agent-regression-hardening.md。
  • 编写审计报告前，阅读 references/report-template.md。
  • 如果仓库有自己的验证脚本或 AGENTS 说明，则在进行编辑前阅读。

核心原则

  • 审计生命周期行为，而不只是文件是否存在。
  • 技能集合应明确覆盖各个阶段和角色，并定义路由与交接点。
  • 顶层文档必须与实际技能清单一致。
  • “未来技能”引用不应列出已存在的技能。
  • 记忆回写要求应涵盖所有会更改持久项目状态的技能。
  • 修复应精准克制。不要仅为统一措辞而重写成熟的技能。
  • 将反复出现的 Agent 错误转化为更早触发、更严格的契约、具体的回退方案和可继承的模板，而不只是添加解释性文字。
  • 在提交、推送或重新安装前，在本地进行验证。

步骤 1 - 了解仓库规则

阅读：

  • AGENTS.md、CLAUDE.md、README 或同等的仓库指南
  • 验证脚本
  • 技能目录布局
  • 近期审计报告或路线图记忆（如有）

记录预期的安装命令、验证命令，以及必须保持同步的文档。

步骤 2 - 清点技能

根据 skills/*/SKILL.md 建立实际技能清单。

对每项技能记录：

  • 名称
  • 描述中的触发条件
  • 生命周期阶段
  • 角色类别
  • 配套路由
  • 辅助文件引用
  • 记忆回写行为
  • 状态是计划中、已实现、已弃用还是重复

将此清单与 README、AGENTS、CLAUDE、清单文件和审计报告中的顶层表格进行比较。

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

阅读 references/audit-rubric.md。

检查以下环节：

  • 想法验证
  • 文献调研与定位
  • 算法设计
  • 项目设置
  • 实验设计
  • 基线选择
  • 实验执行
  • 结果诊断
  • 证据记录
  • 写作与论文证据
  • 审稿人模拟
  • 引文覆盖与准确性
  • 投稿
  • 答辩
  • 终稿制作
  • 制品评估
  • 发布与维护
  • 与导师或合作者沟通
  • 技能系统维护

将差距分类为：

  • real-gap：缺少有用的能力
  • covered-by-existing：现有技能已涵盖
  • not-in-scope：超出仓库用途范围
  • hardening：需要测试、示例或文档，而不是新增技能

第 4 步 - 审计跨技能路由

检查每项技能是否会在其输出自然衔接到另一个阶段时，路由到相邻技能。

检查以下环节是否缺少引用或引用已过时：

  • 文献 -> 基线 -> 实验设计
  • 实验结果 -> 诊断 -> 论文证据 -> 写作
  • 审稿人模拟 -> 证据板 -> 实验/写作
  • 反驳 -> 终稿 -> 工件/发布
  • 顾问反馈 -> 决策/行动/记忆
  • 审计发现 -> 创建技能/更新文档

不要添加所有可能的交叉引用。只添加会改变用户下一步行动的交接。

第 5 步 - 审计记忆回写

检查会创建持久状态的技能是否会更新记忆或将信息路由到记忆：

  • 决策
  • 主张
  • 证据
  • 风险
  • 行动
  • 论文状态
  • 代码/工作树状态
  • 审稿人和反驳状态
  • 工件和发布状态
  • 顾问反馈
  • 技能系统路线图决策

如果已有记忆协议，请更新该协议，而不是在所有技能中重复记忆规则。

第 6 步 - 审计文档和过时引用

阅读 references/doc-sync-map.md。

搜索以下内容：

  • 已实现的技能仍被列为未来技能
  • 顶层表格遗漏技能
  • 生命周期数量过时
  • 安装示例过时
  • 辅助工具路径已废弃
  • 引用链接失效
  • 表格条目重复
  • 技能名称不一致

如有仓库验证脚本，请使用。

第 7 步 - 编写审计报告

阅读 references/report-template.md。

如果要保存报告但未指定路径，请使用：

docs/audits/global-consistency-audit_YYYY-MM-DD.md

报告必须包含：

  • 范围
  • 清单数量
  • 生命周期决策
  • 已修复的发现
  • 尚未解决的发现
  • 实际存在的剩余缺口
  • 验证结果
  • 建议的下一项技能或加固步骤

第 8 步 - 修复、验证并交接

当用户要求实施修复时：

  1. 进行最小限度的修改，以恢复一致性。
  2. 运行仓库验证命令。
  3. 重新执行针对性搜索，查找过时的技能名称。
  4. 总结变更的文件和剩余风险。
  5. 仅在用户要求或本地工作流需要时才提交、推送和重新安装。

最终检查

完成前请确认：

  • 实际技能清单与顶层文档一致
  • 生命周期和角色类别涵盖所有已实现的技能
  • 跨技能路由涵盖重要的反馈循环
  • 状态变更型技能均包含记忆回写
  • 未来技能的引用准确
  • 验证通过
  • 审计报告区分已修复的问题和剩余缺口

评论

支持 Markdown