kenaz 0.3.18 → 0.3.20

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

@@ -1,724 +0,0 @@
-# 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*