kenaz 0.0.0-stage → 0.3.2

package/core/.system/agent-skills/README.md

@@ -0,0 +1,724 @@
+# Agent Skills & Commands 系統 (.claude/)
+
+## 系統概述
+
+`.claude/` 是 Kenaz AI 專案的 **Agent 定義與指令系統**，提供完整的 AI Agent 管理框架，包含：
+
+- **Skills**：Agent 角色定義（職責、能力、工作流程）
+- **Commands**：斜線指令觸發機制（如 `/Ansuz`、`/產品`）
+- **Hooks**：Session 生命週期鉤子（自動初始化）
+- **Settings**：權限管理與配置
+- **MCP**：Model Context Protocol 整合（Cortex RAG 引擎）
+
+**設計理念**：
+- **Skills 定義 Agent**：每個 Agent 都有獨立的 SKILL.md 定義其行為
+- **Commands 觸發 Skills**：斜線指令讀取並載入對應的 Agent Skill
+- **Hooks 自動化初始化**：新 session 啟動時自動提示可用指令
+- **Settings 控制權限**：管理工具權限、目錄存取、Hook 配置
+
+---
+
+## 目錄結構
+
+```
+.claude/
+├── skills/                  # Agent 技能定義
+│   ├── product_manager/     # 產品經理（PRD、需求拆解）
+│   ├── designer/            # UI/UX 設計師
+│   ├── developer/           # 前端開發（React/TypeScript）
+│   ├── backend_engineer/    # 後端開發（Python/FastAPI）
+│   ├── qa_engineer/         # QA 測試
+│   ├── sre_agent/           # SRE 運維
+│   ├── dev_agent/           # Pipeline 協調（持續迭代）
+│   ├── sunny/               # 內部系統開發（特權模式）
+│   └── ...                  # 其他 Agent
+├── commands/                # 斜線指令定義
+│   ├── lead.md              # /lead - Formation Lead
+│   ├── 產品.md              # /產品 - Product Manager
+│   ├── 設計.md              # /設計 - Designer
+│   ├── dev.md               # /dev - Dev Agent
+│   ├── sunny.md             # /sunny - Sunny Agent
+│   └── ...                  # 其他指令
+├── hooks/                   # Session 生命週期鉤子
+│   └── session-init.ps1     # SessionStart Hook（顯示指令選單）
+├── prompts/                 # 提示模板（預留）
+├── mcp.json                 # MCP Server 配置（Cortex RAG）
+├── settings.json            # 全局設定（Hooks、權限）
+└── settings.local.json      # 本地設定（覆蓋 settings.json）
+```
+
+---
+
+## 1. Skills 系統
+
+### 1.1 Skill 定義格式
+
+每個 Agent 的 Skill 定義位於 `.claude/skills/<agent_name>/SKILL.md`，採用 **Markdown + YAML frontmatter** 格式：
+
+```markdown
+---
+name: agent_name
+aliases:
+  - 別名1
+  - 別名2
+description: 簡短描述 Agent 職責（一句話）
+---
+
+# Agent Name - 完整標題
+
+## 角色定位
+[描述 Agent 的角色、定位、核心職責]
+
+## 核心職責
+[列出主要職責清單]
+
+## 核心技能
+[列出技術技能、溝通技能等]
+
+## 工作流程
+[定義標準作業流程，通常包含多個 Phase]
+
+## 輸出規範
+[定義輸出格式、文件結構、命名規則]
+
+## 備註
+[其他補充說明]
+```
+
+### 1.2 YAML Frontmatter 規範
+
+| 字段 | 必填 | 說明 | 範例 |
+|------|------|------|------|
+| `name` | ✅ | Agent 唯一名稱（英文、底線） | `code_reviewer` |
+| `aliases` | ❌ | 別名列表（支援中文） | `["產品", "pm"]` |
+| `description` | ✅ | 簡短描述（顯示在指令列表） | `需求分析、陣型判斷、agent 調度` |
+
+**範例**：
+```yaml
+---
+name: code_reviewer
+description: Formation PM — 需求分析、陣型判斷、agent 調度、結果追蹤
+---
+```
+
+### 1.3 現有 Agent 列表
+
+| Agent | 路徑 | 職責 | 斜線指令 |
+|-------|------|------|----------|
+| **Product Manager** | `product_manager/` | 產品需求分析、PRD 撰寫、任務規劃 | `/產品` |
+| **Designer** | `designer/` | UI/UX 設計、設計規範、視覺稿 | `/設計` |
+| **Developer** | `developer/` | 前端開發 - React/TypeScript、UI 實現 | - |
+| **Backend Engineer** | `backend_engineer/` | 後端開發 - Python/FastAPI、API 設計 | `/後端` |
+| **QA Engineer** | `qa_engineer/` | 測試策略、缺陷追蹤、品質保證 | `/qa` |
+| **SRE Agent** | `sre_agent/` | Supabase 管理、部署、監控 | `/sre` |
+| **Dev Agent** | `dev_agent/` | Pipeline 協調、任務調度、持續迭代 | （無指令，由 Ansuz 派工） |
+| **Assessment Agent** | `assessment_agent/` | 功能/頁面/組件/API 評估、改良建議 | `/評估` |
+| **Architect Agent** | `architect_agent/` | 系統架構設計、技術選型、接口定義 | `/architect` |
+| **Sunny** | `sunny/` | 內部系統開發（特權模式） | `/sunny` |
+| **UI/UX Pro Max** | `ui-ux-pro-max/` | 設計系統生成、色彩/字體配對 | - |
+
+**外部安裝的 Skills**（位於 `.agents/skills/`，透過 `npx skills add` 安裝）：
+| Skill | 來源 | 說明 |
+|-------|------|------|
+| `vercel-react-best-practices` | Vercel Engineering | React/Next.js 效能優化指南（57 條規則） |
+| `supabase-postgres-best-practices` | Supabase | Postgres 效能優化與最佳實踐（8 類別規則） |
+
+### 1.4 Lead vs Worker Agent 模式
+
+Kenaz AI 的 Agent 系統採用 **Lead-Worker 分層架構**：
+
+#### Lead Agent（溝通者）
+- **職責**：理解需求、澄清問題、調度執行、匯報結果
+- **不執行**：實際開發工作
+- **工具**：Task 工具（調用 Team 或 Subagent）
+- **範例**：Product Manager, Designer, Developer（Frontend Lead）
+
+```
+用戶需求 → Lead Agent
+             ↓ 分析需求、澄清問題
+             ↓ 調度 Team/Subagent
+          Worker 執行實際工作
+             ↓ 返回結果
+          Lead 匯報給用戶
+```
+
+#### Worker Agent（執行者）
+- **職責**：接收明確任務、執行技術工作、返回結果
+- **工具**：Read, Write, Edit, Bash 等
+- **範例**：Formation 系統中的 solo/squad/legion 成員
+
+#### 混合 Agent（既溝通又執行）
+- **職責**：可直接執行任務，也可調度其他 Agent
+- **範例**：Dev Agent（既協調 Pipeline，也執行簡單任務）
+
+---
+
+## 2. Commands 系統
+
+### 2.1 Command 定義格式
+
+斜線指令位於 `.claude/commands/<指令名>.md`，定義**如何觸發對應的 Agent Skill**：
+
+```markdown
+# /<指令名> - 簡短描述
+
+正在讀取 <Agent 名稱> Agent...
+
+請按照以下步驟執行：
+
+1. **讀取 Agent Skill**：讀取 `.claude/skills/<agent_name>/SKILL.md` 內容並按照其框架執行。
+
+2. **執行特定職責**：
+   - [職責 1]
+   - [職責 2]
+   - [職責 3]
+
+請開始執行 [任務名稱]。
+```
+
+**範例**：`.claude/commands/產品.md`
+```markdown
+# /產品 - 產品需求分析
+
+正在讀取產品經理 Agent...
+
+請按照以下步驟執行：
+
+1. **讀取 Agent Skill**：讀取 `.claude/skills/product_manager/SKILL.md` 內容並按照其框架執行。
+
+2. **執行產品經理職責**：
+   - 深度理解用戶需求
+   - 進行需求分析
+   - 將需求拆解為開發任務
+   - 將任務寫入 Pipeline 系統
+
+請開始執行產品需求分析。
+```
+
+### 2.2 中英文混用支援
+
+Kenaz AI 支援**中英文混用指令**，同一個 Agent 可有多個指令名稱：
+
+| Agent | 中文指令 | 英文指令 | 說明 |
+|-------|---------|---------|------|
+| Product Manager | `/產品` | - | 產品需求分析 |
+| Designer | `/設計` | - | UI/UX 設計 |
+| Formation Lead | - | `/lead` | Formation PM |
+
+**實現方式**：建立多個 `.md` 檔案，內容完全相同（或使用符號連結）。
+
+### 2.3 現有指令列表
+
+| 指令 | Agent | 說明 |
+|-----|-------|------|
+| `/產品` | Product Manager | 需求分析、任務規劃、PRD 撰寫 |
+| `/設計` | Designer | UI/UX 設計、設計規範、視覺稿 |
+| `/評估` | Assessment Agent | 功能/頁面/組件/API 深度評估 |
+| `/後端` | Backend Engineer | API 設計、資料庫、Python |
+| `/qa` | QA Engineer | 測試策略、缺陷追蹤、品質保證 |
+| `/sre` | SRE Agent | Supabase 管理、部署、監控 |
+| `/進度` | - | 查看 `dev/pipeline/PROGRESS.md` |
+| `/產品檢視`, `/product-review` | Product Manager | 自動化專案檢視模式（供排程使用） |
+| `/init` | - | 初始化新專案（清理 Pipeline、重置狀態） |
+| `/lead` | Formation Lead | Formation PM - 需求分析、陣型調度 |
+| `/sunny` | Sunny | 內部系統開發（特權模式） |
+| `/agent-worker` | - | 多 Agent Worker 模式（由排程器呼叫） |
+| `/architect` | Architect Agent | 系統架構設計 |
+| `/spec` | Spec Optimizer | 規格優化與文件整理 |
+| `/strategy` | Strategy Team | 策略智庫團隊 |
+| `/archive` | - | 封存已完成任務到記憶點 |
+
+---
+
+## 3. Hooks 系統
+
+### 3.1 SessionStart Hook
+
+**目的**：在新 session 啟動時，自動提示用戶可用的 Agent 指令。
+
+**實現**：`.claude/hooks/session-init.ps1`（PowerShell 腳本）
+
+```powershell
+# Session Start Hook - 顯示 Command 選擇菜單
+# 當新 session 啟動時，提示 Claude 顯示可用的 Agent 指令供用戶選擇
+
+param()
+
+# 讀取 stdin 獲取 session 資訊
+$input = [Console]::In.ReadToEnd()
+$sessionInfo = $input | ConvertFrom-Json -ErrorAction SilentlyContinue
+
+# 檢查是否是新啟動（不是 resume）
+$source = $sessionInfo.source
+if ($source -eq "startup" -or $source -eq "clear") {
+    # 返回 additionalContext，觸發 Claude 顯示選擇菜單
+    $context = @{
+        hookSpecificOutput = @{
+            hookEventName = "SessionStart"
+            additionalContext = @"
+[SESSION_INIT_TRIGGER]
+新 session 已啟動。請立即使用 AskUserQuestion 工具向用戶展示 Agent 選擇菜單。
+"@
+        }
+    } | ConvertTo-Json -Depth 10 -Compress
+
+    Write-Output $context
+}
+
+exit 0
+```
+
+### 3.2 Hook 配置
+
+在 `settings.json` 中配置 Hook：
+
+```json
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "powershell -ExecutionPolicy Bypass -File \"$CLAUDE_PROJECT_DIR/.claude/hooks/session-init.ps1\"",
+            "statusMessage": "Initializing session..."
+          }
+        ]
+      },
+      {
+        "matcher": "clear",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "powershell -ExecutionPolicy Bypass -File \"$CLAUDE_PROJECT_DIR/.claude/hooks/session-init.ps1\"",
+            "statusMessage": "Initializing session..."
+          }
+        ]
+      }
+    ]
+  },
+  "disableAllHooks": false
+}
+```
+
+**可用的 matcher**：
+- `startup`：新 session 啟動時
+- `clear`：使用者執行 `/clear` 後
+- `all`：所有情況
+
+**Hook 類型**：
+- `command`：執行系統指令（如 PowerShell 腳本）
+- 其他類型（未來擴展）
+
+### 3.3 停用 Hooks
+
+若需暫時停用 Hooks：
+
+```json
+{
+  "disableAllHooks": true
+}
+```
+
+---
+
+## 4. Settings 系統
+
+### 4.1 settings.json（全局設定）
+
+位於 `.claude/settings.json`，定義**專案級別的權限與配置**：
+
+```json
+{
+  "env": {
+    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
+  },
+  "permissions": {
+    "allow": [
+      "Bash(指令模式1)",
+      "Bash(指令模式2)"
+    ],
+    "additionalDirectories": [
+      "路徑1",
+      "路徑2"
+    ]
+  },
+  "hooks": {
+    "SessionStart": [...]
+  },
+  "disableAllHooks": false
+}
+```
+
+#### 字段說明
+
+| 字段 | 說明 | 範例 |
+|------|------|------|
+| `env` | 環境變數 | 啟用實驗性功能 |
+| `permissions.allow` | 預先批准的 Bash 指令模式 | 允許特定批次操作 |
+| `permissions.additionalDirectories` | 額外允許存取的目錄 | 允許讀寫 Formation 目錄 |
+| `hooks` | Session 生命週期鉤子 | SessionStart 自動初始化 |
+| `disableAllHooks` | 停用所有 Hooks | `true` / `false` |
+
+### 4.2 settings.local.json（本地設定）
+
+位於 `.claude/settings.local.json`，**覆蓋** `settings.json` 的設定。
+
+**用途**：
+- 本地開發環境專用設定
+- 不應提交到 Git（已加入 `.gitignore`）
+- 個人化權限配置
+
+**合併策略**：`settings.local.json` 的值優先於 `settings.json`。
+
+---
+
+## 5. MCP 整合（Cortex RAG）
+
+### 5.1 mcp.json 配置
+
+位於 `.claude/mcp.json`，定義 **Model Context Protocol Server** 的連接方式。
+
+Kenaz AI 使用 MCP 整合 **kenaz-cortex** RAG 引擎，提供語義代碼搜索能力。
+
+```json
+{
+  "mcpServers": {
+    "kenaz-cortex": {
+      "command": "C:/Users/Wei/AppData/Local/Microsoft/WindowsApps/PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0/python.exe",
+      "args": ["-m", "cortex.mcp.server"],
+      "env": {
+        "PYTHONPATH": "C:/Users/Wei/Desktop/Project/KenazAI/kenaz-cortex/src"
+      }
+    }
+  }
+}
+```
+
+**字段說明**：
+- `command`：Python 可執行檔路徑（需使用絕對路徑）
+- `args`：啟動參數（`-m cortex.mcp.server` 表示執行 MCP Server 模組）
+- `env.PYTHONPATH`：Python 模組搜尋路徑（指向 kenaz-cortex 源碼）
+
+### 5.2 可用的 MCP 工具
+
+當 `mcp.json` 配置正確，Claude Code 會自動載入以下 Cortex 工具：
+
+| 工具 | 用途 | 使用時機 |
+|------|------|---------|
+| `cortex_search` | 語義代碼搜索 | 「這個功能怎麼運作？」「有類似實現嗎？」 |
+| `cortex_context` | 專案結構 Context（自動切換全量/RAG） | 「專案結構長什麼樣？」 |
+| `cortex_file_chunks` | 文件切片查詢 | 查詢大型文件的特定部分 |
+| `cortex_symbols` | 符號檢索（函數、類） | 「這個函數在哪裡定義？」 |
+| `cortex_status` | RAG 引擎狀態 | 檢查索引狀態、資料庫連接 |
+
+**智能切換策略**：
+- 小型專案（<40k tokens, <20 files）→ `cortex_context` 返回全量 Context
+- 大型專案（>40k tokens 或 >20 files）→ `cortex_context` 使用 RAG 模式
+
+### 5.3 設置 MCP Server
+
+```powershell
+# 設置 MCP Server（讓 Claude Code 自動使用 RAG）
+.\dev\scripts\setup_mcp.ps1
+```
+
+詳細文檔：請參閱 `CLAUDE.md#MCP Server 設置`。
+
+---
+
+## 6. 新增 Agent 指南
+
+### 6.1 完整步驟
+
+#### Step 1: 建立 Skill 定義
+
+在 `.claude/skills/<agent_name>/` 建立 `SKILL.md`：
+
+```markdown
+---
+name: my_agent
+aliases:
+  - 我的代理
+  - my-agent
+description: 簡短描述 Agent 職責
+---
+
+# My Agent
+
+## 角色定位
+[描述角色]
+
+## 核心職責
+[列出職責]
+
+## 工作流程
+### Phase 1: [階段名稱]
+[步驟描述]
+
+### Phase 2: [階段名稱]
+[步驟描述]
+```
+
+#### Step 2: 建立斜線指令
+
+在 `.claude/commands/<指令名>.md` 建立指令檔：
+
+```markdown
+# /<指令名> - 簡短描述
+
+正在讀取 <Agent 名稱> Agent...
+
+請按照以下步驟執行：
+
+1. **讀取 Agent Skill**：讀取 `.claude/skills/<agent_name>/SKILL.md` 內容並按照其框架執行。
+
+2. **執行特定職責**：
+   - [職責 1]
+   - [職責 2]
+
+請開始執行 [任務名稱]。
+```
+
+**支援中文指令**：建立多個 `.md` 檔案指向同一個 Skill（如 `開發.md` 和 `dev.md`）。
+
+#### Step 3: 更新 CLAUDE.md
+
+在 `CLAUDE.md` 的 **Agent 系統表格** 中註冊新 Agent：
+
+```markdown
+| Agent | Skill 路徑 | 職責 |
+|-------|-----------|------|
+| My Agent | `.claude/skills/my_agent/SKILL.md` | 簡短描述 |
+```
+
+在 **指令集表格** 中註冊新指令：
+
+```markdown
+| 指令 | Agent | 說明 |
+|-----|-------|------|
+| `/my-cmd` | My Agent | 簡短描述 |
+```
+
+#### Step 4: 更新 Session Init Hook（可選）
+
+若希望在 Session 啟動時顯示新 Agent，更新 `.claude/hooks/session-init.ps1` 中的選單。
+
+#### Step 5: 測試 Agent
+
+在 Claude Code 中輸入 `/<指令名>` 測試載入是否正常。
+
+### 6.2 命名規範
+
+| 元素 | 規範 | 範例 |
+|------|------|------|
+| **Agent Name** | 英文、底線分隔、小寫 | `my_agent`, `backend_engineer` |
+| **Skill 目錄** | 與 Agent Name 同名 | `.claude/skills/my_agent/` |
+| **Command 檔案** | 英文或中文、可使用連字符 | `my-cmd.md`, `我的指令.md` |
+| **Skill 檔名** | 固定使用 `SKILL.md`（大寫） | `SKILL.md` |
+
+### 6.3 最佳實踐
+
+#### DO ✅
+- **明確角色定位**：清楚定義 Agent 是 Lead、Worker 還是混合型
+- **結構化工作流程**：使用 Phase 1/2/3 清楚劃分階段
+- **輸出規範具體**：明確定義檔案格式、命名規則、存放位置
+- **使用 YAML frontmatter**：方便未來擴展自動化功能
+- **遵循現有風格**：參考現有 Agent 的文檔結構
+
+#### DON'T ❌
+- **避免職責重疊**：確保新 Agent 與現有 Agent 職責清晰分離
+- **避免過度複雜**：工作流程不超過 5 個 Phase
+- **避免硬編碼路徑**：使用相對路徑或環境變數
+- **避免直接執行敏感操作**：涉及 Git、部署等應有用戶確認機制
+
+---
+
+## 7. Agent 載入機制
+
+### 7.1 載入流程
+
+```
+用戶輸入 /<指令名>
+    ↓
+Claude Code 查找 .claude/commands/<指令名>.md
+    ↓
+讀取 Command 內容（包含「讀取 .claude/skills/<agent_name>/SKILL.md」）
+    ↓
+載入 SKILL.md 的完整內容
+    ↓
+Claude 按照 SKILL.md 定義的工作流程執行
+```
+
+### 7.2 自動初始化行為
+
+當用戶在新 Session 中**未使用斜線指令**時，Session Hook 會自動觸發 **AskUserQuestion** 顯示選單：
+
+```
+[SESSION_INIT_TRIGGER]
+新 session 已啟動。請立即使用 AskUserQuestion 工具向用戶展示 Agent 選擇菜單。
+
+可用的 Agent 指令：
+- /產品 - 需求分析、任務規劃、PRD 撰寫
+- /設計 - UI/UX 設計、設計規範、視覺稿
+- /architect - 系統架構設計
+...
+```
+
+用戶選擇後，自動調用對應的 Skill 工具載入 Agent。
+
+### 7.3 判斷規則
+
+- **用戶輸入以 `/` 開頭** → 直接執行該指令，不詢問
+- **用戶輸入其他內容** → 先顯示選擇菜單，再處理用戶訊息
+
+---
+
+## 8. 與其他系統的關係
+
+### 8.1 規則優先級
+
+當規則發生衝突時，按以下優先級順序執行：
+
+```
+1. .rule/*           ← 最高優先級（所有人必須遵守）
+2. CLAUDE.md         ← 專案級指令與工作流程
+3. .claude/skills/   ← Agent 行為定義
+4. .agents/skills/   ← 外部安裝的最佳實踐
+```
+
+### 8.2 與 Formation 系統的關係
+
+- **Formation 系統**（`.formation/`）：提供多 Agent 協作調度機制（unit/solo/squad/legion）
+- **Skills 系統**（`.claude/skills/`）：定義 Agent 的行為與能力
+- **整合方式**：Formation Lead 調度時，會讀取對應 Agent 的 Skill 定義
+
+**範例**：
+```
+         ↓
+    Formation Lead 分析需求
+         ↓
+    dispatch squad 陣型（調用 developer, backend_engineer）
+         ↓
+    這些 Agent 執行時，會遵循各自的 SKILL.md
+```
+
+### 8.3 與 Collaboration 任務系統的關係
+
+- **Collaboration 系統**（`.collaboration/`）：提供任務管理 API（建立、認領、完成任務）
+- **Skills 系統**（`.claude/skills/`）：定義 Agent 如何執行任務
+- **整合方式**：許多 Agent（如 Formation Lead）強制要求透過 Collaboration API 管理任務
+
+**範例**（Formation Lead 的任務流程）：
+```
+1. node .collaboration/core/task-api.js create ...   # 建立任務
+2. node .collaboration/core/task-api.js claim TASK_XXX  # 認領任務
+3. dispatch agent 執行任務
+4. node .collaboration/core/task-api.js complete TASK_XXX  # 完成任務
+```
+
+---
+
+## 9. 常見問題
+
+### Q1: 如何讓 Agent 支援中英文雙語指令？
+
+**A**：建立兩個 Command 檔案指向同一個 Skill：
+
+```bash
+# 建立英文指令
+echo '讀取並遵循 `.claude/skills/my_agent/SKILL.md` 中的指示。' > .claude/commands/my-cmd.md
+
+# 建立中文指令（內容相同）
+echo '讀取並遵循 `.claude/skills/my_agent/SKILL.md` 中的指示。' > .claude/commands/我的指令.md
+```
+
+### Q2: 如何停用 SessionStart Hook？
+
+**A**：修改 `.claude/settings.json`：
+
+```json
+{
+  "disableAllHooks": true
+}
+```
+
+或移除 `hooks` 區塊。
+
+### Q3: 如何讓 Agent 自動使用 Cortex RAG？
+
+**A**：在 Agent 的 SKILL.md 中加入指示：
+
+```markdown
+## 核心技能
+
+* **語義搜尋**：使用 Cortex MCP 工具（cortex_search, cortex_symbols）進行代碼檢索
+```
+
+並確保 `mcp.json` 已正確配置（執行 `.\dev\scripts\setup_mcp.ps1`）。
+
+### Q4: Command 檔案可以包含複雜邏輯嗎？
+
+**A**：**不建議**。Command 檔案應保持簡潔，只負責「觸發載入 Skill」。複雜邏輯應寫在 SKILL.md 中。
+
+**範例**（簡潔 Command）：
+```markdown
+# /dev - Pipeline 分段開發模式
+
+正在讀取開發協調 Agent...
+
+請按照以下步驟執行：
+
+1. **讀取 Agent Skill**：讀取 `.claude/skills/dev_agent/SKILL.md` 內容並按照其框架執行。
+2. **讀取當前進度**：讀取 `dev/pipeline/PROGRESS.md` 確認當前狀態。
+3. **執行 Pipeline 流程**：[簡短步驟清單]
+
+請開始執行 Pipeline 開發迭代。
+```
+
+### Q5: 外部 Skills（.agents/skills/）與內部 Skills（.claude/skills/）有何差異？
+
+**A**：
+
+| 特性 | 內部 Skills | 外部 Skills |
+|------|------------|------------|
+| **位置** | `.claude/skills/` | `.agents/skills/` |
+| **來源** | 專案自定義 | 透過 `npx skills add` 安裝 |
+| **用途** | Kenaz AI 專案特定的 Agent | 通用最佳實踐（如 Vercel React 規則） |
+| **優先級** | 較高（規則優先級第 3 位） | 較低（規則優先級第 4 位） |
+| **可編輯** | ✅ 可自由修改 | ⚠️ 不建議修改（會被覆蓋） |
+
+---
+
+## 10. 參考資料
+
+### 10.1 相關文檔
+
+| 文檔 | 路徑 | 說明 |
+|------|------|------|
+| **專案指引** | `CLAUDE.md` | 專案級指令、工作流程、Agent 列表 |
+| **規則系統** | `.system/rule/README.md` | 規則定義、優先級、嚴重程度 |
+| **失敗學習系統** | `.system/failure/README.md` | 失敗模式記錄與預防措施 |
+| **Collaboration 系統** | `.system/collaboration/README.md` | 任務管理 API 與目錄結構 |
+| **Formation 系統** | `.system/formation/README.md` | 多 Agent 協作陣型調度 |
+| **Sunny Agent** | `.system/sunny/README.md` | 內部系統開發特權模式 |
+| **記憶系統** | `.system/memory/README.md` | 經驗記錄與知識沉澱 |
+
+### 10.2 工具腳本
+
+| 工具 | 路徑 | 用途 |
+|------|------|------|
+| `setup_mcp.ps1` | `dev/scripts/` | 設置 MCP Server（Cortex RAG） |
+| `task-api.js` | `.collaboration/core/` | 任務管理 CLI（建立、認領、完成） |
+| `check_failures.ps1` | `.failure/tools/` | 檢查相關失敗模式 |
+
+### 10.3 官方文檔
+
+- **Claude Code 官方文檔**：[claude.ai/code](https://claude.ai/code)
+- **MCP Protocol**：[Model Context Protocol](https://modelcontextprotocol.io/)
+- **YAML 規範**：[YAML 1.2 Spec](https://yaml.org/spec/1.2/spec.html)
+
+---
+
+*建立日期: 2026-02-19 | 版本: 1.0.0*