前言¶
在 DSH 中做智能體開發或多步工程任務時，常見的問題是步驟不夠受控：需求還沒確認就開始改代碼，計劃沒有批准就進入實現，實現完成前也沒有統一的測試與驗證路徑。
DSH 的插件生態強調「一切皆插件」，社區目錄是獨立站點，不應理解爲 DeepSeek 或幻方官方應用商店。dsh-engineering-workflow 是這個生態裏的一個工作流插件：它爲 DSH 增加一個「工程工作流」預設，把工程任務拆成五個有門檻的階段，並附帶一組 workflow skills 來承載這些流程。
插件定位¶
dsh-engineering-workflow 由 82c86b8z86-stack 維護，許可證爲 MIT。
它是一個面向 DSH 的工程工作流層，安裝後會爲 DSH 增加一個 工程工作流 (Engineering Workflow) agent preset。該預設包含五個 hard-gated phases：
- requirements clarification
- plan approval
- TDD implementation
- parallel subagent execution
- verified finishing
插件還包含六個 workflow skills：
workflow-requirements
workflow-planning
workflow-tdd
workflow-subagents
workflow-verification
engineering-workflow
它會與 DSH 的既有機制配合，包括 plan mode 與 exit_plan_mode、background subagent / subagent_fork、workflow orchestration、goals，以及 preset / skill 系統。
核心功能¶
增加工程工作流預設¶
安裝並同步後，DSH 的新建會話預設選擇器中會出現 工程工作流。選擇該預設後，對應的 workflow skills 會隨預設一起加載。
提供五階段流程¶
插件把工程任務組織爲五個階段：
- 需求澄清：
workflow-requirements - 計劃批准：
workflow-planning - TDD 實現：
workflow-tdd - 並行子代理執行：
workflow-subagents - 驗證收尾：
workflow-verification
engineering-workflow 作爲主 skill，用於在 non-trivial 任務中把任務路由到對應階段，並維持整套流程紀律。
同步預設文件¶
插件會把預設同步到：
~/.dsh/.agent-presets/engineering-workflow
同步發生在 DSH 重啓後，也可以通過同步腳本手動執行。
提供安裝檢查腳本¶
插件提供以下腳本：
node scripts/verify-install.mjs
node scripts/sync-presets.mjs
node scripts/validate-preset.mjs
其中：
verify-install.mjs用於比較 bundled preset 與~/.dsh/.agent-presets中的內容，不進行寫入。sync-presets.mjs用於在不重啓 DSH 的手動或開發場景中同步預設。validate-preset.mjs用於校驗 bundled preset 的結構。
安裝與啓用¶
環境要求¶
運行時需要滿足 Node engine 要求：
^22.19.0 || >=24.0.0
插件還有一個可選 peer dependency：
@deepseek-ai/dsh-system-prompt ^0.1.0-rc.6
安裝命令¶
使用 DSH 插件命令安裝到指定 profile：
dsh plugin --profile <name> add github:82c86b8z86-stack/dsh-engineering-workflow
這條命令會把 dsh-engineering-workflow 加入你指定的 DSH profile。
啓用預設¶
安裝後，重啓一次 DSH，讓 host plugin 掛載並同步預設：
# 在插件包目錄中手動同步
node scripts/sync-presets.mjs
手動同步適用於不重啓 DSH 的場景。同步後，新建會話的 preset picker 中會出現 工程工作流，可以選擇它創建新會話。
如果只想檢查安裝狀態，可以運行：
node scripts/verify-install.mjs
它會將 bundled preset 與 ~/.dsh/.agent-presets 中的內容進行比較，不寫入文件。
如果只想校驗預設結構，可以運行：
node scripts/validate-preset.mjs
典型用法¶
下面是一個基礎使用路徑。
1、安裝插件¶
dsh plugin --profile <name> add github:82c86b8z86-stack/dsh-engineering-workflow
這一步把插件加入指定 profile。
2、重啓 DSH 或手動同步預設¶
重啓 DSH 後，插件會掛載並同步預設到：
~/.dsh/.agent-presets/engineering-workflow
如果不想重啓 DSH，也可以在插件包目錄中運行：
node scripts/sync-presets.mjs
3、創建新會話並選擇預設¶
在 DSH 的新建會話 preset picker 中選擇：
工程工作流
選擇該預設後，會話會加載對應的工程工作流預設和六個 workflow skills。
4、按階段推進任務¶
在具體任務中，可以按照五個階段推進：
- 使用
workflow-requirements澄清需求。 - 使用
workflow-planning形成並批准計劃。 - 使用
workflow-tdd進入 TDD 實現。 - 使用
workflow-subagents組織並行子代理執行。 - 使用
workflow-verification做驗證和收尾。
engineering-workflow 負責把這些階段串起來，避免任務在階段之間隨意跳轉。
適用場景與注意¶
適合誰用¶
適合在 DSH 中做以下工作的開發者：
- 需要更明確的需求澄清流程。
- 希望先批准計劃，再進入實現。
- 希望在實現階段使用 TDD。
- 需要在任務中拆分子代理並行執行。
- 希望在完成聲明前先做驗證。
如果你只是希望普通問答或單步執行，這個插件會增加額外的流程約束。
不影響現有會話¶
插件不會切換已有會話，也不會改變默認預設。它主要影響新建會話中選擇的 工程工作流 預設。
系統提示出現時機¶
workflow guidance 的系統提示會在 host plugin 掛載後創建的新會話中出現。也就是說，通常要在安裝後第一次 DSH 重啓之後，新建會話纔會看到完整效果。
權限與安全注意¶
該插件會作爲 DSH 的一部分運行，使用當前 DSH 進程擁有的文件系統、shell、網絡等權限。安裝前應檢查源碼、腳本、預設文件和許可證，確認其行爲符合你的安全要求。
許可證與來源¶
插件許可證爲 MIT。它的預設組合改編自 DeepSeek Harness 內置 cordis preset，工作流方法改編自 obra/superpowers，host-plugin 同步模式參考 @linxin666/dsh-liangshen。
相關鏈接¶
- 社區目錄：
https://www.skillhub.cn/plugins/82c86b8z86-stack/dsh-engineering-workflow - GitHub：
https://github.com/82c86b8z86-stack/dsh-engineering-workflow
經過上面的步驟，你可以在 DSH 中安裝、同步並啓用 dsh-engineering-workflow，讓新建會話使用一套更明確的五階段工程工作流。
