前言¶
在 DSH 的「一切皆插件」模式下，項目裏可能已經安裝了多個技能和插件。常見的問題是：它們是否能用、是否與當前用戶畫像和項目匹配、彼此是否衝突或重複、說明是否需要精煉。
下面介紹 skills-summarize-audit-skill。它是一個用於審查已安裝技能與插件的 DSH 技能包插件，默認只讀，不負責安裝、更新、發佈、配置、遷移或歷史清理。
這是什麼¶
skills-summarize-audit-skill 由 gtbwpkwjnb-alt 維護，許可證爲 MIT。
它覆蓋以下能力：
- 已安裝技能/插件問題審查
- 版本/可用性覈驗
- 用戶畫像定位與評分
- 衝突與互補分析
- 技能說明翻譯精煉
- 項目畫像
- 技能/插件推薦
核心功能¶
問題審查¶
對已安裝技能與插件進行問題檢查，輸出證據、嚴重度、版本、可用性和處理方案。
畫像定位與評分¶
基於用戶畫像、結構化使用證據和技能元數據，給出畫像命中詞、健康維度、評分和證據狀態。
衝突與互補¶
分析技能/插件之間是否存在衝突、互補或無關關係，並給出重疊度和理由。
翻譯精煉¶
生成保留英文名稱的中文 short_description 候選，並附帶質量和來源門禁。
項目畫像與推薦¶
針對當前或指定項目目錄生成事實畫像，並基於翻譯清單、項目畫像或明確缺口輸出建議。
安裝與啓用¶
先通過 DSH 插件系統從 GitHub 添加該插件：
dsh plugin --profile web add github:gtbwpkwjnb-alt/skills-summarize-audit-skill
這條命令用於安裝 GitHub 倉庫中的 DSH 技能包插件。安裝後重啓 dsh web。
啓用後，技能會出現在 Settings → Plugins，並按需懶加載（漸進式披露）。
典型用法¶
以下觸發詞來自已覈實用法示例：
- 發送
技能審查：審查已安裝技能/插件問題、版本、畫像匹配、評分、衝突/互補，並按請求組合翻譯、畫像和推薦。 - 發送
技能問題審查/插件問題審查：運行本地只讀問題檢測，輸出證據、嚴重度和處理方案。 - 發送
技能翻譯精煉或技能審查 精煉：只生成翻譯候選。 - 發送
項目畫像：只生成當前項目的事實畫像。 - 發送
技能推薦或插件推薦：只輸出建議。
邊界¶
安裝前建議先確認這些邊界：
- 默認只讀，不負責安裝、更新、發佈、配置、遷移或歷史清理。
- 不寫入 Codex UI、插件緩存、系統技能、配置或項目文件。
- 外部搜索需要用戶明確同意；無證據時輸出
unavailable。 - 插件外殼無 npm 依賴，只讀 skill provider，無工具、無憑據、無網絡請求。
環境依賴¶
scripts/analyze_project_profile.py需要PyYAML。缺失時以退出碼2輸出unavailable降級信息，相關測試與validate的項目畫像門禁自動跳過。scripts/collect_codex_display_candidates.py與scripts/audit_skill_plugin_issues.py要求Python ≥ 3.11。PyYAML對collect腳本爲可選依賴，缺失時自動降級。
適用場景與注意¶
適合已經使用 DSH、需要檢查已安裝技能/插件狀態、整理技能說明或評估項目匹配度的人。
安裝前建議先檢查源碼、腳本和 MIT 許可證。插件會隨當前 DSH 環境運行，其可訪問範圍受當前 dsh 進程權限影響，因此應按實際運行環境評估風險。
兼容性方面，已覈實資料確認測試兼容版本爲 dsh v0.1.1-rc.2（2026-08-22）。截至 2026-09-05，資料未確認當前 DSH 版本的兼容性；若遇到接口變化，以 DSH 官方文檔爲準。
參考¶
- GitHub：https://github.com/gtbwpkwjnb-alt/skills-summarize-audit-skill
- 目錄頁：當前已覈實材料未提供穩定鏈接。
