research-step

研究步骤

将研究会话建模为一个 beads epic。每个工作单元都是一个类型化子问题，其 metadata.research_step.output 与 assets/schemas.yaml 中的 JSON schema 相匹配。

此技能是一个路由器。检查工作目录和用户请求，选择一个工作流，然后读取 workflows/ 中对应的 .md 文件并遵照执行。不要凭记忆执行工作流——务必先打开文件。

设置

没有硬性前提。如果 mission.md 不存在，brainstorm 工作流会帮助用户起草一份。

安装 bd 和 jq、运行 bd init，以及验证 scripts/summary-check.sh 是否正常工作，均由 init 工作流负责。运行过 init 后，后续工作流会假定环境已准备就绪。

文件

路径	作用
mission.md	输入。研究任务。
.beads/	状态的唯一可信来源。
summary.md	会话的派生视图，由 update-summary 重新生成。Beads 是唯一可信来源；此文件只是供人类和 brainstorm 使用的摘要。Frontmatter 中的 beads_snapshot 记录了生成该文件时的状态。
background_knowledge.txt	可选。通过问题元数据中的 summary_path 引用的长篇背景信息。

工作流

名称	用途	详细说明
brainstorm	默认工作流。以对话方式探索当前状态；起草或完善 mission.md；用户准备开始行动时移交给其他工作流。	workflows/brainstorm.md
init	设置环境：安装 bd/jq、运行 bd init、验证 scripts/summary-check.sh。之后移交给 plan。	workflows/init.md
plan	创建或扩展图。从 mission.md 初始化 epic 和初始任务边界，或在任务关闭后重新规划下游任务。	workflows/plan.md
execute	从头到尾执行一个已就绪的任务。若已关闭任务的类型会解锁新的结构，则移交给 plan；否则移交给 update-summary。	workflows/execute.md
update-summary	根据 beads 重新生成 summary.md。此操作具有幂等性——当 scripts/summary-check.sh 报告 status: fresh 时不执行任何操作。	workflows/update-summary.md

任务类型 schema 位于 assets/schemas.yaml。

路由

1. 遵循明确请求

如果用户指定了工作流（例如“初始化研究”“刷新摘要”“运行下一步”“执行任务 bd-xyz”），则转交给该工作流。

2. 否则 → brainstorm

如果用户没有指定工作流，则运行 brainstorm。它会检查工作目录、回答用户的问题，并在适当时起草或完善 mission.md；当用户准备开始行动时，再移交给 init / plan / execute / update-summary。

3. 串联

• init → 之后始终运行 plan（然后再串联到 update-summary）。
• plan → 之后始终运行 update-summary，使摘要反映新的图。
• execute → 如果已关闭任务的类型是 literature_review、hypothesis、analysis 或 synthesis，则串联到 plan（再串联到 update-summary）；否则直接串联到 update-summary。
• update-summary 和 brainstorm → 不串联。

边界

此技能不验证输出质量，也不缓存结果。只有经用户确认后，brainstorm 才会写入 mission.md。bd init 由 init 运行。每个工作流的 .md 文件都会说明其自身范围。