🔧 阿川の電商水電行
agency-agents 是一個以 Markdown 檔案提供 144 個 AI 代理人定義的開源專案（開源軟體，OSS）。支援超過 10 種工具，包括 Claude Code、Copilot、Cursor、Gemini CLI 等。
與「請以開發者身分行事」之類的通用提示詞不同，agency-agents 的特色在於把各專業領域的知識體系結構化。例如 Frontend Developer 代理人會包含 Core Web Vitals（核心網路體驗指標）的優化方法與無障礙準則。它補足了通用提示詞常遺漏的觀點。
此倉庫在 2025 年 10 月建立。至 2026 年 3 月 14 日為止，已有 40,889 顆星、6,172 個 fork，貢獻者已超過 36 人。
安裝
基本步驟
將倉庫 clone 後執行安裝腳本。
git clone https://github.com/msitarzewski/agency-agents.git
cd agency-agents針對 Claude Code
指定 --tool claude-code 時，代理人檔案會被複製到 ~/.claude/agents/。
./scripts/install.sh --tool claude-code --no-interactive針對 Copilot / Cursor
- Copilot：會放在
~/.github/agents/與~/.copilot/agents/。
./scripts/install.sh --tool copilot --no-interactive- Cursor：規則檔會放在
.cursor/rules/。
./scripts/install.sh --tool cursor --no-interactive手動複製
若只想導入特定類別，可手動複製所需檔案。
cp agents/engineering/*.md ~/.claude/agents/一次導入全部類別可能會讓可選的上下文過多。建議先從與自己工作最接近的類別開始。
支援工具一覽
install.sh 支援以下工具與安裝位置：
- claude-code:
~/.claude/agents/ - copilot:
~/.github/agents/、~/.copilot/agents/ - cursor:
.cursor/rules/ - gemini-cli:
~/.gemini/extensions/agency-agents/ - aider: 目前放在執行目錄下的
CONVENTIONS.md - windsurf: 目前放在執行目錄下的
.windsurfrules
如何選擇代理人
類別一覽
144 位代理人被分類為 12 個類別：
- Marketing（行銷）：26 個，例如 Growth Hacker、Content Creator
- Engineering（工程）：23 個，例如 Frontend Developer、Backend Architect
- Specialized（專門領域）：23 個，例如 MCP Builder、Compliance Auditor
- Design（設計）：8 個，例如 UX Researcher、Brand Guardian
- Testing（測試）：8 個，例如 API Tester、Reality Checker
- Sales（業務）：8 個，例如 Outbound Strategist
- Paid Media（付費媒體）：7 個，例如 PPC Strategist
- Project Management（專案管理）：6 個，例如 Sprint Prioritizer
- Support（支援）：6 個，例如 Support Responder
- Spatial Computing（空間運算）：6 個，例如 XR Interface Architect（涵蓋 Unity / Unreal / Godot / Blender）
- Product（產品）：4 個，例如 Trend Researcher
推薦的 3 個代理人
若開發者要先嘗試，推薦以下三個：
-
Frontend Developer
支援 React、Vue、Angular，並包含效能優化觀點。會提出包含 LCP、CLS、INP 等 Core Web Vitals（核心網路體驗指標）改善建議。 -
Security Engineer
補強安全面向的檢視。會指出相依套件的漏洞檢查、輸入驗證、認證流程檢查等常被忽略的細節。 -
Reality Checker
擔任品質閘門。在各里程碑檢查「是否真實符合需求」，指出遺漏或過度實作。適合在 PR 審查前做自我檢查。
實際使用範例
在 Claude Code 中指定代理人
安裝後，在 Claude Code 的提示輸入框輸入 /agents 會顯示可用代理人清單。選擇想用的代理人後，該會話即會套用相應的專業知識。
使用範例：React 元件的效能改善
以下示範向 Frontend Developer 代理人詢問「商品列表元件渲染緩慢，想改善」時的輸出差異。
通用提示詞情況：
- React.memoでメモ化してください
- useCallbackを使ってください
- 仮想スクロールを検討してください這類建議相當一般，缺乏具體細節。
Frontend Developer 代理人情況：
1. プロファイリング
- React DevTools Profilerで再レンダリング原因を特定
- Lighthouse でLCP/CLSを計測（現状値を記録）
2. レンダリング最適化
- 商品カードをReact.memoでラップ（propsの比較関数を指定）
- フィルタ/ソート処理をuseMemoで囲む（依存配列を明示）
3. データ取得
- Intersection Observer APIで画像の遅延読み込みを実装
- 50件以上の場合はreact-windowで仮想スクロール化
4. アクセシビリティ
- 商品カードにaria-labelを追加
- キーボードナビゲーションの動作確認
5. 検証
- Lighthouse Performance スコアの改善値を記録
- Core Web Vitals（LCP < 2.5s, CLS < 0.1）を満たすか確認代理人定義中包含的專業知識會反映在輸出中，會明確提出「量測→改善→驗證」的循環，並同時涵蓋無障礙面向。輸出品質仍會依據基礎模型的能力而有所差異；代理人定義主要提供「應考量哪些項目」的指引，作為引導模型發揮的框架。
自訂化
直接編輯 Markdown 檔案
代理人定義以 Markdown 檔案儲存，可用文字編輯器自由修改。
例如要在 Frontend Developer 代理人加入專案特有規範，可在檔案末尾加入：
## プロジェクト固有ルール
- UIフレームワーク: shadcn/ui を使用
- スタイリング: Tailwind CSS v4
- テスト: Vitest + Testing Library
- 状態管理: Zustand（Reduxは使わない）然後儲存該代理人檔案。
自製代理人的建立
倉庫的 CONTRIBUTING.md 提供了範本。為公司或專案打造專屬代理人的流程大致如下：
- 複製現有代理人檔案作為基底
- 修改角色（Role）與專業領域描述
- 根據專案調整檢查清單與判斷基準
- 放到
~/.claude/agents/並確認運作
自訂的檔案可能會在執行 git pull 時被覆蓋，建議將修改後的代理人另存於不同目錄以便管理。
多代理人工作流程
新創公司 MVP 的範例
倉庫內 examples/workflow-startup-mvp.md 示範了結合多個代理人的工作流程範例。
此流程以以下順序推進 MVP 開發：
- Trend Researcher（趨勢研究者）進行市場調查與技術選型
- Backend Architect（後端架構師）負責 API 設計與資料庫設計
- Frontend Developer（前端開發）進行 UI 實作
- Security Engineer（資安工程師）執行安全審查
- Reality Checker（實際性檢查者）驗證整體一致性與品質
將一個代理人的輸出作為下一個代理人的輸入，可建立高專業性的審查鏈。目前尚未提供代理人間的自動串接功能，需手動切換代理人進行作業。未來可能會新增協調（orchestration）功能。
組合設計考量
設計多代理人工作流程時，基本原則是把「建立者」與「檢查者」分開。例如 Frontend Developer 與 Reality Checker 配對，或 Backend Architect 與 Security Engineer 配對，都是有效的組合方式。
相關文章
想更深入了解設計理念，可參考以下文章：
1) --- 會變成分隔線（上一行必須是空白）
2) # 會變成一級標題
3) ## 會變成二級標題
4) ### 會變成三級標題
5) **粗體文字**會顯示粗體文字
6) ```當第一行與最後一行會顯示程式碼
7) 請搜尋 Markdown 語法，了解各種格式
