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) |
| ④-a | T3 活性驗證 | 歸檔前核實使用證據/修改時間/觸發記錄,降低誤歸檔率 |
| ④-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 注入)
隨後輸出評分表片段(範例):
| 技能 | 綜合 | 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 以畫像"核心活動"為唯一尺度
- 評分:五檔 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 仍受支援)。
回饋
License
MIT — see LICENSE file.