頭腦風暴:在寫代碼前先釐清意圖與方案

前言

做新功能、新組件或改行爲時,常見做法是直接讓 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

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

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

小夜