前言¶
在 DeepSeek Harness（DSH）裏做多模型協作時，常見做法是手動切換 preset、自己寫 prompt 約定「誰規劃、誰寫代碼、誰審查」。步驟一多，規範容易漂移，審查結論也未必和可測驗收標準對齊。社區插件 dsh-plugin-nexus-sdlc（Nexus SDLC / Nexus 規範研發）把「澄清規範 → 規劃 → 實現與測試 → 審查 → 沉澱知識」寫成一套聲明式 agent preset，通過四個靜態委派工具在 Claude Code 與 Codex 之間分工，主會話仍保留 shell、文件系統、搜索、job、/goal 與官方隔離規劃控制器。下面介紹它是什麼、如何安裝，以及使用時需要接受的邊界。
這是什麼¶
dsh-plugin-nexus-sdlc 是面向 DSH 的 spec-driven development 預設包：包名 dsh-plugin-nexus-sdlc，Preset ID 爲 nexus-sdlc，在客戶端裏顯示爲 Nexus 規範研發。維護者爲 Fnckerpoi；源碼與說明見 GitHub 倉庫，社區目錄頁爲 SkillHub 條目。分類爲工作流；當前 npm 版本 1.0.0，許可證 MIT。README 明確說明：這是獨立撰寫的配置組合，不是 DeepSeek 官方產品；也不附帶自定義 Host 代碼或瀏覽器 UI。
與「在對話裏臨時口頭分工」相比，本插件用中文 persona 與固定委派工具把角色邊界寫進 preset，並在 Provider 層爲 Codex / Claude 使用獨立行與權限模式，儘量在不繞過 DSH 審批與沙箱的前提下完成規範研發閉環。
兼容性與前置條件¶
安裝前請對照 README 與 package.json 中的 peerDependencies：
- 當前文檔寫明已在 DSH core 0.2.0-rc.2 上做過檢查；Desktop shell 版本號不等於 DSH core 版本，其他 core 版本未聲明兼容。
- 目標 Profile 需具備官方 filesystem、subprocess、job、command、agent、preset 等服務；Shell 工具面向 macOS/Linux，Windows 未驗證。
- 目標 Profile 中須已安裝兩個官方 provider 包，且本機 Claude Code / Codex 的配置與認證可用：
@deepseek-ai/dsh-subagent-codex@0.2.0-rc.2@deepseek-ai/dsh-subagent-claude-code@0.2.0-rc.2- Node 引擎要求：
>=22.19.0。 - 若環境中有
dsh-taskboard，preset 會給出看板相關指引；本包不安裝看板、不開啓其 auto-sync、也不改其設置。沒有看板時應如實報告缺失，不要虛構任務操作。
peer 依賴在 npm 解析裏標爲 optional，僅爲避免自動再裝一套 harness/runtime；運行本組合仍需要這些能力，DSH 仍會校驗聲明的版本。
核心功能與工作流¶
README 將協作定義爲 prompt 引導的協調，不是自動有限狀態機：沒有實時執行看板，不保證審查者不能寫代碼，不保證外部模型調用一定成功，也不把審查話術當作測試證據。委派僅在用戶授權時發生；所需 provider 不可用時應報告失敗，而不是假裝某角色已執行。
推薦流程如下：
- 澄清 Spec 與可測試的驗收標準。
- 調用
subagent_claude_plan：由 Claude Code 做規劃。 - 調用
subagent_codex_dev：由 Codex 做實現、測試與針對性修復。 - 調用
subagent_claude_review：基於證據的審查；必要時再審查。 - 調用
subagent_claude_distill：僅在審查通過且用戶接受後，沉澱可長期保留的知識。
主會話除上述四個靜態委派工具外，還可使用 shell / 文件系統 / 搜索 / job、/goal、goal 工具及官方隔離 planning controller。/feedback 屬於 Host，本 bundle 不重複提供。
Provider 與安全基線¶
本插件註冊獨立 Provider 行：
| 用途 | Provider 行 ID | 註冊名 | permissionMode |
|---|---|---|---|
| Codex | nexus-sdlc-provider-codex |
nexus-sdlc-codex |
never |
| Claude | nexus-sdlc-provider-claude-code |
nexus-sdlc-claude-code |
plan |
這是在本地 preset 安全基線上的分工，不繞過審批或沙箱；原生限制仍可能阻止實現或沉澱步驟。包內不攜帶個人路徑、網關、模型別名、憑證或 CLI 狀態；唯一顯式環境變量爲 Electron 啓動用的 ELECTRON_RUN_AS_NODE=1（不是憑證）。模型與認證仍由你本機配置或 Profile 覆蓋決定。
需要自定義時，只覆蓋上述獨立 Provider 行的 config.model、config.env 等受支持字段；不要改共享的 codex / claude-code Provider，以免誤傷其他會話權限。插件安裝作用於整個 Profile，建議先在隔離 Profile 驗證。
安裝與啓用¶
將下面命令裏的 desktop 換成你的 Profile 名。若 CLI 不在 PATH，可在 Desktop 中使用插件管理器。先裝缺失的前置插件，再裝本包：
dsh plugin --profile desktop add @deepseek-ai/dsh-subagent-codex@0.2.0-rc.2
dsh plugin --profile desktop add @deepseek-ai/dsh-subagent-claude-code@0.2.0-rc.2
dsh plugin --profile desktop add dsh-plugin-nexus-sdlc
按客戶端要求刷新或重啓後，在新對話中選擇 Nexus 規範研發（nexus-sdlc）。安裝不會改變你的默認 preset。
若本地仍保留舊目錄包 nexus-sdlc-0-1-7-rc-2，可與本公開包並存：新包使用穩定 ID 與獨立 Provider 名，不覆蓋舊版或 PTC；舊會話不會自動遷移，新會話請選新版並在確認後按需卸載舊版。不要同時重複安裝本包的本地副本與 npm 副本。
典型用法說明¶
本插件不提供單獨的可執行 demo 倉庫；「典型用法」即在新會話中選定 preset 後，按工作流步驟推進任務：
- 與用戶一起把需求寫成 Spec 和可驗證的 acceptance criteria。
- 在用戶同意委派後，依次使用四個
subagent_*工具完成規劃、開發、審查與沉澱。 - 實現與審查階段應保留真實測試與命令輸出作爲證據；審查步驟不能替代跑測試。
- 主會話如需拆目標或長程規劃，可配合
/goal與官方 plan mode，與委派步驟並行使用。
維護者在倉庫中提供了 schema 與兼容性相關的自測命令（面向開發者驗證包內容，不是最終用戶的必做步驟）：
npm ci
npm test
# 可選：對照本機已安裝的 DSH schema 做兼容性門控
DSH_APP_DIR="/path/to/dsh/installation" DSH_PROFILE_DIR="/path/to/profile" npm run test:host
npm pack --dry-run
單元測試覆蓋穩定標識、無個人數據、角色綁定、權限默認值、peer 版本邊界與文件範圍；host checker 使用已安裝 schema 做官方兼容性匹配，不發起模型調用、不修改 Profile。完整外部 provider 執行與 GUI 行爲不在 schema 檢查範圍內。細節見倉庫 verification notes。
適用場景與注意事項¶
適合誰： 已在 DSH 0.2.0-rc.2 生態中使用 Claude Code 與 Codex，希望用固定工作流做規範驅動研發、並願意在主會話裏逐步授權委派的開發者。
不適合當作什麼： 不是一鍵全自動 SDLC 平臺；不能替代本機測試與 CI；不能保證每次外部調用成功；SkillHub 等社區目錄與 DeepSeek / 幻方無官方從屬關係，安裝前仍應自行閱讀 源碼 與 MIT 許可證。
權限與安全： 插件以當前 DSH 進程與 Profile 的權限運行；安裝即影響同 Profile 下會話。勿在公開包或倉庫中提交密鑰；若後端需要 env 覆蓋，請在私有 Profile 配置。
結尾¶
dsh-plugin-nexus-sdlc 把 Nexus 規範研發流程收斂爲一個可選的 DSH preset：四個委派工具對應規劃、實現、審查與知識沉澱，Provider 權限與官方 subagent 包對齊，便於在單一中文主會話裏做 spec-driven 協作。選用前確認 core 與兩個 subagent 插件版本，在新對話中選擇 Nexus 規範研發 即可開始。
