关于 discover
discover 是用于产出研究与分析文档而非代码的工作流技能。它指导收集来源并综合成文,也可将经确认的研究流程关联到发起它的 ideation 规格。
主要功能
- 01收集并记录研究来源
- 02根据材料撰写文档
- 03在工作流状态中记录报告路径
- 04将升级研究关联到 ideation 规格
适用场景
- 01竞品与市场研究
- 02架构比较与 ADR 准备
- 03文献综述与供应商评估
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ lvlup-sw/ exarchos --skill discover安装后在 Claude Code 中输入/discover确认已加载。
详细介绍
发现工作流技能
适用于交付成果是文档而非代码的任务的工作流类型。它不包含验证关卡(无需测试),因此不适用验证阶梯。
适用场景
- 竞争分析和市场研究
- 架构比较和 ADR 搭建
- 文献综述和供应商评估
- 不会用于实施规划的设计研究
不适用场景
- 如果交付成果包含代码变更 → 使用
/exarchos:oneshot或/exarchos:ideate - 如果需要强制执行 TDD → 使用其他任意工作流类型
- 如果研究会直接用于实施 → 使用
/exarchos:ideate(它会编写统一docs/specs/工件中的 Design & Rationale 部分)
Discover 桥接(深层规划阶梯的升级)
在 deep 规划阶梯中,/exarchos:ideate 可以升级至此工作流,将其作为一等、与事件关联的研究前置流程,而不是手动移交“开始一个新工作流”。该桥接为选择启用(须经作者确认,绝不自动运行):此选项会显示在 next_actions 中,而 discover_bridge 编排操作 — 使用 confirm: true 调用 — 会通过确定性的 correlationId 将本次发现流程与源规范关联起来(作为 state.patched 链接事件记录在功能流中)。以这种方式升级启动发现流程时,请在规范的 ## Design & Rationale → Exploration 部分引用报告路径,并使用桥接提供的 correlationId 初始化此工作流,使两个文档的溯源信息保持连贯。
阶段
阶段 1:收集(初始)
为交付成果收集来源、参考资料和原始材料。
- 定义研究问题或交付成果范围
- 识别并收集来源(URL、文档、代码引用)
- 在工作流状态中记录来源:
exarchos:exarchos_workflow({
action: "update", featureId: "<id>",
updates: { "artifacts.sources": ["<source1>", "<source2>", "..."] }
})
- 创建交付成果的大纲
转换条件: 当 artifacts.sources 为非空数组时 → synthesizing
阶段 2:综合
根据收集的来源起草交付文档。
- 根据收集的来源和大纲撰写文档
- 将文档提交到仓库(通常位于
docs/research/或docs/designs/下) - 记录报告路径:
exarchos:exarchos_workflow({
action: "update", featureId: "<id>",
updates: { "artifacts.report": "<path-to-document>" }
})
转换条件: 当设置了 artifacts.report 时 → completed
可选:升级至实施
如果发现流程揭示了实施需求:
- 在报告中注明这一发现
- 完成发现工作流后,启动一个新工作流:
将发现报告作为设计输入引用。ideate <implementation-topic>
评论
支持 Markdown