---

name: feature-brainstorm description: 功能循环第 1 步。针对单个 REQ-XXX-NNN 进行交互式头脑风暴，产出功能规格到 docs/superpowers/specs/。 user-invocable: false

allowed-tools: Read Write Skill Bash(mysql *)

所有输出必须使用中文。

feature-brainstorm

阶段范围（后端）

本 skill 服务于后端阶段。产出范围限定为 controller / service / repository / DTO / 校验 / SQL migration / REST 契约。读 docs/01 REQ 卡片时忽略 UI 描述（输入控件类型、按钮位置、列表布局等），但校验规则、业务规则仍要落到后端 DTO + service。UI 实现统一推迟到前端阶段（fe-feature-*）。

针对单个 REQ，委托 superpower-brainstorming 做交互式头脑风暴，把输出按规格模板渲染，产出单页功能规格。

执行步骤

1. 确定本次 REQ-XXX-NNN（由 module-start 派发时确定），收集上下文：REQ 卡片 docs/01-需求清单/<module>/<req_id>.md + 涉及的数据表定义（取自 docs/03 或实时 mysql 查询）。
2. 委托 superpower-brainstorming，把上下文 + 落盘路径 docs/superpowers/specs/<YYYY-MM-DD>-<REQ-id>.md 作为 caller-provided path 传入。文件已存在 → 征求用户确认后覆盖。
3. 按 ${CLAUDE_SKILL_DIR}/templates/feature-spec-template.md 渲染头脑风暴输出，写入推导路径。
4. 验证：所有顶级节非空；全文不得出现 【人工填写：...】 或 TBD——这两类标记仅供 A 阶段文档审阅用，B 阶段 spec 必须写实际值（先在 .env.local / docs/07-环境配置.md / CLAUDE.md / 现有代码查找并注明来源，查不到则用 AskUserQuestion 问用户）。
5. 输出 feature-brainstorm: <REQ> → <path>，立即调用 Skill(feature-plan)。

参考

• ${CLAUDE_SKILL_DIR}/templates/feature-spec-template.md
• 委托：superpower-brainstorming（本插件 skills/internal/superpower-brainstorming/）