SuperAPI AI 工具集

spec-research

写作与研究

查看项目

更新于 10-16 00:06

技能介绍

用途:为新功能做发现、调研与架构设计,产出一份持续演进的 spec.md,说明要建什么、现有系统是什么、如何融入,并在获得人工批准后交给 spec-plan 进入规划。

主要能力:先做定位,阅读 AGENTS.md、README 与既有架构文档,扫描 docs/specs/ 了解已有领域模型与模式;需求不清时逐条提问(一次一个),明确问题、用户、现状、成功标准、集成点与约束;随后深入阅读代码实现、边界情况、错误处理与数据流,并阅读测试理解预期行为,把调研结果写入 spec.md;研究获批后用 Skill 工具调用 oracle-architect 做组件设计、领域建模与分层边界。

spec.md 内容:问题、范围(含明确排除项)、用户故事与优先级、约束、上下文、架构、API 设计、数据模型、权衡取舍、待决问题。需求直接内联在 spec.md 中,无需单独的 requirements.json。

使用方式:按步骤推进,每步结束需人工确认或审阅,未获明确批准不得进入规划,也不写代码。人工可直接在 spec.md 上批注,需重读全文、逐条处理并更新规格,可能反复多轮。

限制:资料未提供安装命令、收费、平台与效果信息;流程依赖人工确认,且需已有项目上下文与代码库可供调研。