用途:协调多阶段研究项目,避免把关键科学决策变成静默自动化。它从 .research/workflow_state.yml 恢复,自动执行安全操作,仅在下一步跨越既定门禁时请求一次结构化决策。这是协调技能,不是研究引擎,路由到 research-hub 既有技能与可用 CLI/MCP 集成。首次运行前读 references/workflow-contract.md;工具适配仅按当前阶段读 references/tool-adapters.md;状态契约见 references/workflow-state.schema.json。
适用与不适用:适合用户要求运行、恢复、自动化或监督跨至少三个阶段(选题界定、发现、综合、设计、实验、写作、发布)且需持久人工审计轨迹的项目。单一孤立操作应改用 literature-triage-matrix、research-design-helper、paper-summarize 或 research-project-orienter。
自动化策略:只读发现/校验/比较、带预览或回滚的本地确定性生成、已批准范围内的本地可逆元数据更新可自动执行并保留溯源;外部写入、高成本或长时实验/仿真、语义性稿件/ rebuttal 修改、提交/发布/合并/破坏性清理分别在 external_write、experiment_authorization、semantic_revision、release_authorization 门禁停止。未知风险一律门禁,工具可用性不降低门禁等级。
运行循环:加载并校验状态字段;缺失则按 schema 初始化,不得虚构已完成决策或产物。用 research-project-orienter 定向,或用 research-context-compressor 生成预览本地清单;冻结研究问题或范围仍需 scope_commitment。规划最小下一步,列明输入、预期产物、工具适配器、校验、风险类别与门禁,然后执行或等待。记录阶段、操作、哈希/溯源、校验结果与决策,原子写入状态,校验通过前不得记成功。仅在契约退出条件通过时推进,否则在声明上限内重试或停止并给出具体阻塞。从记录的 pending_action 恢复,不因新会话重跑高成本或外部操作。
人工决策包:含 Gate、Decision、Why now、Proposed action、Preview、Reversible、Options(accept/decline/revise/cancel)。accept 仅经签名策略检查点或本地 TTY 精确哈希确认有效,代理或 MCP 调用者的裸标签不构成人工授权;批准仅限所述动作与范围。decline 记录并可改选安全替代,不重复追问;revise 需替换动作新哈希;cancel 干净停止。
阶段路由与证据:orient(项目清单与开放问题)、scope(接受的问题/标准/约束)、discover(覆盖度与结果、去重候选、未决范围)、synthesize(版本/来源级声明-证据图、已评估/总数、矛盾与未评估缺口)、design(设计档案与显式假设)、execute(可复现命令、输出、校验)、write(来源链接草稿与评审发现)、release(发布清单与人工授权)。不得从元数据合成声明,不得把 NotebookLM 简报当真相,不得虚构来源、结果、批准或工具输出。
状态与溯源:状态路径 .research/workflow_state.yml,存产物路径加 SHA-256、阶段、时间戳,不存内容;存操作 ID、精确范围、参数/预览哈希、资源上限与决策摘要,不存私密推理或凭据;每次尝试与校验结果写入 actions[];禁止写入密钥、cookie、token。字节、依赖或时效输入变化时只重跑最小受影响校验。
失败行为:每操作默认最多两次重试;重复失败设 blocked,保留最后已验证产物并报告恢复条件;不得静默换数据源、模型、研究问题或纳入标准;MCP 不可用不等于可做更广浏览器或 shell 变更。
完成输出:返回当前阶段与状态、已完成阶段与已验证产物、人工决策及范围、未决证据缺口或阻塞、确切下一步(完成时为无)。仅当 release 退出条件通过或用户明确结束才算完成,草稿不算完成。
运行时:CLI 为 research-hub workflow init|status|validate|decide|resume|migrate,MCP 为 workflow_initialize、workflow_status、workflow_validate、workflow_decide、workflow_resume、workflow_migrate,均支持 --json。migrate 默认演练,加 --apply 才创建备份并原子替换;schema 1.0 可读,但决策与恢复需迁移至 1.1。可选 agent-collab-harness v0.4 策略/检查点在运行时发现;未配置策略时保持独立行为,配置但包、策略或检查点不可用时恢复失败关闭;research-hub doctor --json 报告该集成为 available、unavailable 或 misconfigured。