需求流水线sikwoxy/dsh-tool-reqpipe

reqpipe —— 研发需求流水线管理工具（DeepSeek Harness 插件）

为研发团队把每个需求拆成 4 个阶段（需求 → 方案 → 评审 → 开发），
每个需求一个工作目录，阶段产物有约定的目录命名与文档格式；
支持跳过 方案/评审 的轻量流程（跳过必须记录原因）。
评审必须由方案作者以外的身份完成（另一个 agent 或人工），reject 打回返工。

本仓库包含两个可分发包：

| 目录 | 包 | 平台 | 安装 |
| --- | --- | --- | --- |
| plugin/ | dsh-tool-reqpipe | npm（DeepSeek Harness 插件） | dsh plugin add dsh-tool-reqpipe |
| python-cli/ | reqpipe | PyPI（命令行工具） | pip install reqpipe |

插件通过子进程调用 reqpipe CLI，因此两个包都需要安装。

安装

1. 安装 Python CLI（插件运行时依赖）
pip install reqpipe

2. 安装 Harness 插件（在 deepseek-harness 环境内）
dsh plugin add dsh-tool-reqpipe

已安装 DeepSeek Harness 的用户可直接 dsh plugin add dsh-tool-reqpipe；
插件与 CLI 的版本建议保持一致。

使用

插件注册 7 个工具，在 Web UI / CLI 会话中用自然语言直接指挥即可：

| 工具 | 参数 | 说明 |
| --- | --- | --- |
| 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） |

示例对话：

- “创建一个需求：支持导出 CSV，轻量流程”
- “推进 REQ-001”（需求 → 方案）
- “拉一个独立 agent 评审 REQ-001 的方案，通过”（reqpipe_review，评审人 ≠ 方案作者）
- “评审不通过，打回返工”（reqpipe_review verdict=reject）
- “跳过 REQ-002 的方案阶段，理由是改动太小”
- “给 REQ-003 生成一份提交清单”

也可以直接用 CLI（详见 python-cli/README.md）：

reqpipe create "登录模块支持记住我" --light
reqpipe advance REQ-001 --by alice
reqpipe review REQ-001 --by bob --verdict approve --comment "方案可行"
reqpipe skip REQ-001 design --reason "交互简单，无需方案文档"
reqpipe list
reqpipe checklist REQ-001 -o COMMIT_CHECKLIST.md

插件配置

在 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 | {} | 附加环境变量 |

开发与测试

Python CLI（python-cli/）
cd python-cli && python3 -m unittest discover -s tests

插件（plugin/）
cd plugin && pnpm install && pnpm build && pnpm test && pnpm typecheck

发布

- npm：cd plugin && pnpm publish（lib/ 为预构建产物，安装无需构建授权）
- PyPI：cd python-cli && python -m build && twine upload dist/
- 推荐用 GitHub Actions（见 .github/workflows/publish.yml）：打 v tag 自动构建、测试并发布两个包（含 npm provenance 与 PyPI 可信发布）

许可证

MIT