Communityライティング&編集github.com

rogerchappel/skill-drift-audit-skill

SKILL.md のドリフトをリポジトリ内のドキュメント、スクリプト、サンプル、リリースノートに対して監査します。

skill-drift-audit-skill とは?

このスキルは、AIエージェントスキルリポジトリにおいて、`SKILL.md` が README、ドキュメント、パッケージスクリプト、サンプルコード、リリースノートと一致しているかを自動的に監査するためのツールです。開発者が手動で確認する手間を省き、ドキュメントの陳腐化(ドリフト)を検出します。主にClaude CodeやCursorなどのAIエージェント環境で使用され、`scan` コマンドでファイルを読み取りレポートを標準出力に書き出し、`plan` コマンドで変更計画を特定の出力パスに書き出します。`SKILL.md` の自動書き換えや外部サービスへの送信は行わず、承認なしの永続的変更を防止する安全設計となっています。

対応✓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に質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Skill Drift Audit 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

関連スキル