Community研究與資料分析github.com

gtbwpkwjnb-alt/skills-summarize-audit-skill

技能審計 — 技能審查·畫像·評分·優化 / 通用代理工具審計員 — 設定檔、評分、優化

skills-summarize-audit-skill 是什麼?

此技能是針對 AI 代理(如 Claude Code、Cursor、Codex)的技能庫與專案進行多維度審計的專業工具。它能自動掃描專案技術棧、映射技能庫能力、執行六項活性檢測,並從適配度、價值、新鮮度、社群、投資報酬率、新穎性、污染度七個維度進行 S/A/B/C/D 評分,每項評分都附帶強制理由。技能支援容量分析,計算代理能承載的技能數量上限(多因子預警),並基於能力互補性提供替代、互補、補充或無關的工具推薦。審計後會產生 30 秒摘要報告、詳細評分表,並可自動備份可編輯技能,提供 `--undo` 回滾功能。此外,它還整合了社群 Feed 搜尋(能力缺口驅動的 GitHub 搜尋)與生態雷達區塊(有問題才顯示),並支援 CI/CD 無互動模式與 JSON 門禁邏輯,適合定期維護技能庫健康度或接手新專案時快速評估環境。

相容平台✓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 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Skills-Summarize-Audit — 技能庫與專案畫像驅動審計(聯動 summarize)

對技能庫或當前專案做多維畫像、七維評分、容量分析與優化推薦,最終輸出可執行的審計報告。

它能幫你:

  • 了解技能庫健康度(🟢/🟡/🔴)和變化趨勢(📈 ↑/↓)
  • 發現殭屍技能和冗餘重疊
  • 計算 Agent 還能裝多少技能(多因子有效容量預警)
  • 獲得可執行的歸檔/安裝/更新操作清單
  • 誤操作後可一鍵回滾(--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週一次),或技能庫較大變更後。可與 總結 聯動:run summarize → 發現技能堆積 → 建議 技能總結
  • 專案審計模式:接手新專案時快速了解技術棧和工具鏈,或專案重構前評估環境健康度
  • 觸發詞翻譯精煉:自動將技能 description 翻譯為中文觸發詞+簡介(或反向),方便跨語言使用者快速了解技能功能

前置條件 / Prerequisites

硬性要求(缺失時自動檢測 + 安裝引導)

  • codegraph — 程式碼結構與符號查詢,技能核心分析引擎。缺失時嘗試自動安裝。
  • git — 版本對比、快照與回滾。缺失時嘗試自動安裝。
  • config.yaml — 本技能目錄下的唯一配置源。缺失時從模板生成。

軟性要求(缺失時自動建立)

  • user-profile.md — 使用者畫像。缺失時自動透過問答引導建立。

能力清單 / Capabilities

skills-summarize-audit 提供以下核心能力(v6.0.0 新增能力矩陣+品質訊號+社群Feed+生態雷達):

  • 專案技術棧畫像與專案類型識別
  • 技能庫全量掃描與增量清單
  • 能力維度矩陣建構(~12 能力維度,v6.0.0)
  • 品質訊號讀取(聯動 summarize 錯誤帳本,v6.0.0)
  • 多因子有效容量分析與容量預警
  • 6 項技能活性檢測
  • 七維 S/A/B/C/D 評分與強制理由
  • T3 活性驗證與誤歸檔風險控制
  • 社群 Feed 搜尋(能力缺口驅動的 GitHub 搜尋,v6.0.0)
  • 基於能力互補性的工具推薦(替代/互補/補充/無關,v6.0.0)
  • 生態雷達區塊(條件輸出,有問題才顯示,v6.0.0)
  • 逐技能深度閱讀與外部來源驗證
  • 外部訊號快取與三層推薦引擎
  • 30 秒摘要報告與趨勢對比
  • 快照備份與 --undo 回滾
  • CI/CD 無互動模式與 JSON 門禁輸出
  • 觸發詞翻譯精煉與描述品質檢查

按執行階段排列的詳細能力表:

階段能力說明
⓪ 配置多平台自適應Codex/Claude/Cursor/Coze 平台自動檢測
① 畫像專案技術棧掃描自動識別 15+ 專案類型(Web/Rust/Python/Go/Java...)
② 清單技能庫全量掃描 + 能力映射掃描 4 個路徑 + capability-dimensions.yaml 映射(v6.0.0)
②-bis容量分析多因子有效容量計算(token + 衝突因子 + 認知容量)
②-ter活性檢測6 項檢查驗證技能是否可用(Agent可達性/MCP/命令/觸發/資料/使用證據)
④ 評分七維評分 + 品質訊號7維評分 + 讀取 summarize 錯誤帳本(v6.0.0)
④-aT3 活性驗證歸檔前核實使用證據/修改時間/觸發記錄,降低誤歸檔率
④-bis深度閱讀S/A 全量深讀、B(畫像相關)全量、B(非相關)精簡
⑤a外部訊號GitHub⭐/npm📥 快取採集
⑤-aa社群 Feed能力缺口驅動的 GitHub 搜尋(v6.0.0)
⑤b能力矩陣推薦引擎基於能力互補性的推薦(替代/互補/補充/無關,v6.0.0)
⑥報告生成 + 生態雷達30 秒摘要 + 容量塊 + 評分表 + 條件生態雷達區塊(v6.0.0)
⑦-a快照備份執行前自動備份所有 editable 技能
⑦-d操作回滾--undo 撤銷任意執行操作,保留 7 天快照
CI無互動審計JSON 輸出 + health/t3/actions 三門禁,整合 GitHub Actions

When NOT to Use / 何時不使用

  • 單次檔案編輯、即時除錯、極簡專案(無技能依賴)、僅需安裝單技能
  • 低資源環境(審計消耗約5K-15K tokens/次)

執行流程

觸發後,先讀取 references/execution-flow.md 獲取完整流程、評分表、容量計算、報告模板與 CI 規則。主檔案僅保留入口與關鍵規則。

⓪前置配置 → ①專案畫像 → ②技能清單+容量採集 → **②-ter活性檢測**
→ ③載入參考資料 → ④分層評分
→ ④-bis深度閱讀 → ⑤外部訊號+推薦 → ⑥生成報告 → ⑥-bis審計驗證 → ⑦執行 → ⑧持久化

關鍵規則

  • 畫像:只掃描當前目錄。從資料來源提取痛點,禁止猜測。結果寫入 {project}/.agents/project-profile.md
  • 分層:T1(命中核心活動)→ 保留;T2(通用)→ 保留;T3(專業)→ 建議歸檔
  • 評分:七維 S/A/B/C/D。每個技能附帶 1 句理由;無理由 = 未評分
  • 容量:計算 Agent 可承載上限。可再裝 ≤1 → 🔴,2-4 → 🟡,≥5 → 🟢
  • 外部訊號:GitHub⭐快取7天,npm📥快取30天。網路不可用時跳過並標註,禁止偽造
  • 推薦:每項附帶信心指數(0-10)+ROI。<7 時明確標註"評估中",<5 需有資料支撐才推薦
  • 執行:只修改使用者層技能(editable=true)。系統技能唯讀。
  • 黃金法則:涉及技能開發/修改/推薦時,先搜尋驗證,引用 ≥2 獨立來源
  • 活性檢測:首次審計全量檢測。後續僅檢測新安裝技能。深度 子命令強制全量。異常時觸發單技能活檢

輸出範例

觸發 技能審查 後,優先輸出 30 秒摘要塊:

🟢 技能庫健康度:良好
🛠️ 關鍵操作:更新 1 個落後技能、歸檔 2 個 T3 技能
💰 預計節省:~3200 tokens/次(減少低價值 skill 注入)

隨後輸出評分表片段(範例):

技能綜合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 以畫像"核心活動"為唯一尺度
  • 評分:五檔 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 Token。


檔案結構

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


License

MIT — see LICENSE file.

相關技能