ysaa1/harness-workflow/research

Single-shot Research

一次调研一个问题：后台跑腿、一手来源、产物落盘。不跑轮次循环、不做假设对抗——那是 autoresearch 的活。

流程

1. 把用户需求定成一句可交付的调研问题，确认产物落点：默认 docs/research/YYYY-MM-DD--<topic>.md（与 autoresearch 无恢复面日志同目录同命名）；项目已有调研笔记惯例则跟随惯例并说明落点。
2. 派后台代理跑腿（subagent 或 cli-delegate 等只读委派；没有就本会话直接做）：逐条结论回溯一手来源（官方文档、源码、spec、第一方 API），不采信二手转述；每条结论记来源与获取时点。
3. 主会话裁决：委派结果是 claim，关键事实回主会话核对来源后才落盘；对不上来源的结论如实标注不确定。
4. 落盘为单份 markdown，文档头带归属行（Research: <问题一句话> | 日期 | 会话/轨道）——该行即自登记，sweep 对其零引用时按自足交付物走人裁不自动删；调研服务于某条已开的轨道时，在该轨道下次阶段变化或交接时由 tracks/<id>.md 的 Evidence: 链接它（写入时机见 ../writing-for-agents/references/recovery_surface_policy.md）；调研本身不写 .harness/。

边界

• 单问单答；调研中发现开放问题需要多轮验证 → 用户确认后转 autoresearch 另立轨道。
• 只读取证，不改代码；结论要落地改动 → plan / implement。
• 不做任务收尾（归 cleanup）。

Recommended next skill

• 结论要变成改动：plan；范围已明确直接 implement。
• 问题升级为开放研究：autoresearch。
• 结束：交付调研文档即完成。