头脑风暴:在写代码前先厘清意图与方案

前言

做新功能、新组件或改行为时,常见做法是直接让 Agent 开写。需求只停留在一句口头描述,边界和交互没对齐,返工往往出现在实现过半之后。下面介绍 SkillHub 上的「头脑风暴」Skill:它把「先想清楚再动手」写成 Agent 必须遵守的流程,在实现前探索用户意图、需求与设计。

这是什么

「头脑风暴」是社区来源(community)的 Agent Skill,坐标为 @user_142af50a/brainstorming-v2,当前版本 1.0.0,由发布者 user_142af50a 维护,分类为 ai-agent。官方页面标注 requires_api_key=false,安装后无需额外 API Key。

官方简介要求:在进行任何创造性工作之前必须使用本 Skill——包括创建功能、构建组件、增加能力或修改行为;其作用是在实现之前探索用户意图、需求与设计。

  • SkillHub 页面:https://www.skillhub.cn/skills/user_142af50a/brainstorming-v2
  • API 元数据地址:https://api.skillhub.cn/user_142af50a/brainstorming-v2

核心功能

根据官方简介,可核实的能力如下:

  1. 前置约束:创造性任务(新功能、新组件、改行为等)必须先走本 Skill,而不是直接写代码。
  2. 意图澄清:在动手前与用户(或任务描述)对齐真实目标,减少「理解偏差」导致的返工。
  3. 需求与设计探索:在实现阶段之前,把需求范围与设计方案谈清楚,而不是边写边猜。

Skill 正文遵循通用 SKILL.md 格式;具体提问清单与输出模板以安装后的 SKILL.md 为准。

安装与启用

官方推荐按 SkillHub 安装文档操作,并安装坐标 @user_142af50a/brainstorming-v2。

1、检查或安装 SkillHub CLI

command -v skillhub && skillhub --version

若未安装 CLI,可使用官方脚本(完整安装含 CLI 与默认 Skill):

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI 时:

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2、安装本 Skill 到当前 Agent 的 skills 目录

安装时必须用 --dir 指向当前 Agent 识别的 skills 目录;默认装到 ./skills/ 可能不会被 Agent 加载。

skillhub install user_142af50a/brainstorming-v2 --dir <你的 skills 目录>

常用路径(来自 SkillHub 安装文档):

  • Cursor:~/.cursor/skills/
  • Claude Code:~/.claude/skills/
  • Codex:~/.codex/skills/ 或项目下的 .agents/skills/

也可将下面提示交给 AI,让其按 https://skillhub.cn/install/skillhub.md 完成安装:

请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_142af50a/brainstorming-v2`。

安装后按你所用 Agent 的说明启用或刷新 Skills 列表(部分环境需重启客户端)。

典型用法

官方页面未单独给出分步示例;结合简介,可复现的使用方式如下:

  1. 在提出「加功能 / 做组件 / 改行为」类任务前,确保 Agent 已加载 @user_142af50a/brainstorming-v2。
  2. 用自然语言描述你想做的事,让 Agent 先按 Skill 做意图与需求、设计层面的讨论,而不是立刻改仓库。
  3. 双方对范围与方案达成一致后,再进入具体实现。

若 Skill 内写了更细的流程(例如必须产出设计摘要、待确认问题列表),以本地 SKILL.md 为准。

适用场景与注意

适合谁

  • 经常用 Cursor、Claude Code、Codex 等做功能开发的开发者。
  • 希望把「需求对齐」固化进 Agent 工作流、减少直接开写的情况。

注意

  • 本 Skill 强调先设计再实现,简单单行修复或纯问答类任务是否触发,取决于 Agent 如何解析「创造性工作」;以 SKILL.md 中的判定为准。
  • SkillHub 页面显示的下载量、评分会变动;撰写时页面数据为评分 100000、下载 6348(以你打开页面时的统计为准)。
  • 社区来源 Skill 的内容以发布者维护的 SKILL.md 为最终依据;升级可用 skillhub 在对应 --dir 下更新,并留意版本号 1.0.0 之后的变更说明。

结尾

「头脑风暴」把实现前的意图、需求与设计探索写成 Agent 的前置步骤,适合在频繁做功能与改行为时减少理解偏差带来的返工。安装与坐标说明见 SkillHub:https://www.skillhub.cn/skills/user_142af50a/brainstorming-v2

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye