SuperAPI AI 工具集

spec-planner

编程与开发

查看项目

更新于 10-15 19:53

技能介绍

用途:通过严谨对话与显式权衡分析,产出可直接实施的规格说明(spec),适用于功能规划、架构决策、重构与策略类工作。

主要能力:采用 CLARIFY→DISCOVER→DRAFT→REFINE→DONE 五阶段流程,每轮回复末尾标注当前阶段。CLARIFY 为强制阶段,须先提出 3-5 个关键澄清问题,覆盖问题动机、范围边界、约束、成功标准与风险,用户至少回答一轮后才可写规格。DISCOVER 阶段检索代码库中相关实现、关键文件、集成点与依赖,必要时用并行探索子代理或 librarian 研究生产模式。DRAFT 阶段输出问题与时机、摘要、目标与可测指标、非目标、范围与分阶段、约束、风险与缓解、依赖与集成点、最薄端到端演示路径、决策与权衡,多方案时至少比较简单路径与平衡推荐。REFINE 阶段执行完整性门禁,检查范围、占位符、可测验收标准、依赖顺序、风险归属、工作量估算与可运行演示路径,不通过则回退。DONE 阶段输出固定格式的完成摘要,含类型、工作量、状态、推荐、权衡、有序交付物与遗留问题。

使用方式:按阶段对话推进;完成后必须从主题派生 kebab-case slug,创建 docs/specs/<slug>/ 目录并写入 SPEC.md,在最终回复中确认路径。SPEC.md 使用指定 Markdown 结构,含问题、摘要、目标与成功指标表、非目标、范围与阶段、约束、风险与缓解表、依赖、集成点、演示路径、决策与权衡、开放问题表、上下文与关键文件。工作量估算分 S(<1 小时,孤立)、M(1-3 小时,少量文件)、L(1-2 天,跨领域)、XL(>2 天,重大系统工作)。规格获批后可交接:/overseer-plan docs/specs/<slug>/SPEC.md,转为可执行 Overseer 任务。

限制:资料未提供具体收费、平台支持范围与效果保证;流程要求先澄清后成文,不适合跳过对话直接产出规格。