mcpField
R
research-pipeline-runner

research-pipeline-runner

github.com/willoscarAgent 工作流51742 次安装4 周前更新
代码仓库

关于 research-pipeline-runner

Research Pipeline Runner 是一项技能，可将研究目标按选定流程推进，并保留可审计的工作区状态。它面向需要逐单元执行、可恢复运行并依据证据交付的操作人员。

主要功能

  1. 01将目标绑定到一个工作流
  2. 02执行前核对工作区状态
  3. 03逐个执行并验证单元
  4. 04在人工检查点或阻塞条件处停止
  5. 05审计输出并整理运行证据

适用场景

  1. 01根据工作区文件恢复研究运行
  2. 02执行流程单元并保留尝试与制品证据
  3. 03遇到未决决策或质量检查失败时安全暂停
  4. 04审计最终制品并索引运行证据

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/willoscar/research-units-pipeline-skills --skill research-pipeline-runner

安装后在 Claude Code 中输入/research-pipeline-runner确认已加载。

详细介绍

研究流水线运行器

运行器将一个请求的结果转化为可审计的工作区。其首要原则是持续推进：每项操作都必须留下足够持久的状态，以便下一个命令或 Agent 无需从聊天记录中重建运行即可继续。

输入

  • 用户目标，包括目标交付物和约束条件。
  • 现有工作区，或用于创建新工作区的 workspaces/<name>/ 下的路径。
  • 已记录在 PIPELINE.lock.md 中的所选流水线。

输出

  • 包含 GOAL.md、PIPELINE.lock.md、UNITS.csv、 STATUS.md、CHECKPOINTS.md 和 DECISIONS.md 的工作区。
  • 流水线声明的中间产物和目标产物。
  • .harness/ 和 output/ 下的运行证据。

步骤

1. 将目标绑定到一个工作流

读取目标和现有工作区状态。如果不存在有效的流水线锁定文件， 则使用 pipeline-router；仅在该路由分支中加载 docs/PIPELINE_TAXONOMY.md。保留现有的有效锁定文件。

完成标准：PIPELINE.lock.md 恰好指定一个流水线及其单元模板，且 UNITS.csv 符合该约定。

2. 执行前进行核对

运行工作区检查器或等效的 Harness 检查。先解决可恢复的投影问题。将完整性错误转交给明确的修复流程； 保留所有先前的尝试和决策。

完成标准：工作区中要么有一个符合执行条件的下一单元，要么有一个已记录后续操作的具体阻塞条件。

3. 执行一个单元

对于下一个符合执行条件的单元：

  1. 读取其负责人、依赖项、输入、输出、验收规则和技能；
  2. 通过流水线适配器开启尝试；
  3. 遵循该技能的 SKILL.md，并按需加载其上下文指针；
  4. 验证每项必需输出和验收条件；
  5. 通过流水线适配器提交完成状态。

完成标准：该单元以 DONE 状态提交，并有匹配的尝试、清单和产物证据；或者以 BLOCKED 状态提交，并附有可诊断的失败信息。

4. 遵守停止线

停止线是第一个人工检查点、未解决的决策、未通过的质量约定、缺失的必需产物或终止性执行错误。 总结现有内容，指出要检查的证据，并留下一条具体的恢复命令或问题。

完成标准：运行绝不越过停止线，其他操作人员无需聊天记录即可从工作区文件中识别阻塞项。

5. 继续推进至声明的结果

只要存在符合执行条件的单元，就重复核对和单元执行。完成最后一个单元后，运行审计并生成产物包。

完成标准：目标产物已存在，必需的评估均已通过，审计中没有阻塞问题，且产物包已为交付内容和运行证据编制索引。

分支指引

  • **工作流选择：**读取 docs/PIPELINE_TAXONOMY.md，然后读取所选的 pipelines/*.pipeline.md。分类体系负责维护路由目录；此技能不会重复其中的内容。
  • **调查严格模式：**写入前，读取已锁定的调查流水线质量约定和 当前交付配置文件。分支专属标记和门禁定义于其中。
  • **离线检索：**使用所选检索技能中记录的导入路径，并保留来源溯源信息。
  • **手动执行单元：**使用 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。更改单元状态唯一受支持的方式仍是使用流水线适配器。

评论

支持 Markdown