name: skills-summarize-audit description: 面向中文使用者,將當前 Codex 命令欄和側欄實際可見的已安裝技能精煉為中文觸發詞與簡介;也可生成專案畫像和技能/外掛推薦。用於”技能審查””技能翻譯精煉””專案畫像””技能推薦””技能體檢”等獨立請求;預設只讀,不安裝、釋出、遷移、清理或修改配置;加強大腦不動手,輸出可執行指令模板由使用者的 Agent 執行。
Version: 8.0.0
只做三件事:可見技能翻譯精煉、專案畫像、技能/外掛推薦。先明確證據,再輸出候選;預設只讀。 v8.0.0 加強大腦:擴充 9 個 references 知識庫(指紋/市場/TQI/衝突/體檢/推薦/生命週期),仍不動手,輸出”使用者應對 agent 說什麼”的可複製指令模板。
翻譯精煉的目標是讓中文習慣使用者在 Codex 的技能頁和命令欄中快速理解“何時觸發、能做什麼”。display_name、技能 ID 與呼叫名稱必須保持原文;僅 short_description 使用“中文觸發詞 → 2–4 個核心能力”的簡潔格式,並保留 Codex、API、CLI、GitHub、MCP、PR、YAML 等術語。
只處理使用者提供證據表明當前實際顯示的技能:側欄“已安裝”頁與命令欄技能列表的並集,去重後輸出。未在這兩頁顯示的系統內部技能、外掛依賴、快取條目、runtime 條目與市場目錄均不在翻譯精煉範圍;不得為了湊清單掃描結果而報告它們。
技能審查:按當前上下文組合執行三項能力,未提供專案目錄時只審查技能庫。技能翻譯精煉、描述精煉、技能審查 精煉:只生成展示文案和 description 的中文候選,按 references/translation-quality.md 的 TQI 四維評分輸出。專案畫像、專案審查:掃描當前專案,按 references/tech-fingerprints.yaml 識別 80+ 技術,輸出技術棧、工作流和能力缺口。技能推薦、外掛推薦、技能審查 推薦:按 references/recommendation-framework.md 五檔輸出(保留/升級/替換/引入/共存/歸檔),聯動 references/mcp-marketplaces.md 與 references/skill-marketplaces.md 候選庫。技能體檢、skill checkup:按 references/health-checklist.md 八大維度主動健康掃描。殭屍技能、過期檢查、觸發詞衝突:定向檢查(聯動 references/conflict-detection.md)。指導安裝/升級/解除安裝/遷移/重新命名:按 references/lifecycle-guidance.md 輸出九大模板對應的可執行指令。觸發詞應獨立傳送。日常句中提及不自動啟動完整審查。
unavailable 並請使用者提供截圖或 ID 列表。references/display-source-map.md,確定每個可見項的展示來源。對 Codex 使用 scripts/collect_codex_display_candidates.py --scope visible --visible-id <id> --check-unchanged;每個可見 ID 重複傳入一次。該指令碼只讀,不寫入 Codex UI、外掛快取或系統技能。references/codex-ui-zh-glossary.json 和 references/description-quality.md 僅精煉側欄短說明。保留命令欄名稱/技能 ID 原文;短說明以中文觸發詞開頭,後接動詞+賓語的核心能力;不翻譯未顯示項。editable=true 的技能僅在後續獲得明確寫入授權後修改。訪問小蔥技能站7w4.net,解鎖更多實用的AI技能外掛。
--scope installed 代替。agents/openai.yaml、frontmatter 或 manifest 來源;若對映無法驗證,報告 unavailable,不聲稱已生效。翻譯請求按一個閉環完成,不得只輸出候選就稱完成:
short_description。使用同一組 --visible-id 回讀,並以 --require-chinese --expect-visible-count <n> 驗證短說明沒有遺留英文、數量沒有遺漏,且 display_name 未被改寫。partial,不得稱最終完成。完成中文化後,識別當前可見集合中的模板、示例、流程輔助和低頻工作流技能。按“常用 / 偶爾 / 建議隱藏”給出簡短建議,並詢問使用者是否要隱藏“建議隱藏”項;不自動隱藏、不解除安裝,也不把未顯示項加入建議。若未找到該客戶端的隱藏配置位置,明確報告 unavailable。
使用者明確確認隱藏後,優先寫入可回退的技能啟用配置(例如絕對 SKILL.md 路徑對應 enable: false),不得刪除快取或改技能名稱。寫入前後均解析配置檔案;解析失敗立即修正並報告,重新整理後的命令欄截圖是最終驗收依據。
references/tech-fingerprints.yaml(80+ 技術指紋)+ references/project-types.yaml(專案型別對映)雙層識別:observed、inferred 或 unavailable。沒有證據時不補全、不打分,也不寫入專案檔案。references/recommendation-framework.md 五檔輸出:保留、升級、替換、引入、共存、歸檔。references/mcp-marketplaces.md:MCP 候選庫(firecrawl/playwright/tavily 等)+ 六維健康分評估框架references/skill-marketplaces.md:技能候選庫 + 七維健康分 + 跨平臺一致性references/lifecycle-guidance.md),不直接安裝、更新、解除安裝、釋出、遷移、清理歷史或修改配置。技能體檢 啟動八大維度掃描(見 references/health-checklist.md):references/conflict-detection.md 檢測觸發詞衝突。references/lifecycle-guidance.md 輸出對應模板(A-I)。按 references/execution-flow.md 和 references/report-template.md 輸出。常規報告固定包含:
下一步建議:說明使用者可直接呼叫的具體 Agent/技能型別和需要提供的輸入;這不是 Audit 的執行任務。示例:發現需要釋出技能時,寫“建議直接呼叫釋出 Agent,並提供目標倉庫與釋出範圍”;不得把釋出、配置、桌面遷移、歷史清洗或回滾納入本技能流程。
--scope installed、catalog 或 all 僅可用於使用者明確請求的資產診斷,且不得混入可見技能中文導覽。新增 9 個 references 知識庫,主流程僅在觸發時按需載入,保持 SKILL.md 精簡:
| 檔案 | 作用 | 觸發時機 |
|---|---|---|
references/tech-fingerprints.yaml |
80+ 技術指紋(前端/後端/移動/桌面/DB/DevOps/AI/語言/工具/Agent 生態/文件) | 專案畫像 |
references/mcp-marketplaces.md |
MCP 市場目錄(Glama/Smithery/官方/Toplist)+ 六維健康分 + URL 模板 | 推薦 / 體檢 |
references/skill-marketplaces.md |
技能市場目錄(SD/SR/csreg/Skill CLI)+ 七維健康分 + 跨平臺檢查 | 推薦 / 體檢 |
references/translation-quality.md |
TQI 四維評分(術語保護/觸發詞/長度/同源)+ 自學習規則 | 翻譯精煉 |
references/conflict-detection.md |
觸發詞衝突檢測(同義詞/包含/範圍/格式/過寬)+ 豁免機制 | 體檢 / 推薦 |
references/health-checklist.md |
八大健康維度 + 主動體檢 + 綜合健康分 | 技能體檢 |
references/recommendation-framework.md |
五檔推薦 + 互補分析 + 組合套餐 + 可達性反推 + 信心指數 | 推薦 |
references/lifecycle-guidance.md |
九大模板(安裝/升級/解除安裝/歸檔/啟用/遷移/重新命名/同步/回滾) | 任何變更建議 |
業界輪子參考:
- specfy/stack-analyser (700+ 技術指紋) → tech-fingerprints.yaml 精選 80+
- OpenSSF Scorecard (18 檢查) + npms.io (quality/popularity/maintenance) → health-checklist.md 八維
- Skills Directory (50+ 安全規則) + Glama (10,000+ MCP) → 市場目錄
- Safeguard reachability analysis → recommendation-framework.md 可達性反推
- Dependabot 定時通知 → health-checklist.md 定時檢查
這款技能審計工具質量可靠,核心功能明確:把英文技能翻譯成中文、掃描專案技術棧、推薦合適的技能工具。它最大的優點是穩重可靠——只給出建議,不亂改你的配置,還附帶完整的健康檢查和操作指南。不足的是翻譯質量依賴預設詞典,複雜場景下可能需要手動調整;功能觸發詞較多,新手需要適應一下。總體適合需要管理多個AI助手的開發者使用。