SuperAPI AI 工具集

research

写作与研究

查看项目

更新于 10-15 22:41

技能介绍

用途:在 docs/brainstorms/<workflow_id>.md 获批后触发的研究阶段技能,为后续 plan-synth 阶段产出文档 docs/research/<workflow_id>.md。若该 brainstorm 文件不存在则立即拒绝执行,并提示先运行 clarify 技能或传入正确的 workflow_id。

主要能力:读取 brainstorm 文档,提取功能主题、Scope、Mechanism、Constraints、Out of scope,并据此推导 3–5 个研究查询词。随后并行运行三条相互独立的研究线:Track 1 代码库模式(查找相关模块文件、数据模型、接口、服务、事件处理、中间件及架构模式,记录 3–6 条发现,仅限代码库);Track 2 框架与库文档(查相关 API、方法签名、配置项、约束与版本差异,记录 3–6 条发现,仅限外部文档);Track 3 经 substrate-read 查询既有方案与 ADR(用主题查询或 tag 查询,先 type_filter: solution 再 type_filter: adr,记录 stop-depth ≥ summary 的命中)。

使用方式:三步以后合成文档。文件含 frontmatter(id、type: research、description、created、workflow_id)与 Summary 块(不超过 5 行非空),以及按研究线分节的可引用清单;最后向用户确认路径并说明可用于 plan-synth。

限制:brainstorm 文档缺失时不继续;不得直接读取 substrate 索引文件,一切访问都经 substrate-read;三条研究线必须并行而非串行;Summary 不超过 5 行;description 不超过 200 字符;id 与 workflow_id 必须一致且符合 kebab-case、[a-z0-9-]、最长 50 字符约定;每节只含对应研究线方法所得内容,不得跨线混入。