前言¶
在 DeepSeek Harness (DSH) 的開發場景中，讓模型遵循嚴謹的工程方法論（如測試先行、故障隔離、代碼審查）通常需要複雜的提示詞拼接。dsh-praxis 旨在解決這個問題，它將資深工程師的工作流硬化爲標準技能庫，通過插件形式集成到 DSH 中，使模型能夠自動進入結構化的工程流程。
插件定位¶
dsh-praxis 是一個工程方法論技能庫插件，作者爲 JohnXu22786。它解決了模型缺乏結構化工程流程的問題，將設計對話、編寫計劃、測試先行、系統調試等行爲硬化爲一套可自動觸發的技能。
核心能力¶
插件內置 14 種技能，覆蓋軟件開發的各個階段。這些技能遵循 Agent Skills 標準，兼容 DSH 的本地技能發現器。
- method-compass：任務啓動時，理解技能庫並選擇首個技能。
- design-conversation：需求模糊或設計未定時，先進行對話確認。
- implementation-blueprint：設計確定後，編寫可執行的步驟計劃。
- blueprint-execution：按計劃執行，設置檢查點驗證，彙報偏差。
- test-first-cycle：編寫代碼時，按紅-綠-重構流程進行測試。
- fault-isolation：遇到異常時，基於證據排查根因，而非猜測。
- completion-proof：在聲稱完成前，提供可觀測的證據。
- task-splitting：並行任務拆分，按契約、派發、集成組織。
- delegated-build：將計劃交給子代理，設置兩輪審查把關。
- review-preflight：請求代碼審查前，進行自檢和自測。
- feedback-assimilation：收到反饋後，消化、修復並逐項回應。
- lane-isolation：並行開發時，確保分支擁有獨立工作區。
- branch-conclusion：分支合併到主幹前的完整收尾流程。
- skill-authoring：編寫、修改或驗證新技能。
安裝與啓用¶
安裝後無需手動配置，模型遇到觸發場景時自動加載技能。插件也支持零代碼集成。
標準插件安裝¶
dsh plugin --profile demo add github:JohnXu22786/skill-framework
零代碼集成¶
插件倉庫中的 skills/ 目錄本身就是一套標準的 Agent Skills 集合，可直接複製到 DSH 的本地技能根目錄：
cp -r skills/* ~/.dsh/skills/
此路徑由 DSH 內置的 dsh-skill-filesystem 發現器加載，無需安裝此插件。
配置與使用¶
配置項¶
插件支持通過配置文件設置技能目錄。在 cordis.patch.yml 中可配置：
- providerName：技能提供者名稱，默認爲 praxis-bundled。
- skillsDir：技能根目錄，默認爲包根目錄下的 skills，支持數組格式。
使用示例¶
對話中可以直接指定技能組合。例如：
先給實施計劃，再執行。
在調試時優先使用故障隔離流程，完成前提供證據。
技能之間通過依賴聲明相互觸發，例如 fault-isolation 會依賴 method-compass 和 blueprint-execution。
環境要求¶
- DeepSeek Harness
dsh版本需 ≥ 0.1.0-rc.6（標準配置已掛載dsh-skill和dsh-tool-skill）。 - Node.js 版本需 ≥ 22。
- 需要安裝
dsh-skill和dsh-tool-skill。
結語¶
dsh-praxis 通過標準化的技能庫，將資深工程師的工作流自動化。它適用於需要嚴謹工程規範的 DSH 場景，能夠顯著提升模型在代碼生成、調試和協作環節的規範性。更多詳情可查看插件目錄或 GitHub 倉庫。
