dsh-tool-reqpipe
DeepSeek Harness 插件：把 [reqpipe](../python-cli/)（研发团队需求流水线管理工具）包装成一组结构化工具，模型可以直接调用工具来创建需求、推进/跳过阶段、查看流水线、生成提交清单。
- 阶段约定：需求 → 方案 → 评审 → 开发，每个需求一个工作目录，固定目录命名与文档格式
- 评审闸门：评审由独立的
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 环境变量覆盖位置。