规范门禁boomzikazita/dsh-spec-gate

dsh-spec-gate

用于 DeepSeek Harness（dsh）的规范门禁插件。在开始工作之前，将模糊的需求转化为锁定的、可验证的规范——并拒绝交付不符合规范的成果。

借鉴了 Ouroboros 的两个理念，并针对内容生产（写作 / 分析 / 报告）进行了改编：

- 访谈门禁：模糊请求 → 苏格拉底式提问以揭示隐藏假设 → 歧义评分（在继续之前收敛至 ≤ 0.2）
- 验收门禁：交付之前，根据锁定的 Seed（关键词覆盖、硬性约束、字数）对草稿进行机械式检查 + 为智能体提供语义对齐提示

与 dsh-cybernetics 配合使用：验收失败会写入事件日志，并馈入控制论反馈回路。

工具

| 工具 | 用途 |
|------|---------|
| spec_interview_assess | 歧义评分：将 8 个维度（受众 / 目的 / 格式 / 数据 / 范围 / 语气 / 验收 / 截止时间）判定为清晰 / 假设 / 缺失；返回评分 + 要提出的问题 |
| spec_seed_build | 在访谈收敛后锁定一个不可变的 Seed（目标 / 维度 / 验收标准 / 约束）；以哈希为键，永不覆盖 |
| spec_gate_evaluate | 交付前验收：根据 Seed 进行机械式检查 + AC 覆盖提示；失败即关闭 |

安装

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

配置

cordis.patch.yml (or the plugin's own 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  # block write/edit before a Seed exists (default off)

使用流程

1. 收到模糊请求 → 运行 spec_interview_assess → 澄清缺失的维度，直到评分 ≤ 0.2
2. 锁定规范：spec_seed_build → 返回 seed_id
3. 产出交付物
4. 验证：spec_gate_evaluate(draft, seed_id) → 仅在通过时交付

许可证

MIT