前言¶
做新功能、新組件或改行爲時,常見做法是直接讓 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
核心功能¶
根據官方簡介,可覈實的能力如下:
- 前置約束:創造性任務(新功能、新組件、改行爲等)必須先走本 Skill,而不是直接寫代碼。
- 意圖澄清:在動手前與用戶(或任務描述)對齊真實目標,減少「理解偏差」導致的返工。
- 需求與設計探索:在實現階段之前,把需求範圍與設計方案談清楚,而不是邊寫邊猜。
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 列表(部分環境需重啓客戶端)。
典型用法¶
官方頁面未單獨給出分步示例;結合簡介,可復現的使用方式如下:
- 在提出「加功能 / 做組件 / 改行爲」類任務前,確保 Agent 已加載
@user_142af50a/brainstorming-v2。 - 用自然語言描述你想做的事,讓 Agent 先按 Skill 做意圖與需求、設計層面的討論,而不是立刻改倉庫。
- 雙方對範圍與方案達成一致後,再進入具體實現。
若 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