Community寫作與編輯github.com

rogerchappel/skill-drift-audit-skill

稽核 SKILL.md 與倉庫的文件、腳本、範例和版本發佈說明之間的偏差

skill-drift-audit-skill 是什麼?

此技能專用於檢查與更新 AI 代理技能(如 Claude Code 或 Cursor)的倉庫,確保 `SKILL.md` 描述與倉庫中實際的 README、文件、npm 腳本、範例以及發行說明保持一致。它從本地是路徑掃描這些文件,並以 Markdown 或 JSON 格式輸出稽核報告。技能預設是唯讀的,不會修改檔案或呼叫外部服務,因此可安全地在 CI/CD 流程中使用。使用者必須明確批准才能編輯指令或發佈報告,非常適合在發布前進行品質驗證與合規稽核。

相容平台✓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 Drift Audit Skill

使用時機

當您需要審查或更新一個 agent-skill 倉庫,並且需要證據證明 SKILL.md 仍然與 README、文件、套件腳本、範例和發行說明一致時,使用此技能。

必要輸入

  • 一個包含 SKILL.md 的本地儲存庫路徑。
  • 可選的 README、文件、套件元資料、變更日誌和候選發行說明。

副作用邊界

scan 讀取本地檔案並將報告寫入 stdout。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

相關技能