前言¶

在 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 仓库。