用途:discover 是面向文档交付物(而非代码)的工作流类型,无验证关卡,不适用验证阶梯。适用场景包括竞品分析与市场调研、架构对比与 ADR 脚手架、文献综述与供应商评估,以及不进入实现规划的设计研究。若交付物含代码改动,应改用 /exarchos:oneshot 或 /exarchos:ideate;若需 TDD 约束,使用其他工作流类型;若研究直接服务于实现,使用 /exarchos:ideate。
阶段一:采集。确定研究问题或交付物范围,识别并收集来源(URL、文档、代码引用),将来源记录到工作流状态:exarchos:exarchos_workflow({action: "update", featureId: "<id>", updates: { "artifacts.sources": ["<source1>", "<source2>", "..."] }}),并创建交付物大纲。当 artifacts.sources 为非空数组时转入综合阶段。
阶段二:综合。依据来源与大纲撰写文档并提交到仓库(通常位于 docs/research/ 或 docs/designs/),记录报告路径:exarchos:exarchos_workflow({action: "update", featureId: "<id>", updates: { "artifacts.report": "<path-to-document>" }})。当 artifacts.report 设置后进入完成状态。
可选升级:若研究暴露实现需求,在报告中记录该发现;完成本工作流后启动新工作流 ideate <implementation-topic>,并把研究报告作为设计输入引用。
Discover 桥接(深度层级升级):在深度规划层级,/exarchos:ideate 可将本工作流升级为事件关联的研究前置步骤,而非手动新建工作流。该桥接需作者确认、绝不自动运行,入口出现在 next_actions 上;discover_bridge 编排动作以 confirm: true 调用,通过确定性 correlationId 把本次 discover 运行与原 spec 关联(在 feature 流上记录为 state.patched 链接事件)。经此升级运行发现时,应在 spec 的 ## Design & Rationale → Exploration 部分引用报告路径,并用桥接的 correlationId 初始化本工作流,使溯源覆盖两份文档。