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

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

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

插件通过子进程调用 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 会话中用自然语言直接指挥即可：

示例对话：

• “创建一个需求：支持导出 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

开发与测试

# 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