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

开发

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 环境变量覆盖位置。