前言¶
DSH（DeepSeek Harness）的理念是「一切皆插件」。編寫和維護技能是構建智能體的核心工作流。在編寫過程中，frontmatter 規範、技能觸發面、篇幅控制以及行爲驗證是常見痛點。dsh-skill-authoring 插件通過將一套規範技能打包進 DSH 插件體系，解決了技能編寫、審查與驗證的問題。
插件簡介¶
這是一個 DSH 插件。安裝時，它把包內的 skills/ 註冊爲一個技能根。這意味着這份技能會隨插件進入 agent 的技能目錄。
核心能力¶
該插件提供的技能覆蓋以下幾個維度：
-
frontmatter 規範
定義必填 / 可選字段、布爾字段的合法寫法，以及「一個字符寫錯就讓技能靜默消失」的機制。 -
技能根與優先級
說明 rank 100–600 的掃描順序、同名技能怎麼靠項目級根覆蓋用戶級根，以及變更檢測管到哪一層。 -
description 寫觸發面
解釋爲什麼只有它進模型視野，觸發線索該怎麼堆，邊界與兜底怎麼寫。 -
篇幅與拆分
指導將技能控制在 300–500 行的目標區間，明確什麼時候該拆references/，什麼情況不該爲數字硬拆。 -
靜態校驗
提供scripts/check-skill.js腳本，一次檢查 frontmatter、必填字段、文件引用、站內錨點、§N交叉引用和篇幅。腳本可傳技能目錄或技能根目錄，支持--json。 -
行爲驗證
展示如何做帶技能與不帶技能做同一件事的 A/B 對照，對比產物而不是對比自我報告，以及派子 agent 時該寫死的紀律。
安裝與啓用¶
在 DSH 環境中執行以下命令安裝插件。安裝後，包內的 skills/ 目錄會被註冊爲技能根。
dsh plugin --profile web add dsh-skill-authoring
典型用法¶
靜態校驗腳本是零依賴的 Node 腳本，可以脫離 DSH 直接運行。
node skills/dsh-skill-authoring/scripts/check-skill.js <技能目錄>
注意事項¶
- 該插件以當前 DSH 進程的權限運行，安裝前應檢查源碼與許可證。
scripts/package.json中指定了type爲commonjs，用於兼容 module 包環境，確保腳本在包內能正常執行。
