🎭 AI Agent Team = Persona + Workflow + Deliverables + Metrics

# 方式一：Clone（推薦，方便後續更新）
git clone https://github.com/msitarzewski/agency-agents.git
cd agency-agents

# 方式二：Fork 後 Clone（適合需要客製化的團隊）
# 先在 GitHub 上 Fork，然後：
git clone https://github.com/<your-org>/agency-agents.git
cd agency-agents
git remote add upstream https://github.com/msitarzewski/agency-agents.git

agency-agents/
├── engineering/          # 💻 工程部門（28+ Agent：Frontend / Backend / DevOps / Security / SRE...）
├── design/               # 🎨 設計部門（8 Agent：UI / UX / Brand / Whimsy...）
├── marketing/            # 📢 行銷部門（25+ Agent：Growth / Content / SEO / 中國市場...）
├── product/              # 📊 產品部門（5 Agent：PM / Sprint / Feedback / Nudge...）
├── project-management/   # 🎬 專案管理部門（6 Agent：Producer / Shepherd / Jira...）
├── testing/              # 🧪 測試部門（8 Agent：QA / Performance / API / A11y...）
├── support/              # 🛟 支援部門（6 Agent：Analytics / Finance / Legal...）
├── sales/                # 💼 銷售部門（9 Agent：Outbound / Discovery / Deal...）
├── paid-media/           # 💰 付費媒體部門（7 Agent：PPC / Search Query / Tracking...）
├── game-development/     # 🎮 遊戲開發部門（17+ Agent：Unity / Unreal / Godot / Blender / Roblox）
├── spatial-computing/    # 🥽 空間運算部門（6 Agent：XR / Vision Pro / WebXR...）
├── specialized/          # 🎯 特殊專業部門（30+ Agent：Orchestrator / MCP / Legal / HR...）
├── finance/              # 💵 財務部門（5 Agent：Bookkeeper / FP&A / Tax...）
├── academic/             # 📚 學術部門（5 Agent：Anthropologist / Historian / Narratologist...）
├── strategy/             # 📈 策略目錄（部門協作策略定義）
├── examples/             # 📖 使用範例（含 Nexus Spatial Discovery 等完整案例）
├── integrations/         # 🔌 工具整合說明（11 個工具的 README）
├── scripts/              # ⚙️ 安裝與轉換腳本
│   ├── install.sh        # 安裝腳本（互動式 / 平行模式）
│   └── convert.sh        # 格式轉換腳本（支援平行轉換）
├── .github/              # CI/CD 與專案設定
├── CONTRIBUTING.md       # 貢獻指南（Agent 模板與規範）
├── CONTRIBUTING_zh-CN.md # 貢獻指南（簡體中文版）
├── SECURITY.md           # 安全政策（漏洞回報流程）
├── .gitattributes        # 強制 LF 換行符
├── LICENSE               # MIT 授權
└── README.md             # 專案說明

# 步驟一：生成各工具的整合檔案
./scripts/convert.sh

# 步驟二：互動式安裝（自動偵測已安裝的工具）
./scripts/install.sh

+------------------------------------------------+
|   The Agency — Tool Installer                  |
+------------------------------------------------+

System scan: [*] = detected on this machine

[x]  1)  [*]  Claude Code     (claude.ai/code)
[x]  2)  [*]  Copilot         (~/.github + ~/.copilot)
[x]  3)  [*]  Antigravity     (~/.gemini/antigravity)
[ ]  4)  [ ]  Gemini CLI      (gemini extension)
[ ]  5)  [ ]  OpenCode        (opencode.ai)
[ ]  6)  [ ]  OpenClaw        (~/.openclaw/agency-agents)
[x]  7)  [*]  Cursor          (.cursor/rules)
[ ]  8)  [ ]  Aider           (CONVENTIONS.md)
[ ]  9)  [ ]  Windsurf        (.windsurfrules)
[ ] 10)  [ ]  Qwen Code       (~/.qwen/agents)
[ ] 11)  [ ]  Kimi Code       (~/.config/kimi/agents)

[1-11] toggle   [a] all   [n] none   [d] detected
[Enter] install   [q] quit

# 安裝至 Claude Code
./scripts/install.sh --tool claude-code

# 安裝至 GitHub Copilot
./scripts/install.sh --tool copilot

# 安裝至 Cursor
./scripts/install.sh --tool cursor

# 安裝至 Aider
./scripts/install.sh --tool aider

# 安裝至 Windsurf
./scripts/install.sh --tool windsurf

# 安裝至 Antigravity（Gemini）
./scripts/install.sh --tool antigravity

# 安裝至 Gemini CLI
./scripts/install.sh --tool gemini-cli

# 安裝至 OpenCode
./scripts/install.sh --tool opencode

# 安裝至 OpenClaw
./scripts/install.sh --tool openclaw

# 安裝至 Qwen Code
./scripts/install.sh --tool qwen

# 安裝至 Kimi Code
./scripts/install.sh --tool kimi

# 僅複製工程部門的 Agent 到 Claude Code
cp engineering/*.md ~/.claude/agents/

# 僅複製測試部門的 Agent 到 Claude Code
cp testing/*.md ~/.claude/agents/

# 複製到 GitHub Copilot
cp engineering/*.md ~/.github/agents/
cp engineering/*.md ~/.copilot/agents/

# 使用 Git Bash
& "C:\Program Files\Git\bin\bash.exe" -c "./scripts/install.sh --tool claude-code"

# 或手動複製（PowerShell）
Copy-Item engineering\*.md $env:USERPROFILE\.claude\agents\ -Force
Copy-Item engineering\*.md $env:USERPROFILE\.github\agents\ -Force
Copy-Item engineering\*.md $env:USERPROFILE\.copilot\agents\ -Force

# 平行轉換所有工具格式
./scripts/convert.sh --parallel

# 平行安裝所有偵測到的工具
./scripts/install.sh --no-interactive --parallel

# 指定平行任務數
./scripts/install.sh --no-interactive --parallel --jobs 4

# 確認 Claude Code agents 已安裝
ls ~/.claude/agents/ | head -20

# 確認 Copilot agents 已安裝
ls ~/.github/agents/ | head -20

# 在 Claude Code 中測試
# 開啟 Claude Code，輸入：
# "Hey Claude, activate Backend Architect mode and help me design a REST API"

---
name: "Frontend Developer"
description: "React/Vue/Angular, UI implementation, performance"
emoji: "🎨"
color: "#61DAFB"
services:
  - frontend
  - ui
  - performance
---

# 🎨 Frontend Developer

## Identity & Memory

You are a senior frontend developer with 10+ years of experience...
Your communication style is direct, code-focused, and practical.

## Core Mission

Build performant, accessible, and maintainable web interfaces that
deliver exceptional user experiences.

## Critical Rules

1. All components must be accessible (WCAG 2.1 AA minimum)
2. Bundle size must be monitored — no bloated dependencies
3. Core Web Vitals must be in green zone
4. TypeScript strict mode is mandatory

## Technical Deliverables

### React Component Example

​```tsx
interface ButtonProps {
  variant: 'primary' | 'secondary' | 'danger';
  size: 'sm' | 'md' | 'lg';
  isLoading?: boolean;
  children: React.ReactNode;
  onClick?: () => void;
}

export const Button: React.FC<ButtonProps> = ({
  variant,
  size,
  isLoading = false,
  children,
  onClick,
}) => {
  return (
    <button
      className={cn(baseStyles, variantStyles[variant], sizeStyles[size])}
      disabled={isLoading}
      onClick={onClick}
      aria-busy={isLoading}
    >
      {isLoading ? <Spinner size={size} /> : children}
    </button>
  );
};
​```

## Workflow Process

1. **需求理解** → 確認 UI/UX 需求與設計稿
2. **元件規劃** → 拆解元件結構、定義 Props
3. **實作開發** → 撰寫元件、樣式、邏輯
4. **測試驗證** → 單元測試、E2E 測試、視覺回歸
5. **效能優化** → Lighthouse 分析、Bundle 分析
6. **Code Review** → 程式碼審查與修正

## Success Metrics

- Core Web Vitals 全綠
- 測試覆蓋率 > 80%
- Lighthouse Performance > 90
- Accessibility Score > 95
- Bundle size < 200KB (gzipped)

## Communication Style

- 直接、技術導向
- 以程式碼說話
- 注重實用性而非理論
- 主動提出效能與可維護性建議

## Identity & Memory

You are a battle-hardened backend architect with 15+ years of experience
in high-traffic systems (10K+ RPS). You've survived multiple production
outages and learned the hard way that premature optimization is the root
of all evil — but ignoring performance is the root of all outages.

You communicate in concise, architecture-focused language. You always
consider: scalability, fault tolerance, and operational cost.

## Identity

You are a helpful backend developer.
（太過籠統、缺乏個性和專業深度）

## 任務

請使用 Backend Architect Agent 設計以下功能的 API：

### 需求
- 使用者登入功能
- 支援 JWT Token
- 支援 OAuth2.0（Google / GitHub）

### 技術限制
- Spring Boot 3.5
- PostgreSQL 16
- Redis 7（Session Cache）

### 非功能需求
- 回應時間 < 200ms
- 支援 1000 RPS

---
name: "Code Reviewer"
description: "Constructive code review, security, maintainability"
emoji: "👁️"
---

# 👁️ Code Reviewer

## Identity & Memory

You are a meticulous code reviewer who has reviewed 10,000+ PRs across
startups and Fortune 500 companies. You believe code review is a teaching
moment, not a gatekeeping ceremony. You always explain WHY, not just WHAT.

## Core Mission

Ensure every PR that passes your review is:
- Secure (no OWASP Top 10 violations)
- Maintainable (future developers will thank you)
- Performant (no obvious bottlenecks)
- Tested (critical paths covered)

## Critical Rules

1. Never approve code with SQL injection, XSS, or auth bypass
2. Every public API must have input validation
3. Magic numbers must be constants
4. Dead code must be removed
5. Comments should explain WHY, not WHAT

## Workflow Process

1. **概覽** → 理解 PR 目的與範圍
2. **安全檢查** → OWASP Top 10 掃描
3. **邏輯審查** → 商業邏輯正確性
4. **風格檢查** → 命名、結構、可讀性
5. **效能檢查** → N+1、記憶體洩漏、不必要的計算
6. **測試檢查** → 測試覆蓋率與品質
7. **回饋撰寫** → 建設性的回饋意見

## Success Metrics

- 生產環境 Bug 減少 40%
- PR 回饋時間 < 4 小時
- 團隊程式碼品質分數提升
- 新人 onboarding 時間縮短

# 自動安裝所有 Agent
./scripts/install.sh --tool claude-code

# 或手動複製
cp engineering/*.md ~/.claude/agents/
cp testing/*.md ~/.claude/agents/
cp design/*.md ~/.claude/agents/

Hey Claude, activate Backend Architect mode and help me design 
a REST API for user authentication.

# 啟用多個 Agent 協作
I need help building a web application. Let's work together:

1. First, activate Product Manager mode — analyze these requirements:
   [貼上需求文件]

2. Then, activate Backend Architect mode — design the API based on 
   the PM's analysis.

3. Finally, activate Security Engineer mode — review the architecture 
   for security issues.

Activate Frontend Developer mode.

I need a Vue 3 + TypeScript dashboard component with:
- Real-time data updates (WebSocket)
- Responsive layout (mobile-first)
- Dark/light theme support
- Chart.js integration for metrics visualization

Tech stack: Vue 3, TypeScript, Tailwind CSS, Pinia, Chart.js

Activate Code Reviewer mode.

Please review the following Spring Boot controller for:
- Security vulnerabilities (OWASP Top 10)
- Performance issues
- Best practices compliance
- Test coverage gaps

[貼上程式碼]

Activate Agents Orchestrator mode.

I'm building a CRM system. Please coordinate the following agents 
in sequence:

1. Product Manager: Define user stories for contact management
2. Backend Architect: Design the API and database schema
3. Frontend Developer: Build the UI components
4. QA (Reality Checker): Create test plan
5. Security Engineer: Security review

Start with Phase 1.

{
  "agents_directory": "~/.claude/agents",
  "preferred_agents": [
    "backend-architect",
    "frontend-developer",
    "code-reviewer",
    "security-engineer"
  ],
  "agent_activation": "explicit"
}

# 自動安裝
./scripts/install.sh --tool copilot

# 手動安裝（兩個路徑都需要）
mkdir -p ~/.github/agents ~/.copilot/agents
cp engineering/*.md ~/.github/agents/
cp engineering/*.md ~/.copilot/agents/

# 使用轉換腳本
./scripts/convert.sh --tool copilot

@workspace 請使用 Backend Architect 的角色，為以下需求設計 REST API：

## 需求
- 使用者管理（CRUD）
- JWT 認證
- 角色權限控管（RBAC）

## 技術棧
- Spring Boot 3.5
- PostgreSQL 16
- Redis 7

請產出：
1. API endpoint 清單
2. Request/Response DTO
3. DB Schema (DDL)
4. Spring Security 設定

# Copilot 指引

## 使用 Agency Agents
本專案使用 agency-agents 框架，以下為常用 Agent 角色：

### Backend Architect
- 設計 Clean Architecture
- API 設計遵循 RESTful 原則
- 所有 API 需有 input validation

### Security Engineer
- 所有 PR 需通過安全審查
- 遵循 OWASP Top 10
- 敏感資料需加密

### Code Reviewer
- 程式碼必須有單元測試
- 命名需符合團隊規範
- 無 magic numbers

# 使用轉換腳本（轉為 .mdc 格式）
./scripts/convert.sh --tool cursor

# 安裝到 Cursor
./scripts/install.sh --tool cursor

.cursor/
└── rules/
    ├── backend-architect.mdc
    ├── frontend-developer.mdc
    ├── security-engineer.mdc
    └── code-reviewer.mdc

Use the Backend Architect rules to design a microservices 
architecture for an e-commerce system with:
- Order service
- Payment service  
- Inventory service
- User service

Include: API contracts, event-driven communication (Kafka), 
and database-per-service pattern.

# 轉換為 CONVENTIONS.md 格式
./scripts/convert.sh --tool aider

# 安裝（會合併所有 Agent 到單一 CONVENTIONS.md）
./scripts/install.sh --tool aider

# 啟動 Aider
aider --model claude-3-opus

# Aider 會自動載入 CONVENTIONS.md 中的 Agent 規則

# 轉換為 SKILL.md 格式
./scripts/convert.sh --tool antigravity

# 安裝
./scripts/install.sh --tool antigravity

# 在 Gemini 中啟用 Agent
@agency-frontend-developer review this React component
@agency-security-engineer check this code for vulnerabilities

# 專案級安裝（推薦）
cd /your/project
/path/to/agency-agents/scripts/install.sh --tool opencode

# 全域安裝
mkdir -p ~/.config/opencode/agents
cp integrations/opencode/agents/*.md ~/.config/opencode/agents/

# 在 OpenCode 中使用 @ 語法啟用 Agent
@backend-architect design this API
@security-engineer review this authentication flow

# 轉換為 OpenClaw 格式（SOUL.md + AGENTS.md + IDENTITY.md）
./scripts/convert.sh --tool openclaw

# 安裝
./scripts/install.sh --tool openclaw

# 安裝完成後重啟 Gateway
openclaw gateway restart

~/.openclaw/agency-agents/
├── frontend-developer/
│   ├── SOUL.md        # Agent 核心人設
│   ├── AGENTS.md      # Agent 能力定義
│   └── IDENTITY.md    # Agent 身份資訊
├── backend-architect/
│   ├── SOUL.md
│   ├── AGENTS.md
│   └── IDENTITY.md
└── ...

# 轉換為 Qwen SubAgent 格式
./scripts/convert.sh --tool qwen

# 專案級安裝
cd /your/project
./scripts/install.sh --tool qwen

# 透過名稱引用
Use the frontend-developer agent to review this component

# 或讓 Qwen 根據任務上下文自動委派
# 使用 /agents 命令管理（互動模式）

# 轉換為 Kimi Code YAML 格式
./scripts/convert.sh --tool kimi

# 安裝
./scripts/install.sh --tool kimi

# 指定 Agent 執行任務
kimi --agent-file ~/.config/kimi/agents/frontend-developer/agent.yaml

# 在專案中使用
kimi --agent-file ~/.config/kimi/agents/backend-architect/agent.yaml \
     --work-dir /your/project \
     "Design a REST API for user management"

Activate Product Manager mode.

## 背景
我們需要為公司開發一個企業級 CRM（客戶關係管理）系統。

## 目標用戶
- 業務人員（Sales Rep）
- 業務主管（Sales Manager）
- 系統管理員（Admin）

## 核心功能需求
1. 客戶管理：新增/編輯/搜尋客戶資料
2. 聯繫記錄：追蹤所有與客戶的互動
3. 商機管理：銷售漏斗管理
4. 報表：銷售績效報表
5. 通知：重要事件提醒

## 交付物
請產出：
1. User Story（含 Acceptance Criteria）
2. 功能優先級矩陣（MoSCoW）
3. MVP 範圍定義
4. 非功能需求清單

## User Story 範例

### US-001: 客戶資料管理
**As a** 業務人員
**I want to** 新增與編輯客戶資料
**So that** 我能維護完整的客戶資訊

**Acceptance Criteria:**
- [ ] 可輸入：公司名稱、聯絡人、電話、Email、地址
- [ ] 支援客戶分類（A/B/C 級）
- [ ] 支援自訂標籤
- [ ] 修改記錄需保留歷史版本
- [ ] 支援模糊搜尋（公司名稱、聯絡人）

### 優先級矩陣

| 功能 | 優先級 | Sprint |
|------|--------|--------|
| 客戶 CRUD | Must Have | Sprint 1 |
| JWT 認證 | Must Have | Sprint 1 |
| 聯繫記錄 | Must Have | Sprint 2 |
| 商機管理 | Should Have | Sprint 3 |
| 報表 | Should Have | Sprint 4 |
| 通知系統 | Could Have | Sprint 5 |

Activate Backend Architect mode.

## 需求來源
以下是 PM Agent 產出的 User Story 和需求規格：
[貼上 PM Agent 的產出]

## 技術限制
- Java 21 + Spring Boot 3.5
- Clean Architecture（必須使用）
- PostgreSQL 16
- Redis 7（Session + Cache）
- Kafka（事件驅動）

## 交付物
請產出：
1. 系統架構圖（層次說明）
2. API 設計（OpenAPI 格式）
3. DB Schema（DDL）
4. 模組拆分建議
5. 安全架構設計

## 系統分層架構

### Clean Architecture 層次

​```
┌─────────────────────────────────┐
│        Presentation Layer       │
│    (Controller / DTO / Mapper)  │
├─────────────────────────────────┤
│        Application Layer        │
│    (Use Case / Service / Port)  │
├─────────────────────────────────┤
│          Domain Layer           │
│  (Entity / Value Object / Repo) │
├─────────────────────────────────┤
│       Infrastructure Layer      │
│  (JPA / Redis / Kafka / HTTP)   │
└─────────────────────────────────┘
​```

## API 設計（部分）

​```yaml
openapi: 3.0.3
info:
  title: CRM API
  version: 1.0.0

paths:
  /api/v1/customers:
    get:
      summary: 查詢客戶列表
      parameters:
        - name: keyword
          in: query
          schema:
            type: string
        - name: page
          in: query
          schema:
            type: integer
            default: 0
        - name: size
          in: query
          schema:
            type: integer
            default: 20
      responses:
        '200':
          description: 成功
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PagedCustomerResponse'
    post:
      summary: 新增客戶
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateCustomerRequest'
      responses:
        '201':
          description: 建立成功
​```

## DB Schema

​```sql
CREATE TABLE customers (
    id          UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    company     VARCHAR(200) NOT NULL,
    contact     VARCHAR(100) NOT NULL,
    email       VARCHAR(200),
    phone       VARCHAR(50),
    grade       VARCHAR(1) DEFAULT 'C' CHECK (grade IN ('A','B','C')),
    tags        TEXT[],
    created_by  UUID NOT NULL REFERENCES users(id),
    created_at  TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
    updated_at  TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
    version     INTEGER DEFAULT 1
);

CREATE INDEX idx_customers_company ON customers USING gin(company gin_trgm_ops);
CREATE INDEX idx_customers_contact ON customers USING gin(contact gin_trgm_ops);
CREATE INDEX idx_customers_grade ON customers(grade);
​```

Activate Backend Architect mode (implementation focus).

## 架構設計
[貼上 Architect Agent 的產出]

## 任務
請實作客戶管理模組（Customer Module），使用 Clean Architecture：

1. Domain Layer: Customer Entity, CustomerRepository Port
2. Application Layer: CreateCustomerUseCase, GetCustomersUseCase
3. Infrastructure Layer: JpaCustomerRepository
4. Presentation Layer: CustomerController, CustomerDTO

## 規範
- Java 21 + Spring Boot 3.5
- 使用 Record 作為 DTO
- 使用 Spring Data JPA
- 所有輸入需驗證（Jakarta Validation）
- 需包含單元測試

// Domain Layer - Entity
public class Customer {
    private final CustomerId id;
    private CompanyName company;
    private ContactName contact;
    private Email email;
    private Phone phone;
    private CustomerGrade grade;
    private List<Tag> tags;
    private final AuditInfo auditInfo;

    public static Customer create(
            CompanyName company,
            ContactName contact,
            Email email,
            UserId createdBy) {
        return new Customer(
            CustomerId.generate(),
            company, contact, email,
            null, CustomerGrade.C,
            List.of(),
            AuditInfo.create(createdBy)
        );
    }
}

// Application Layer - Use Case
@Service
@Transactional
public class CreateCustomerUseCase {

    private final CustomerRepository customerRepository;

    public CreateCustomerUseCase(CustomerRepository customerRepository) {
        this.customerRepository = customerRepository;
    }

    public CustomerId execute(CreateCustomerCommand command) {
        var customer = Customer.create(
            new CompanyName(command.company()),
            new ContactName(command.contact()),
            new Email(command.email()),
            command.currentUserId()
        );
        customerRepository.save(customer);
        return customer.getId();
    }
}

// Presentation Layer - Controller
@RestController
@RequestMapping("/api/v1/customers")
public class CustomerController {

    private final CreateCustomerUseCase createCustomerUseCase;

    @PostMapping
    @ResponseStatus(HttpStatus.CREATED)
    public CreateCustomerResponse create(
            @Valid @RequestBody CreateCustomerRequest request,
            @AuthenticationPrincipal UserPrincipal principal) {
        var command = new CreateCustomerCommand(
            request.company(),
            request.contact(),
            request.email(),
            principal.getUserId()
        );
        var id = createCustomerUseCase.execute(command);
        return new CreateCustomerResponse(id.value());
    }
}

Activate Frontend Developer mode.

## API 規格
[貼上 Backend Agent 的 API 設計]

## 任務
請實作客戶管理的前端頁面：

1. 客戶列表頁（搜尋 + 分頁 + 篩選）
2. 新增客戶表單（驗證 + 送出）
3. 客戶詳情頁

## 技術棧
- Vue 3 + Composition API + TypeScript
- Tailwind CSS
- Pinia（狀態管理）
- Axios（HTTP Client）
- VueRouter

## 規範
- 元件需可重用
- 響應式設計（Mobile First）
- 需有 Loading / Error 狀態處理

Activate Reality Checker mode.

## 系統資訊
- CRM 系統的客戶管理模組
- Backend: Spring Boot 3.5 REST API
- Frontend: Vue 3 + TypeScript

## 需求規格
[貼上 PM Agent 的 User Story]

## 程式碼
[貼上 Backend + Frontend 的關鍵程式碼]

## 任務
請產出：
1. 測試計畫（Test Plan）
2. 測試案例（Test Cases）— 含正向/負向/邊界
3. API 測試腳本（JUnit 5）
4. E2E 測試腳本（Playwright）
5. 效能測試建議

Activate Security Engineer mode.

## 系統資訊
- CRM 系統（客戶關係管理）
- 包含敏感客戶資料（PII）
- 使用 JWT 認證 + RBAC

## 程式碼
[貼上所有關鍵程式碼]

## 架構
[貼上架構設計]

## 任務
請執行安全審查：
1. OWASP Top 10 檢查
2. 認證/授權機制審查
3. 資料保護（PII 處理）
4. API 安全（Rate Limiting / Input Validation）
5. 依賴項安全（已知 CVE）
6. 產出安全報告與修復建議

## 安全審查報告

### 🔴 高風險

| # | 問題 | 位置 | 建議修復 |
|---|------|------|---------|
| S-001 | SQL Injection 風險 | CustomerRepository | 使用參數化查詢 |
| S-002 | 缺少 Rate Limiting | CustomerController | 加入 @RateLimiter |

### 🟡 中風險

| # | 問題 | 位置 | 建議修復 |
|---|------|------|---------|
| S-003 | JWT Token 無過期設定 | SecurityConfig | 設定 expiration = 15min |
| S-004 | 缺少 CORS 設定 | WebConfig | 明確指定允許的 Origin |

### 🟢 建議改善

| # | 問題 | 建議 |
|---|------|------|
| S-005 | 缺少 Audit Log | 加入操作審計日誌 |
| S-006 | PII 未加密 | Email/Phone 使用欄位加密 |

Activate Agents Orchestrator mode.

## Mission
Conduct a full product discovery for a new spatial computing 
collaboration tool. Deploy all divisions simultaneously.

## Divisions & Assignments
1. Product: Market validation and competitive landscape
2. Engineering: Technical feasibility and architecture
3. Design: Brand identity and spatial UX
4. Marketing: Go-to-market strategy
5. Support: Support system design
6. Project Management: Execution timeline

## Deliverables
Each division produces a section of a unified product blueprint.
Coordinate to ensure consistency across all outputs.

Activate Security Engineer mode.

## 任務
針對以下需求進行安全需求分析：

### 功能需求
- 使用者登入（帳號密碼 + OAuth2）
- 客戶資料管理（含 PII）
- 檔案上傳功能

### 請產出
1. 安全需求清單（Security Requirements）
2. 資料分類（Public / Internal / Confidential / Restricted）
3. 合規要求（個資法 / GDPR 如適用）

Activate Security Engineer mode.

## 任務：STRIDE 威脅建模

### 系統元件
1. Web Frontend（Vue 3）
2. API Gateway
3. Backend Service（Spring Boot）
4. PostgreSQL Database
5. Redis Cache
6. Kafka MQ

### 請使用 STRIDE 方法進行威脅建模
- Spoofing（假冒）
- Tampering（竄改）
- Repudiation（否認）
- Information Disclosure（資訊洩漏）
- Denial of Service（阻斷服務）
- Elevation of Privilege（權限提升）

### 交付物
1. 威脅清單（含風險等級）
2. 對應緩解措施
3. 資料流程圖（DFD）

Activate Code Reviewer mode with security focus.

## 安全檢查清單
請檢查以下程式碼是否符合：

### OWASP Top 10 (2021)
- [ ] A01: Broken Access Control — 越權存取
- [ ] A02: Cryptographic Failures — 加密失敗
- [ ] A03: Injection — 注入攻擊（SQL / NoSQL / OS / LDAP）
- [ ] A04: Insecure Design — 不安全的設計
- [ ] A05: Security Misconfiguration — 安全設定錯誤
- [ ] A06: Vulnerable Components — 含有漏洞的元件
- [ ] A07: Authentication Failures — 身份驗證失敗
- [ ] A08: Data Integrity Failures — 資料完整性失敗
- [ ] A09: Logging Failures — 日誌與監控失敗
- [ ] A10: SSRF — 伺服器端請求偽造

[貼上程式碼]

Activate Security Engineer mode.

## 任務：安全測試計畫

### SAST（Static Application Security Testing）
請建議：
1. 適合 Java/Spring Boot 的 SAST 工具
2. 掃描規則設定
3. CI/CD 整合方式

### DAST（Dynamic Application Security Testing）
請建議：
1. API 安全測試（OWASP ZAP）
2. 測試案例設計
3. 自動化腳本

Activate Security Engineer mode.

## 合規需求
我們的 CRM 系統處理客戶 PII（個人識別資訊），需符合：
1. 台灣個人資料保護法
2. GDPR（如有歐盟客戶）

## 請提供
1. 資料處理合規檢查清單
2. 資料加密策略
3. 資料保留與刪除政策
4. 同意管理機制
5. 資料外洩通報流程

# .github/workflows/security.yml
name: Security Pipeline

on: [push, pull_request]

jobs:
  sast:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run SAST (SpotBugs + Find-Sec-Bugs)
        run: mvn spotbugs:check

  dependency-check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: OWASP Dependency Check
        run: mvn org.owasp:dependency-check-maven:check

  secret-scan:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: GitLeaks Secret Scan
        uses: gitleaks/gitleaks-action@v2

  container-scan:
    runs-on: ubuntu-latest
    needs: [sast, dependency-check]
    steps:
      - uses: actions/checkout@v4
      - name: Build Image
        run: docker build -t crm-api .
      - name: Trivy Container Scan
        uses: aquasecurity/trivy-action@master
        with:
          image-ref: 'crm-api'
          severity: 'HIGH,CRITICAL'

# 如果是 Fork 的專案
cd agency-agents

# 拉取上游最新版
git fetch upstream
git merge upstream/main

# 解決衝突（如有客製化的 Agent）
# 手動合併後提交

# 重新生成所有工具格式（含平行加速）
./scripts/convert.sh --parallel

# 重新安裝（自動偵測已安裝的工具）
./scripts/install.sh --no-interactive --parallel

# 重新生成所有工具格式（串行）
./scripts/convert.sh

# 重新生成所有工具格式（平行，推薦）
./scripts/convert.sh --parallel

# 僅重新生成特定工具
./scripts/convert.sh --tool cursor
./scripts/convert.sh --tool kimi

# 指定平行任務數
./scripts/convert.sh --parallel --jobs 8

# 使用 Git Tag 標記版本
git tag -a v1.0.0 -m "Initial agency-agents deployment"
git push origin v1.0.0

# 建立分支管理客製化
git checkout -b custom/our-agents
# 在此分支新增/修改 Agent

---
name: "Custom Backend Architect"
version: "2.1.0"
last_updated: "2026-04-22"
changelog:
  - "2.1.0: 新增 Redis 快取策略"
  - "2.0.0: 升級至 Spring Boot 3.5"
  - "1.0.0: 初始版本"
---

# 1. 確認目前版本
cd agency-agents
git log --oneline -5

# 2. 拉取上游更新
git fetch upstream
git log --oneline upstream/main..HEAD  # 查看差異

# 3. 建立升級分支
git checkout -b upgrade/$(date +%Y%m%d)

# 4. 合併上游
git merge upstream/main

# 5. 解決衝突（如有）
# 手動編輯衝突檔案，保留客製化內容

# 6. 重新生成整合檔案
./scripts/convert.sh --parallel

# 7. 重新安裝
./scripts/install.sh --no-interactive --parallel

# 8. 驗證
# 在 Claude Code 中測試常用 Agent

# 9. 合併到主分支
git checkout main
git merge upgrade/$(date +%Y%m%d)
git push origin main

agency-agents/
├── engineering/           # 上游 Agent（不修改）
├── design/                # 上游 Agent（不修改）
├── ...
├── custom/                # 🔧 客製 Agent（自行維護）
│   ├── enterprise/
│   │   ├── bank-backend-architect.md
│   │   ├── compliance-reviewer.md
│   │   └── internal-api-designer.md
│   └── team/
│       ├── onboarding-buddy.md
│       └── tech-debt-tracker.md
└── overrides/             # 🔧 覆寫上游 Agent（自行維護）
    └── engineering/
        └── backend-architect.md  # 加入企業特定規則

# overrides/engineering/backend-architect.md

---
name: "Backend Architect (Enterprise Override)"
extends: "engineering/backend-architect"
version: "1.0.0"
---

# 企業附加規則

## Additional Critical Rules（在上游規則之上新增）

1. 所有 API 必須通過公司 API Gateway
2. Database 連線必須使用 Connection Pool（HikariCP）
3. 日誌格式必須符合公司 ELK 標準
4. 所有外部呼叫必須有 Circuit Breaker
5. 敏感資料必須使用公司 KMS 加密

## 企業技術棧限制

| 類別 | 允許 | 禁止 |
|------|------|------|
| DB | Oracle 19c / PostgreSQL 16 | MySQL / MongoDB |
| Cache | Redis 7 | Memcached |
| MQ | Kafka 3.x | RocketMQ |
| HTTP Client | WebClient / RestClient | RestTemplate |
| JSON | Jackson | Gson |

# .github/workflows/sync-upstream.yml
name: Sync Upstream

on:
  schedule:
    - cron: '0 9 * * 1'  # 每週一早上 9 點
  workflow_dispatch:

jobs:
  sync:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      
      - name: Add upstream
        run: git remote add upstream https://github.com/msitarzewski/agency-agents.git
      
      - name: Fetch upstream
        run: git fetch upstream
      
      - name: Check for updates
        id: check
        run: |
          DIFF=$(git log --oneline main..upstream/main | wc -l)
          echo "updates=$DIFF" >> $GITHUB_OUTPUT
      
      - name: Create sync PR
        if: steps.check.outputs.updates > 0
        run: |
          git checkout -b upstream-sync/$(date +%Y%m%d)
          git merge upstream/main --no-edit || true
          git push origin upstream-sync/$(date +%Y%m%d)
          gh pr create \
            --title "Sync upstream $(date +%Y-%m-%d)" \
            --body "自動同步上游 agency-agents 更新" \
            --base main
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

## Agent 設計品質檢查

- [ ] Frontmatter 完整（name / description / emoji）
- [ ] Identity 具備獨特人設（非泛用模板）
- [ ] Core Mission 清晰明確
- [ ] Critical Rules 至少 3-5 條
- [ ] Technical Deliverables 包含程式碼範例
- [ ] Workflow 有明確步驟（至少 4 步）
- [ ] Success Metrics 可量化
- [ ] Communication Style 有描述

## Prompt 結構

### 1. 角色啟用
Activate [Agent Name] mode.

### 2. 背景提供
## Background
[提供系統背景、技術棧、限制條件]

### 3. 任務定義
## Task
[明確描述需要做什麼]

### 4. 輸入資料
## Input
[提供相關資料、程式碼、文件]

### 5. 產出要求
## Expected Output
[明確指定交付物格式]

### 6. 品質標準
## Quality Criteria
[定義什麼算「完成」]

## ❌ 不良 Prompt
"幫我寫一個好的 API"

## ✅ 改善後的 Prompt
Activate Backend Architect mode.

## Task
設計客戶管理 API endpoint。

## Requirements
- CRUD 操作（GET/POST/PUT/DELETE）
- 支援分頁（page + size）
- 支援關鍵字搜尋
- 回應使用統一格式：{ code, message, data, timestamp }

## Constraints
- Spring Boot 3.5 + Java 21
- 使用 Record 作為 DTO
- 遵循 RESTful 設計原則
- URL 使用複數名詞（/api/v1/customers）

## Output
1. Controller 程式碼
2. DTO 定義（Request + Response）
3. OpenAPI 文件片段

PM → Architect → Developer → Reviewer → QA → Security

              ┌─ Backend Dev ──┐
Architect ────┤                ├── Reviewer → QA
              └─ Frontend Dev ─┘

Developer → Reviewer → Developer → Reviewer → ...（直到通過）

同一問題 → Security + Performance + Architecture Agent → 綜合建議

Agents Orchestrator → 自動分派任務 → 收集各 Agent 產出 → 統一整合

## 入門課大綱

### Module 1: What is agency-agents?（30 min）
- 概念介紹
- Demo 展示
- 與傳統開發的差異

### Module 2: 快速上手（45 min）
- 安裝環境
- 啟用第一個 Agent
- Hands-on Lab：使用 Backend Architect 設計 API

### Module 3: 實務技巧（30 min）
- Prompt 撰寫技巧
- 常見問題排除
- Q&A

### Module 4: 團隊實踐（15 min）
- 團隊使用規範
- 溝通與回報管道

## agency-agents 團隊使用規範

### 允許的使用場景
✅ 程式碼生成（需人工審查後才能 commit）
✅ 程式碼審查輔助（最終判斷由人類負責）
✅ 架構設計參考（需經架構審查會議確認）
✅ 測試案例生成（需驗證測試品質）
✅ 文件撰寫輔助

### 禁止的使用場景
❌ 直接使用 Agent 產出而不審查
❌ 將敏感資料（密碼、金鑰）傳入 Agent
❌ 使用 Agent 繞過程式碼審查流程
❌ 未經授權修改生產環境設定

### 品質保證
- 所有 Agent 產出的程式碼必須通過 CI/CD
- 安全相關程式碼必須經 Security Agent + 人工雙重審查
- 架構決策必須經架構審查會議確認

### 成本管理
- 每月 Token 預算由部門主管審批
- 超出預算需提出說明
- 鼓勵重用已有的 Prompt 和產出

## agency-agents 月度報告 — 2026 年 4 月

### 效率指標
| 指標 | 本月 | 上月 | 趨勢 |
|------|------|------|------|
| 開發速度提升 | 35% | 28% | ⬆️ |
| 程式碼品質 | A | A | ➡️ |
| Bug 密度 | 1.2/KLOC | 1.8/KLOC | ⬆️ |
| 測試覆蓋率 | 82% | 75% | ⬆️ |
| 安全漏洞 | 0 Critical | 1 Critical | ⬆️ |

### 使用指標
| 指標 | 本月 |
|------|------|
| 使用人數 | 15/20 (75%) |
| 總 Token 使用 | 2.5M |
| 最常用 Agent | Backend Architect (45%) |
| Prompt 成功率 | 72% |

Activate Product Manager mode.

## Context
[專案背景與目標]

## Stakeholders
[利害關係人列表]

## Requirements
[高層級需求描述]

## Deliverables
Please produce:
1. User Stories with Acceptance Criteria
2. MoSCoW priority matrix
3. MVP scope definition
4. Non-functional requirements

Activate Backend Architect mode.

## Context
[系統背景、技術棧]

## Functional Requirements
[功能需求列表]

## Constraints
- Language: Java 21
- Framework: Spring Boot 3.5
- Architecture: Clean Architecture
- Database: [指定 DB]

## Deliverables
1. API endpoint list (RESTful)
2. Request/Response DTOs (Java Record)
3. Database Schema (DDL)
4. Error handling strategy
5. Authentication/Authorization design

Activate Code Reviewer mode.

## Context
This PR implements [功能描述].

## Code to Review
​```java
[貼上程式碼]
​```

## Review Focus
1. Security (OWASP Top 10)
2. Performance
3. Maintainability
4. Test coverage
5. Naming conventions

## Output Format
Please categorize findings as:
- 🔴 Critical (must fix before merge)
- 🟡 Warning (should fix)
- 🟢 Suggestion (nice to have)
- 💡 Learning (educational comment)

Activate Security Engineer mode.

## System Description
[系統描述、架構、資料流]

## Code/Config to Review
[貼上程式碼或設定]

## Review Scope
1. OWASP Top 10 compliance
2. Authentication & Authorization
3. Data protection (PII handling)
4. Input validation
5. Dependency vulnerabilities

## Output
- Security findings table (severity + description + remediation)
- Risk rating (Critical / High / Medium / Low)
- Compliance checklist

Activate Reality Checker mode.

## System Under Test
[系統描述、功能、API]

## Requirements
[需求/User Story]

## Test Scope
1. Unit tests (JUnit 5)
2. Integration tests
3. API tests
4. Edge cases
5. Error scenarios

## Tech Stack
- Java 21 + Spring Boot 3.5
- JUnit 5 + Mockito
- AssertJ
- Testcontainers (if needed)

## Deliverables
1. Test plan
2. Test cases (positive + negative + boundary)
3. Test code
4. Coverage target: > 80%

---
name: "[Agent Name]"
description: "[一句話描述]"
emoji: "[Emoji]"
color: "[HEX Color]"
services:
  - [service1]
  - [service2]
---

# [Emoji] [Agent Name]

## Identity & Memory

You are a [role description] with [X] years of experience in [domain].
Your approach is [characteristics]. You have learned through [experiences]
that [key insights].

Your communication style is [style description].

## Core Mission

[One paragraph describing the agent's primary purpose and goals]

## Critical Rules

1. [Rule 1 - most important constraint]
2. [Rule 2]
3. [Rule 3]
4. [Rule 4]
5. [Rule 5]

## Technical Deliverables

### [Deliverable Category 1]

​```[language]
[Code example]
​```

### [Deliverable Category 2]

[Another example or artifact]

## Workflow Process

1. **[Phase 1 Name]** → [Description]
2. **[Phase 2 Name]** → [Description]
3. **[Phase 3 Name]** → [Description]
4. **[Phase 4 Name]** → [Description]
5. **[Phase 5 Name]** → [Description]

## Success Metrics

- [Metric 1 with target]
- [Metric 2 with target]
- [Metric 3 with target]
- [Metric 4 with target]

## Communication Style

- [Style trait 1]
- [Style trait 2]
- [Style trait 3]

📁 企業 AI Agent 資源中心
├── 📁 培訓資料/
│   ├── 入門課程簡報.pptx
│   ├── 實戰課程手冊.pdf
│   └── Hands-on Lab 練習.md
├── 📁 Prompt 庫/
│   ├── backend-api-design.md
│   ├── code-review-checklist.md
│   ├── security-audit.md
│   └── test-generation.md
├── 📁 使用案例/
│   ├── 2026-Q1-專案A報告.md
│   └── 2026-Q2-專案B報告.md
├── 📁 規範文件/
│   ├── agent-usage-policy.md
│   ├── governance-framework.md
│   └── security-guidelines.md
└── 📁 月報/
    ├── 2026-04-agent-report.md
    └── 2026-05-agent-report.md