audit-library-health

ライブラリの健全性を監査する

目標

スキルライブラリに一貫性があり、最新の状態で、共有またはインストールできる状態であることを確認します。

ガードレール

• 健全性チェックを自動化する場合は、構造化出力に必ず --format json を使用してください。
• build-docs を実行する前に、ドキュメントがすでに同期されているかを確認するため、必ず --dry-run を使用してください。
• validate と doctor の両方に合格する前に、ライブラリを共有リポジトリにプッシュしないでください。
• 大規模なカタログを調べる場合は、出力を絞り込むために --fields を使用してください。

ワークフロー

1. 検証スクリプトを実行して、カタログの整合性を確認します。

npx ai-agent-skills validate

必須フィールド、フォルダーの一貫性、フロントマターの妥当性、コレクションの整合性、生成されたドキュメントの同期状態を確認します。

2. doctor を実行して、インストール済みスキルの健全性を確認します。

npx ai-agent-skills doctor --format json

3. 更新が必要な可能性のあるスキルを確認します。

npx ai-agent-skills check --format json

4. 生成されたドキュメントが同期されていることを確認します。

npx ai-agent-skills build-docs --dry-run --format json

currentlyInSync が false の場合は、再生成します。

npx ai-agent-skills build-docs

5. 対応が必要なスキルがないか、キュレーションキューを確認します。

npx ai-agent-skills curate review --format json

健全性チェックリスト

• validate がエラーなしで完了する
• doctor で壊れたインストールが報告されない
• build-docs --dry-run でドキュメントが同期されていると表示される
• whyHere フィールドが空のスキルがない
• すべてのハウススキルに skills/ 内の対応するフォルダーがある
• skills.json の合計数が実際のスキル数と一致する

注意点

• validate と doctor は読み取り専用で、ライブラリを変更することはありません。
• check は、上流ソースを確認するためにネットワークリクエストを行います。到達できないリポジトリがあると、時間がかかったりタイムアウトしたりする場合があります。
• curate review キューは、欠落しているフィールドと古くなった検証日から生成されるヒューリスティックなものであり、必須事項ではありません。