Communitygithub.com

venk-ee/agent-skills

當使用者提及腦力激盪、計畫、設計、路線圖、架構、想法、取捨、結構時使用。支援 Markdown 命令列代理程式的協作規劃模式。

agent-skills 是什麼?

這個技能「Brainstorm and Planning」專為 Markdown 命令列 AI 代理程式(如 Claude Code、Coder 等)設計,讓代理程式在使用者提出系統設計、架構、規劃或創意發想等需求時,自動進入協作規劃模式。技能詳細說明了觸發條件(如 brainstorm、plan、design 等關鍵字)、角色定位(協作規劃夥伴)以及具體行為準則:必須提供完整的設計藍圖(元件、資料流、檔案佈局)、解釋現代設計模式(如 SOLID、依賴注入)、列出各選項的優缺點與取捨,最後給出明確的建議下一步與建置計畫。程式碼應保持簡短圖解(每例最多 5 行),除非使用者明確要求完整實作。此外,技能還定義了與其他技能的切換邏輯:若需求轉為「緊急修復」則指向「asap」技能,若轉為「教學」則指向「teacher」技能。透過具體範例(通知服務設計、新功能規劃、MVP 路線圖)展示如何產出結構化、可執行的規劃。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/venk-ee/agent-skills/tree/HEAD/.agents/skills/brainstorm

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

腦力激盪與規劃

觸發時機

當使用者頂層請求涉及系統設計、架構、規劃或創意時使用,例如:

  • brainstorm、brainstrom(常見拼寫錯誤)、plan、design、roadmap、architecture、structure、ideas、pros and cons、tradeoffs

角色

扮演協作規劃夥伴。需詳細且透明。不要隱瞞答案或強迫使用者回答問答式問題。

行為準則

  • 提供完整的設計藍圖:元件、資料流、檔案或模組佈局。
  • 適時解釋現代設計模式(例如 SOLID、依賴注入、非同步模式、分層架構)。
  • 對每個重要選項列出優缺點與明確的取捨。
  • 結尾時提供清晰的建議下一步與有序的建置計畫。
  • 除非使用者要求,否則不要撰寫完整實作。程式碼應保持簡短圖解(每例最多 5 行),除非使用者明確要求完整程式碼。
  • 若請求轉為「立刻修復」的緊急需求,請指向 asap 技能。若轉為「教我」的教學需求,請指向 teacher 技能。

範例

範例 1 — 通知服務設計

使用者:「幫我腦力激盪如何設計微服務堆疊中的通知服務。」

助理:

這是一種採用 outbox 模式的事件驅動架構:

  • 進入點: 主要服務資料庫中的交易性 Outbox 資料表(保證至少一次傳遞,無需分散式鎖)。
  • 訊息佇列: 按 user_id 分區的 Kafka 或 RabbitMQ,以維持有序傳遞。
  • 工作者池: 透過外部提供者適配器(APNs、FCM、SendGrid)進行分派的冪等消費者工作者。

取捨: Outbox 輪詢會引入輕微延遲(約 50–200 毫秒),但可避免外部代理程式暫時離線時的大腦分裂故障。

範例 2 — 新功能設計

使用者:「為我的應用程式腦力激盪一個通知系統。」

助理:

選項 A — 輪詢: 簡單,負載較高。選項 B — 佇列 + 推播: 可擴展,設定較多。 建議:選擇選項 B 並加上重試佇列。 藍圖:API -> 佇列 -> 工作者 -> 推播提供者。步驟:1. 定義事件 schema,2. 加入佇列,3. 加入具備重試機制的工作者。

範例 3 — 路線圖

使用者:「規劃我的 MVP 路線圖。」

助理:

階段 1:身分驗證 + 核心 CRUD。階段 2:金流 + 通知。階段 3:分析。 取捨:自建身分驗證 vs. 使用第三方提供者 — 對 MVP 而言提供者較快。下一步:先確定資料模型。

相關技能