dsh-skill-authoring：DeepSeek Harness 技能開發輔助插件

前言¶

DeepSeek Harness (DSH) 的生態理念強調模塊化，技能是其中的核心資產。在維護技能庫時，開發者常面臨文檔結構不一、質量標準缺失以及命名不規範的問題。dsh-skill-authoring 插件旨在解決這些痛點，通過標準化骨架、質量門禁審計和自動校驗，確保技能庫的整潔與可用。

插件定位¶

這是一個由 boomzikazita 維護的 DSH 插件，用於創建和維護高質量的智能體技能。它不依賴複雜的配置，通過插件機制直接擴展 DSH 的工具集。

核心功能¶

該插件提供以下主要工具與機制：

1. skill_scaffold
   爲新技能生成符合規範的 SKILL.md 骨架，包含 frontmatter、whenToUse、Boundaries、QuickRef 和 Examples 佔位符，並自動創建 references/index.md。

2. skill_audit
   對現有的 SKILL.md 進行審計，對照 9 點質量門禁標準輸出通過/失敗狀態。

3. skill_check_name
   驗證技能名稱是否符合 DSH 規範（正則表達式 ^[a-z0-9]+(-[a-z0-9]+)*$），僅允許小寫字母、數字和連字符。

4. skill-write-guard
   安裝一個寫入鉤子。當使用 write 或 edit 命令修改 ~/.dsh/skills/ 下的 SKILL.md 文件時，系統會自動運行審計，若未通過質量門禁則發出警告。

9 點質量門禁標準¶

插件基於 vibe-coding-cn 標準適配 DSH，具體包含以下九項檢查：

1. name：符合正則且長度 ≤ 64 字符
2. description：包含“什麼+何時”，長度 20–1024 字符
3. whenToUse：包含 ≥ 3 個可執行的觸發條件
4. boundaries：包含 ≥ 3 個“Not For / Boundaries”聲明
5. quickref：包含 1–20 個可直接複用的模式（快速參考）
6. examples：包含 ≥ 3 個端到端示例（包含 Input / Steps / Acceptance）
7. references：references/index.md 文件存在
8. verification：不確定的聲明需標記來源/證據等級
9. style：採用操作手冊風格（短祈使句，非文檔堆砌）

安裝與啓用¶

插件通過 DSH 命令行安裝。安裝後需重啓 DSH 實例以註冊工具。

dsh plugin --profile web add github:boomzikazita/dsh-skill-authoring

安裝完成後，請重啓對應的 dsh web 實例或 profile，以確保新工具生效。

配置與依賴¶

該插件無需額外配置（cordis.patch.yml 中 config: {} 即可）。以下爲運行環境說明：

• 技能目錄：默認爲 ~/.dsh/skills，在運行時動態獲取用戶主目錄，無硬編碼路徑。
• Python 環境：插件依賴 Python 3.8+ 解釋器，用於執行質量門禁引擎（scripts/skill_gate.py）。

典型用法¶

• 生成骨架：使用 skill_scaffold 命令初始化一個新技能。
• 質量檢查：使用 skill_audit 檢查現有技能文檔是否符合 9 點標準。
• 格式校驗：使用 skill_check_name 確認技能名稱格式正確。
• 自動防護：在編輯技能文件時，skill-write-guard 會自動介入審計。

生態與許可¶

該插件遵循 MIT 許可證。社區目錄 skillhub.cn 提供了該插件的索引頁面，但插件本身與 DeepSeek / 幻方無官方從屬關係。

• GitHub 地址：boomzikazita/dsh-skill-authoring
• 社區目錄：dsh-skill-authoring