research-pipeline-runner

用途

Research Pipeline Runner 用于在用户请求调研（survey）、简报（brief）、综述（review）、教程（tutorial）或想法探索（idea exploration）时，端到端运行一个研究工作流。它把一个请求的结果转化为可审计的工作区（Workspace），其核心词是“延续”（continuation）：每个动作都必须留下足够的持久状态，让下一条命令或下一个智能体无需从聊天记录中重建整个运行过程即可继续。

输入与输出

输入包括：用户目标（Goal），含目标交付物与约束；一个已有的工作区，或用于新建工作区的 workspaces/<name>/ 路径；当 PIPELINE.lock.md 中已记录时，所选定的 Pipeline。

输出包括：一个包含 GOAL.md、PIPELINE.lock.md、UNITS.csv、STATUS.md、CHECKPOINTS.md 和 DECISIONS.md 的工作区；Pipeline 声明的中间产物与目标产物（Artifacts）；位于 .harness/ 和 output/ 下的运行证据（Run Evidence）。

主要步骤

将目标绑定到一个工作流：读取目标与现有工作区状态。当不存在有效的 Pipeline 锁时，使用 pipeline-router；仅在该路由分支中加载 docs/PIPELINE_TAXONOMY.md。保留已有的有效锁。完成标准：PIPELINE.lock.md 恰好命名一个 Pipeline 及其 Unit 模板，且 UNITS.csv 属于该契约。
执行前先对账：运行 Workspace Doctor 或等效的 Harness 检查。先解决可恢复的投影问题。将完整性错误路由到显式修复；保留所有先前的尝试（Attempts）与决策（Decisions）。完成标准：工作区要么有一个符合条件的下一个 Unit，要么有一个具体的阻塞条件并记录了下一步动作。
执行一个 Unit：对于下一个符合条件的 Unit，读取其负责人、依赖、输入、输出、验收规则和 Skill；通过 Pipeline 适配器开启 Attempt；遵循该 Skill 的 SKILL.md 并有选择地加载其上下文指针；验证每个必需输出与验收条件；通过 Pipeline 适配器提交完成。完成标准：该 Unit 被提交为 DONE，且 Attempt、Manifest 与 Artifact 证据匹配，或者被标记为 BLOCKED 并带有可诊断的失败。
遵守停止线：停止线是第一个 HUMAN 检查点、未决决策、失败的质量契约、缺失的必需产物或终止性执行错误。总结现有内容，指明要检查的证据，并留下一个具体的恢复命令或问题。完成标准：运行绝不越过停止线，且另一位操作者无需聊天记录即可从工作区文件识别阻塞点。
继续到声明的结果：只要存在符合条件的 Unit，就重复对账与单 Unit 执行。在最后一个 Unit 之后，运行 Audit 与 Artifact Pack 生成。完成标准：目标产物存在，必需的评估通过，Audit 不含阻塞问题，且 Artifact Pack 索引了交付物与运行证据。

分支指针

工作流选择：读取 docs/PIPELINE_TAXONOMY.md，然后读取所选的 pipelines/*.pipeline.md。分类目录由 taxonomy 负责，本 Skill 不重复。

调研严格模式：在写作前读取锁定的 Survey Pipeline 的质量契约与当前交付配置。分支特定的标记与门控位于其中。

离线检索：使用所选检索 Skill 文档化的导入路径，并保留来源出处。

手动 Unit 执行：使用 unit-executor，同时保留相同的完成协议。

操作者命令

正常操作使用结果优先的 CLI：

uv run rh goal create --topic "<topic>" --workflow <workflow> --workspace workspaces/<name> uv run rh run start --workspace workspaces/<name> uv run rh run resume --workspace workspaces/<name> uv run rh run status --workspace workspaces/<name> uv run rh evidence inspect --workspace workspaces/<name> uv run rh improve diagnose --workspace workspaces/<name>

维护者调试、显式批准和手动状态转换使用 scripts/pipeline.py。Pipeline 适配器仍是更改 Unit 状态的唯一受支持路径。

适用场景与限制

适用于需要端到端、可审计、可延续的研究类任务，如调研、简报、综述、教程或想法探索。限制方面：资料未提供具体的收费、价格、平台支持范围或效果保证；运行依赖工作区文件与 Pipeline 契约，遇到停止线时必须停下，不能自动越过人工检查点或未决决策。