SuperAPI AI 工具集

spec-brainstorm

设计与创作

查看项目

更新于 10-16 00:06

技能介绍

用途:spec-brainstorm 是一个对话式设计工作坊技能,面向需要持久化规格的大型工作,最终产出经人工评审的聚焦规格文档。仅在 atelier-orchestrator 选定 Spec-backed Plan,或人类明确要求 spec 时运行;有界工作应直接交给 spec-plan 生成 Inline Plan,本技能不重新判定规划模式。

主要能力:一次只问一个问题,优先给出 2-4 个具体选项;先做分解检查,若涉及多个独立子系统则先拆分;用 YAGNI 原则抵制范围蔓延;探索 2-3 种方案并说明优缺点与复杂度,第一种方案须保留现有架构并做最小正确改动;分批次呈现设计(用户故事、架构、API 与数据模型、取舍与未决问题),每批获得批准后再继续;对术语进行纪律性校验;写完后做占位符、内部一致性、范围、歧义与必要性自检。

输出与用法:唯一产物是 docs/specs/YYYY-MM-DD-<feature>/design.md,需求内联,无需单独 requirements.json。流程为:定向(读 AGENTS.md、README、既有 specs)→ 发现(提问,必要时跳过)→ 研究(深入读代码,按关注点/现有方案/决策/当前需求制表)→ 设计(4a 探索方案、4b 分节呈现、4c 写规格)→ 交接。

限制:本技能只能创建或更新上述 design.md,不得修改其他文件、创建 plan.json、创建 tracker 条目、调用其他工作流技能或写实现代码;即使人类要求一次完成头脑风暴、规划与实现,该边界仍适用。完成后报告并停止,不自动进入 spec-plan。若规划中发现设计缺陷,应回到研究阶段。