mcpField
D
discover

discover

github.com/lvlup-sw生产力22101 次安装1 天前更新
代码仓库

关于 discover

discover 是用于产出研究与分析文档而非代码的工作流技能。它指导收集来源并综合成文,也可将经确认的研究流程关联到发起它的 ideation 规格。

主要功能

  1. 01收集并记录研究来源
  2. 02根据材料撰写文档
  3. 03在工作流状态中记录报告路径
  4. 04将升级研究关联到 ideation 规格

适用场景

  1. 01竞品与市场研究
  2. 02架构比较与 ADR 准备
  3. 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:收集(初始)

为交付成果收集来源、参考资料和原始材料。

  1. 定义研究问题或交付成果范围
  2. 识别并收集来源(URL、文档、代码引用)
  3. 在工作流状态中记录来源:
exarchos:exarchos_workflow({
  action: "update", featureId: "<id>",
  updates: { "artifacts.sources": ["<source1>", "<source2>", "..."] }
})
  1. 创建交付成果的大纲

转换条件: 当 artifacts.sources 为非空数组时 → synthesizing

阶段 2:综合

根据收集的来源起草交付文档。

  1. 根据收集的来源和大纲撰写文档
  2. 将文档提交到仓库(通常位于 docs/research/ 或 docs/designs/ 下)
  3. 记录报告路径:
exarchos:exarchos_workflow({
  action: "update", featureId: "<id>",
  updates: { "artifacts.report": "<path-to-document>" }
})

转换条件: 当设置了 artifacts.report 时 → completed

可选:升级至实施

如果发现流程揭示了实施需求:

  1. 在报告中注明这一发现
  2. 完成发现工作流后,启动一个新工作流:
    ideate <implementation-topic>
    
    将发现报告作为设计输入引用。

评论

支持 Markdown