spec-brainstorm ​

通过协作对话明确 WHAT，形成右尺寸 requirements 文档。

ASCII 链路图 ​

text
Codebase -> Spec -> Plan -> Tasks -> Code -> Review -> Knowledge
              |
              v
              spec-brainstorm
              entry: spec-brainstorm
              type: workflow command

基本信息 ​

字段内容
Skillspec-brainstorm
类型workflow command
研发链路位置Spec
当前入口spec-brainstorm
兼容别名/spec:brainstorm、$spec-brainstorm
Sourceskills/spec-brainstorm/SKILL.md
Governancesrc/cli/contracts/dual-host-governance/skills-governance.json（supported-host skills governance）

描述 ​

Explore vague or ambitious ideas into a right-sized requirements-only unified plan. Use when the user wants to brainstorm, think through scope, decide what to build, or needs collaborative product framing before planning. Also use when the user must scope work in territory they say they do not know ("I know nothing about X but need to...") or asks for a blindspot pass — mapping the decision surface before questions begin. Not for executing already-specified work — direct implementation, debugging, or code review where no product scope is left to decide. Not for a decisive verdict on whether to adopt or switch to a specific external technology, library, or platform — brainstorming scopes what to build, not whether to commit to an outside option.

Source 契约摘要 ​

该 source skill 未声明标准 Workflow Contract Summary 小节；本页以 frontmatter、supported-host governance 和维护者补充元数据为准。

何时使用 ​

  • 用户还在定义问题或范围。
  • 存在多个合理产品方向。
  • 需要先整理 actors、flows、acceptance examples 和 non-goals。

工作步骤 ​

  • 读取用户意图、代码库背景、已有 requirements、历史学习和外部证据。
  • 收敛问题框架、用户流、边界、验收标准或候选方向。
  • 区分必须现在解决的问题和可延后到计划或实现阶段的问题。
  • 把 WHAT 层证据交给 plan 或 doc-review。

输出 ​

  • requirements、ideation artifact、scope boundaries 或 open questions。
  • 可供计划阶段追溯的 actors、flows、acceptance examples 和关键决策。

Agent / Persona 列表 ​

  • 可按需要引入 spec-flow、product、design、security、repo、web 或 issue research agents。
  • agent 产出是证据和问题发现，最终需求边界仍由当前 workflow 汇总。

本 skill 在 source 中挂载了 1 个 skill-local 专家资产（agent 1 · persona 0），路径为 skills/spec-brainstorm/references/{agents,personas}/。跨 skill 复用时，详情页按文件名去重。

名称类型摘要
spec-slack-researcheragentYou are an expert organizational knowledge researcher specializing in extracting actionable context from Slack conversations.

agent 详情页入口仍在 /reference/agents/*；完整按 skill 归属索引见 Agents 参考。persona 目前以 skill-local prompt 形式挂在所属 skill 下，不单独生成全局详情页。

边界 ​

  • 不写实现计划。
  • 当 HOW 已清楚且可执行时应进入 spec-plan 或 spec-work。

源码校准 ​

  • 本页由 website/scripts/generate-skill-detail-pages.js 从上游 source skill 生成。
  • 当前入口、兼容别名与宿主投递 metadata 来自 src/cli/contracts/dual-host-governance/skills-governance.json。
  • 当 source skill 或 governance contract 变化后，应重新运行 npm run reference:pages 并执行 npm run content:audit。