前言¶

在 DeepSeek Harness (DSH) 的工作流中，插件化是核心架構理念。面對模糊的需求或隱含假設，僅靠 Prompt 優化往往難以根治輸出質量不穩定的問題。boomzikazita/dsh-spec-gate 插件借鑑 Ouroboros 的思想，將“訪談門”和“驗收門”引入 DSH 工作流。它的作用是在工作開始前，通過 Socratic 問答收斂需求，鎖定不可變的規格，並在交付前拒絕不符合標準的草稿。

插件定位¶

dsh-spec-gate 是一個 Specification gate 插件。它將模糊的需求轉化爲可驗證的規格，防止交付物偏離目標。該插件由 boomzikazita 維護，屬於“工作流”類別，遵循 MIT 許可證。

核心功能¶

插件提供三個核心能力，分別對應需求澄清、規格鎖定和交付驗收。

1. 歧義訪談評估 (spec_interview_assess)
   對需求文檔進行 8 個維度的歧義評分。這 8 個維度包括受衆、目的、格式、數據、範圍、語氣、驗收標準和截止日期。該步驟會暴露隱藏假設，並返回評分和需要追問的問題。

2. 規格 Seed 構建 (spec_seed_build)
   在訪談收斂後，鎖定不可變的 Seed。Seed 包含目標、維度、驗收標準和約束條件。它被哈希鍵索引，一旦構建即不可覆蓋。

3. 交付前驗收門 (spec_gate_evaluate)
   在交付前對草稿進行機械檢查。它基於 Seed 和驗收標準驗證草稿，確保只有通過檢查的草稿才能被移交。

安裝與啓用¶

安裝需要使用 DSH 的插件命令。

dsh plugin --profile web add github:boomzikazita/dsh-spec-gate

啓用後，需要在配置文件中指定目錄路徑和閾值。

# cordis.patch.yml (或插件的 bundle patch)
- insert:
    - id: spec-gate
      name: 'dsh-spec-gate'
      config:
        seedsDir: '~/.dsh/spec-gate/seeds'
        eventsLog: '~/.dsh/spec-gate/events.jsonl'
        convergeThreshold: 0.2
        hardGate: false

• seedsDir: 存儲鎖定的 Seed 文件。
• eventsLog: 記錄驗收失敗事件，用於後續分析。
• convergeThreshold: 歧義評分的收斂閾值，設爲 0.2 表示分數需低於此值才能通過訪談。
• hardGate: 控制是否在 Seed 存在前阻止寫入/編輯操作（默認爲 false）。

典型用法¶

使用該插件通常遵循“澄清-鎖定-生成-驗證”的流程。

1. 澄清需求：當模糊需求到達時，運行 spec_interview_assess。根據返回的評分和問題，追問直到歧義評分降至 0.2 以下。
2. 鎖定規格：運行 spec_seed_build，此時會生成一個 seed_id，規格被鎖定。
3. 生成交付物：基於鎖定後的 Seed 生成草稿。
4. 驗收驗證：運行 spec_gate_evaluate(draft, seed_id)。只有當檢查通過時，才進行後續的手工移交。

生態協同與注意¶

該插件與 dsh-cybernetics 協同工作。驗收失敗會被寫入事件日誌，並作爲反饋數據喂入控制論反饋迴路，從而持續優化工作流。

由於 DSH 的社區目錄（如 SkillHub）與 DeepSeek 或幻方無官方從屬關係，使用插件前應檢查源碼與許可證。

總結¶

dsh-spec-gate 提供了一套從需求澄清到交付驗收的完整閉環。通過量化歧義、鎖定規格和機械檢查，它降低了交付風險。完整源碼與文檔可訪問其 GitHub 倉庫。