dsh-tool-reqpipe
DeepSeek Harness 插件：把 reqpipe（研发团队需求流水线管理工具）包装成一组结构化工具，模型可以直接调用工具来创建需求、推进/跳过阶段、查看流水线、生成提交清单。
- 阶段约定：需求 → 方案 → 评审 → 开发，每个需求一个工作目录，固定目录命名与文档格式
- 评审闸门：评审由独立的
reqpipe_review 完成，评审人须与方案作者不同
（同一 agent 不能自写自评）；reject 打回方案返工，approve 才进入开发
- 身份留痕：
advance / skip 自动记录调用 agent 的会话 id 为操作者
- 跳过 方案/评审 即轻量流程，
reason 必填并留档；方案作者不能跳过自己方案的评审
- 规范值：每个工具返回 CLI 的
--json 输出；渲染层产出模型可见的中文文本
依赖
插件通过子进程调用 reqpipe CLI，必须先安装：
pip install reqpipe
安装
dsh plugin add dsh-tool-reqpipe
（开发/调试也可用 --patch 加载本目录：pnpm dsh web --patch ./cordis.patch.yml。）
注册的工具
| 工具 | 参数 | 说明 |
|---|
reqpipe_init | — | 初始化流水线根目录（通常无需手动调用） |
reqpipe_create | title（必填）, id?, description?, light? | 创建需求，返回清单 |
reqpipe_advance | id（必填）, force? | 推进阶段（需求/方案/开发），自动生成下一阶段模板；评审阶段必须用 reqpipe_review |
reqpipe_review | id, reviewer（必填，≠方案作者）, verdict: approve|reject, comment? | 评审方案：通过进入开发，不通过打回返工；每轮留档 |
reqpipe_skip | id, stage: design|review, reason（必填） | 跳过方案/评审（轻量流程），原因留档；方案作者不能跳过自己的评审 |
reqpipe_list | — | 列出所有流水线 |
reqpipe_show | id | 查看详情（阶段状态、操作者、评审记录、跳过原因、历史） |
reqpipe_checklist | id | 生成提交清单（Markdown） |
评审怎么用：方案（design）完成后，不要用 advance 推进评审阶段（会被拒绝）；
应拉一个独立评审 agent，或请人工评审后由你代为调用 reqpipe_review，其中
reviewer 填评审人身份（其他 agent 的会话 id 或人工姓名），且必须与方案作者不同。
配置
在 profile / 组合包层的 cordis.patch.yml 中按需覆盖：
- id: reqpipe
name: dsh-tool-reqpipe
config:
reqpipeBin: 'reqpipe' # 默认：PATH 中的 reqpipe
root: '/srv/pipelines' # 默认：REQPIPE_ROOT 环境变量 → ./pipelines
| 字段 | 默认 | 说明 |
|---|
root | '' → REQPIPE_ROOT → ./pipelines | 流水线根目录 |
reqpipeBin | 'reqpipe' | reqpipe 可执行文件，可为绝对路径 |
reqpipeArgs | [] | 前置参数，如 ['-m', 'reqpipe']（配合 reqpipeBin: 'python3'） |
env | {} | 附加环境变量 |
开发
pnpm install
pnpm build # tsdown → lib/（自包含，可作 git 安装的 prepare）
pnpm typecheck # tsc --noEmit
pnpm test # vitest（需先有 ../python-cli 下的 reqpipe 源码）
测试通过 python3 -m reqpipe 调用仓库内 ../python-cli 的 CLI 源码，
可用 REQPIPE_SRC 环境变量覆盖位置。
