---
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/`）