Skills-Summarize-Audit — スキルライブラリとプロジェクトプロファイル駆動型監査(summarize 連携)
スキルライブラリまたは現在のプロジェクトに対して多次元プロファイリング、7次元スコアリング、容量分析、最適化レコメンデーションを実施し、実行可能な監査レポートを出力します。
これがあなたにできること:
- スキルライブラリの健全性(🟢/🟡/🔴)と変化傾向(📈 ↑/↓)を把握
- ゾンビスキルや冗長な重複を発見
- エージェントがあとどれだけスキルをインストールできるかを計算(多因子有効容量警告)
- 実行可能なアーカイブ/インストール/アップデート操作リストを取得
- 誤操作後はワンクリックでロールバック(
--undo)- CI/CD パイプラインに統合(JSON出力+ゲートロジック)
トリガーワード / Trigger Words
このスキルは独立語トリガーを採用しています。トリガーワードは独立して送信する必要があり(サブコマンド可)、文中ではトリガーされません。summarize スキルと連携して設計されており、スキル総括 から直接監査を起動できます。
- スキル監査:
技能审查、技能审计、技能检查、能力审查、能力审计、工具审查、技能总结、skills-audit、skill-audit、skill-check、capability-audit、tool-audit、skills-summarize-audit - プロジェクト監査:
项目审查、项目审计、项目诊断、项目画像、环境审查、环境审计、project-audit、project-check、project-diagnosis、project-profile、env-audit - ロールバック操作:
回滚、撤销、恢复、undo-snapshot、rollback、revert - サブコマンド:
深度/deep、推荐/recommend、画像/profile、健康/health、轻量/quick、ci/--ci、回滚/undo/--undo
トリガーワードマトリックス
| モード | 中国語トリガー | 英語トリガー |
|---|---|---|
| スキル監査 | 技能审查, 技能审计, 技能检查, 能力审查, 能力审计, 工具审查, 技能总结 | skills-audit, skill-audit, skill-check, capability-audit, tool-audit, skills-summarize-audit |
| プロジェクト監査 | 项目审查, 项目审计, 项目诊断, 项目画像, 环境审查, 环境审计 | project-audit, project-check, project-diagnosis, project-profile, env-audit |
| ロールバック操作 | 回滚, 撤销, 恢复 | undo-snapshot, rollback, revert |
類義語:審査=監査=チェック=診断、能力=スキル=ツール、環境=プロジェクト → 自動的に対応モードに分類されます。
トリガー動作
| トリガーする ✅ | トリガーしない ❌ |
|---|---|
技能审查(独立送信) | 帮我做一次技能审查(文中) |
skills-audit skills-summarize-audit(独立送信) | run skills-audit on this(文中) |
技能总结(独立送信、summarize ブランド連携) | 总结一下技能(文中トリガーしない) |
技能审计 深度(独立語+サブコマンド) | 这个项目需要能力审查吗(文中) |
言語適応: ユーザーの主要言語が英語の場合(セッション内の英語が70%超)、トリガーワードのマッチングは英語を優先し、レポート出力言語は en に切り替わります。
いつ使うか / When to Use
- スキル監査モード: スキルライブラリの健全性を定期的に維持するため(2〜4週間に1回推奨)、またはスキルライブラリに大規模な変更があった場合。
summarizeと連携可能:run summarize → スキルの蓄積を発見 →技能总结を提案 - プロジェクト監査モード: 新しいプロジェクトを引き継ぐ際に技術スタックとツールチェーンを素早く把握したい場合、またはプロジェクトのリファクタリング前に環境の健全性を評価したい場合
- トリガーワード翻訳精錬: スキルの説明を自動的に中国語のトリガーワード+概要(またはその逆)に翻訳し、言語横断的なユーザーがスキルの機能を素早く理解できるようにします
前提条件 / Prerequisites
ハード要件(欠落時は自動検出+インストールガイド)
- codegraph — コード構造とシンボルクエリ、スキルコア分析エンジン。欠落時は自動インストールを試みます。
- git — バージョン比較、スナップショット、ロールバック。欠落時は自動インストールを試みます。
- config.yaml — このスキルディレクトリ内の唯一の設定ソース。欠落時はテンプレートから生成します。
ソフト要件(欠落時は自動作成)
- user-profile.md — ユーザープロファイル。欠落時はQ&Aガイドにより自動的に作成されます。
機能一覧 / Capabilities
skills-summarize-audit は以下のコア機能を提供します(v6.0.0 で新たに機能マトリックス、品質シグナル、コミュニティフィード、エコロジーレーダーを追加):
- プロジェクト技術スタックのプロファイリングとプロジェクトタイプの識別
- スキルライブラリの全量スキャンと増分リスト作成
- 機能次元マトリックスの構築(約12機能次元、v6.0.0)
- 品質シグナルの読み取り(summarize エラーログとの連携、v6.0.0)
- 多因子有効容量分析と容量警告
- 6項目のスキル活性チェック
- 7次元 S/A/B/C/D スコアリングと強制理由付け
- T3 活性検証と誤アーカイブリスク制御
- コミュニティフィード検索(機能ギャップに基づく GitHub 検索、v6.0.0)
- 機能補完性に基づくツールレコメンデーション(代替/補完/追加/無関係、v6.0.0)
- エコロジーレーダーブロック(条件付き出力、問題がある場合のみ表示、v6.0.0)
- スキル単位の深層読み取りと外部ソース検証
- 外部シグナルキャッシュと3層レコメンデーションエンジン
- 30秒サマリーレポートとトレンド比較
- スナップショットバックアップと
--undoロールバック - CI/CD 非対話モードと JSON ゲート出力
- トリガーワード翻訳精錬と説明品質チェック
実行フェーズ別の詳細機能表:
| フェーズ | 機能 | 説明 |
|---|---|---|
| ⓪ 設定 | マルチプラットフォーム適応 | Codex/Claude/Cursor/Coze プラットフォーム自動検出 |
| ① プロファイリング | プロジェクト技術スタックスキャン | 15以上のプロジェクトタイプを自動認識(Web/Rust/Python/Go/Java...) |
| ② リスト作成 | スキルライブラリ全量スキャン+機能マッピング | 4つのパスをスキャン + capability-dimensions.yaml マッピング(v6.0.0) |
| ②-bis | 容量分析 | 多因子有効容量計算(トークン + 競合因子 + 認知容量) |
| ②-ter | 活性チェック | 6項目のチェックでスキルの使用可能性を検証(Agent到達性/MCP/コマンド/トリガー/データ/使用証拠) |
| ④ スコアリング | 7次元スコアリング+品質シグナル | 7次元スコアリング + summarize エラーログの読み取り(v6.0.0) |
| ④-a | T3 活性検証 | アーカイブ前に使用証拠/更新日時/トリガーレコードを確認し、誤アーカイブ率を低減 |
| ④-bis | 深層読み取り | S/A 全量深読、B(プロファイル関連)全量、B(非関連)簡略 |
| ⑤a | 外部シグナル | GitHub⭐/npm📥 キャッシュ収集 |
| ⑤-aa | コミュニティフィード | 機能ギャップに基づく GitHub 検索(v6.0.0) |
| ⑤b | 機能マトリックスレコメンデーションエンジン | 機能補完性に基づくレコメンデーション(代替/補完/追加/無関係、v6.0.0) |
| ⑥ | レポート生成+エコロジーレーダー | 30秒サマリー + 容量ブロック + スコア表 + 条件付きエコロジーレーダーブロック(v6.0.0) |
| ⑦-a | スナップショットバックアップ | 実行前にすべての編集可能スキルを自動バックアップ |
| ⑦-d | 操作ロールバック | --undo で任意の実行操作を元に戻し、7日間スナップショットを保持 |
| CI | 非対話監査 | JSON出力 + health/t3/actions の3つのゲートで GitHub Actions と統合 |
使うべきでない場合 / When NOT to Use
- 単発のファイル編集、リアルタイムデバッグ、極小プロジェクト(スキル依存なし)、単一スキルのインストールのみ
- 低リソース環境(監査は1回あたり約5K〜15Kトークンを消費)
実行フロー
トリガー後、最初に
references/execution-flow.mdを読み取り、完全なフロー、スコア表、容量計算、レポートテンプレート、CIルールを取得します。メインファイルにはエントリと主要ルールのみを残します。
⓪前提設定 → ①プロジェクトプロファイリング → ②スキルリスト+容量収集 → **②-ter活性チェック**
→ ③参照データ読み込み → ④階層スコアリング
→ ④-bis深層読み取り → ⑤外部シグナル+レコメンデーション → ⑥レポート生成 → ⑥-bis監査検証 → ⑦実行 → ⑧永続化
主要ルール
- プロファイリング: カレントディレクトリのみスキャン。データソースからペインポイントを抽出し、推測は禁止。結果は
{project}/.agents/project-profile.mdに書き込む - 階層化: T1(コアアクティビティに該当)→ 保持;T2(汎用)→ 保持;T3(専門)→ アーカイブ推奨
- スコアリング: 7次元 S/A/B/C/D。各スキルに1文の理由を付与;理由なし=未評価
- 容量: エージェントが許容できる上限を計算。追加可能数 ≤1 → 🔴、2〜4 → 🟡、≥5 → 🟢
- 外部シグナル: GitHub⭐は7日間キャッシュ、npm📥は30日間キャッシュ。ネットワーク不可の場合はスキップして注釈を付け、偽造禁止
- レコメンデーション: 各レコメンデーションに信頼度指数(0-10)+ROIを付与。<7 の場合は「評価中」と明記、<5 の場合はデータによる裏付けが必要
- 実行: ユーザー層のスキルのみ変更(editable=true)。システムスキルは読み取り専用
- 黄金律: スキルの開発/変更/レコメンデーションに関わる場合、まず検索・検証し、≥2 の独立したソースを引用
- 活性チェック: 初回監査では全量チェック。以降は新規インストールスキルのみチェック。
深度サブコマンドは強制全量チェック。異常時は単一スキルのバイオプシーをトリガー
出力例
技能审查 をトリガーすると、最初に30秒サマリーブロックが出力されます:
🟢 スキルライブラリ健全性:良好
🛠️ 主要操作:1つの遅れているスキルを更新、2つのT3スキルをアーカイブ
💰 推定節約:~3200トークン/回(低価値スキルの注入を削減)
続いてスコア表の断片が出力されます(例):
| スキル | 総合 | Fit | Value | Fresh | Community | ROI | Novelty | Contamination | 推奨 |
|---|---|---|---|---|---|---|---|---|---|
| codegraph | S | 5 | 5 | 4 | 4 | 5 | 5 | 5 | 保持、コアツール |
| old-linter | C | 2 | 2 | 2 | 3 | 2 | 2 | 4 | アーカイブ推奨 |
完全なレポート形式は references/report-template.md を参照してください。
プロジェクトタイプ識別ルール
コア推論ルール(完全なマッピングは references/project-types.yaml を参照):
package.json→ Web/Node/フルスタックCargo.toml→ Rust ·pyproject.toml→ Python ·go.mod→ Gopom.xml/build.gradle→ Java ·.csproj→ C# ·pubspec.yaml→ FlutterCMakeLists.txt→ C/C++ ·Gemfile→ Ruby- 複数の
SKILL.md+MEMORY.md→AI Agent スキル開発
境界ルール(クイックリファレンス)
- トリガー: 独立語トリガー、文中ではトリガーしない
- 階層化: T1/T2/T3 はプロファイルの「コアアクティビティ」を唯一の尺度とする
- スコアリング: 5段階 S/A/B/C/D。強制理由付き、理由なし=未評価
- 深層分析: 全文本文を読む。ギャップはツールで検証する必要あり
- レポート: 内容がある場合のみ出力。空欄はフォールバックしない
- レコメンデーション: 信頼度指数0-10 + ROIを付与。<5 は推奨しない、データによる裏付けが必要
- 実行確認: 操作はユーザーの確認が必要。システムスキルは読み取り専用
- 黄金律: まず検索・検証、≥2 ソース
プラットフォーム設定と CI/CD
対応プラットフォーム:platforms/zcode.yaml · platforms/workbuddy.yaml · platforms/claude.yaml · platforms/codex.yaml · platforms/cursor.yaml · platforms/default.yaml。
CI モード(技能审查 --ci または skills-summarize-audit --ci または skills-audit --ci):非対話、JSON出力、深層読み取りをスキップし、config.yaml の ci.max_tokens 予算に制約されます。ゲートロジック:health=🔴 → exit_code=1 · actions_required>5 → exit_code=2 · t3_ratio>0.35 → exit_code=3。GitHub Actions テンプレートは references/ci-github-actions.yml を参照。
SkillSpector セキュリティスキャン(オプション):config.yaml → security_scan を有効にすると、スキャン結果が Value 次元に組み込まれます(Critical→D, High→C, 合格→+0.5段)。SkillSpector は外部プロセスであり、Agent トークンを消費しません。
ファイル構造
skills-summarize-audit/
├── SKILL.md # スキルメインファイル
├── VERSION # バージョン番号
├── LICENSE # MIT
├── README.md # 概要とインストール
├── config.yaml # 監査設定
├── platforms/ # プラットフォーム適応設定
├── references/ # 参考ドキュメント
│ ├── execution-flow.md # 実行フロー索引
│ ├── flow/ # 各フェーズの詳細手順(19 サブファイル)
│ ├── project-types.yaml # プロジェクトタイプマッピング
│ ├── skill-registry.yaml # スキルレジストリ
│ ├── deep-analysis-template.md
│ ├── description-quality.md
│ ├── report-template.md
│ ├── ci-output-schema.md
│ ├── ci-github-actions.yml
│ └── recommendation-examples.md
├── tests/ # テストスイートと検証スクリプト
├── .data/ # ランタイムデータ(ログ/キャッシュ/統計/プロファイル/外部シグナル)
├── install.ps1 / install.sh # インストールスクリプト
└── CHANGELOG.md # 変更履歴
インストール
ワンクリックインストールと手動インストールの詳細は references/installation.md を参照してください(存在しない場合は README.md を参照)。
インストール後、技能审查 または 技能总结 または skills-summarize-audit と入力するとトリガーされます(skills-audit も引き続きサポート)。
フィードバック
ライセンス
MIT — LICENSE ファイルを参照してください。