Community研究&データ分析github.com

gtbwpkwjnb-alt/skills-summarize-audit-skill

スキル監査 — プロファイル・スコアリング・最適化 / 汎用エージェントツール監査人 — プロファイル、スコア、最適化

skills-summarize-audit-skill とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)がインストールしているスキル群やプロジェクト全体を多次元的に監査・評価・最適化するためのものです。スキルライブラリの健全性(🟢/🟡/🔴)、トレンド(📈 ↑/↓)、デッドスキルや冗長な重複を検出し、エージェントが追加でインストール可能なスキル容量を多因子分析により警告します。さらに、7次元のスコアリング(S/A/B/C/D)と強制的な理由付け、外部ソース(GitHub Stars、npmダウンロード数など)からの品質信号、能力ギャップに基づくコミュニティフィード検索、そして補完的なツールレコメンデーションを提供します。監査結果は30秒のサマリーブロックと詳細なレポートとして出力され、`--undo` によるワンクリックロールバックやCI/CDパイプラインとの統合(JSON出力+ゲートロジック)も可能です。このスキルは、独立したトリガーワード(例:「スキル監査」「プロジェクト監査」「技能总结」)で起動し、同じ製作者の `summarize` スキルと連携してエラーログなどの品質データを活用します。

対応✓Claude Code✓Codex CLI✓Cursor
npx skills add gtbwpkwjnb-alt/skills-summarize-audit-skill

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

お気に入りのAIに質問する

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

ドキュメント

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)
④-aT3 活性検証アーカイブ前に使用証拠/更新日時/トリガーレコードを確認し、誤アーカイブ率を低減
④-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トークン/回(低価値スキルの注入を削減)

続いてスコア表の断片が出力されます(例):

スキル総合FitValueFreshCommunityROINoveltyContamination推奨
codegraphS5544555保持、コアツール
old-linterC2223224アーカイブ推奨

完全なレポート形式は references/report-template.md を参照してください。


プロジェクトタイプ識別ルール

コア推論ルール(完全なマッピングは references/project-types.yaml を参照):

  • package.json → Web/Node/フルスタック
  • Cargo.toml → Rust · pyproject.toml → Python · go.mod → Go
  • pom.xml/build.gradle → Java · .csproj → C# · pubspec.yaml → Flutter
  • CMakeLists.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 も引き続きサポート)。


フィードバック

🐛 GitHub Issues


ライセンス

MIT — LICENSE ファイルを参照してください。

関連スキル