Community写作与编辑github.com

rogerchappel/skill-drift-audit-skill

审计 SKILL.md 是否与仓库文档、脚本、示例和发布说明存在偏差

skill-drift-audit-skill 是什么?

此技能专为 AI 代理(如 Claude Code、Cursor、Codex 等)设计,用于检测代理技能仓库中 `SKILL.md` 文件与 README、文档、包脚本、示例和发布说明之间的“偏差”或不一致。当开发者在进行技能审查或更新时,它可以提供具体证据,证明 SKILL.md 是否仍然准确反映仓库的实际状态。该技能通过扫描本地文件,以 Markdown 或 JSON 格式输出报告,并且默认不会修改 `SKILL.md` 或调用外部服务,从而保证了安全性和可审计性。它适用于任何包含 `SKILL.md` 的本地仓库,并支持可选的 README、文档、包元数据、变更日志和发布候选说明作为输入,帮助开发者快速定位文档与实现之间的差异。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add rogerchappel/skill-drift-audit-skill

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

技能偏差审计技能

何时使用

在审查或刷新代理技能仓库时,如需证明 SKILL.md 仍与 README、文档、包脚本、示例和发布说明保持一致,请使用此技能。

必需输入

  • 包含 SKILL.md 的本地仓库路径。
  • 可选的 README、文档、包元数据、变更日志和发布候选说明。

副作用边界

scan 命令读取本地文件并将报告写入标准输出。plan 命令仅写入指定的 --output 路径。默认情况下,此技能不得重写 SKILL.md、调用外部服务、发布包或修改发布工件。

批准要求

在编辑持久化的技能指令、删除示例、发布包或将审计报告发送到本地工作区之外之前,请请求明确批准。

示例

skill-drift-audit scan . --format markdown
skill-drift-audit scan fixtures/stale-skill --format json
skill-drift-audit plan . --output tmp/skill-drift-plan.md

验证工作流

在依赖此技能之前,请运行以下命令:

npm run check
npm test
npm run smoke
npm run package:smoke

相关技能