kenaz 0.3.18 → 0.3.19

package/core/.system/formation/LEGACY_SKILLS.md

@@ -1,974 +0,0 @@
-# Formation Legacy Skills - 全角色定義
-
-> **[RETIRED 2026-10, TASK_2401/2402/2403]** 本文描述已退役的 headless / legacy-scheduler Formation，僅留作歷史參考。現行路徑：`node .formation/tools/dispatch.js --skill=do --task=TASK_XXX --dispatch-mode=subagent`（見 `.formation/README.md`）。
-
-> **專案位置**: `.formation/legacy/`
-> **系統類型**: Formation Legacy 陣型專用 Skills
-> **適用場景**: Legacy Scheduler 自動調度、Formation Lead 任務分派
-
----
-
-## 📋 系統概述
-
-**Formation Legacy Skills** 是 Formation 系統中 **Legacy 陣型** 使用的角色定義 YAML 檔案。這些 Skills 為 **Formation Lead（Scheduler）** 提供統一的 Agent 調度介面，支援自動化開發流程。
-
-### 核心理念
-
-**「Formation = Lead + Skill + Task」**
-
-- **Formation Lead**（Scheduler）負責任務選擇、調度、post-complete（archive + git）
-- **Skill**（角色定義）負責定義 Agent 的行為規範、輸入輸出、workflow 步驟
-- **Task**（任務定義）負責描述具體的需求、範圍、驗收標準
-
-Legacy Scheduler 根據任務的 `role` 欄位，從 `role_skill_map` 找到對應的 Skill 檔案，使用 Formation 系統派出 subagent 執行任務。
-
----
-
-## 🎯 與 CLAUDE.md Skills 的差異
-
-| 特性 | `.claude/skills/` | `.formation/legacy/` |
-|------|------------------|---------------------|
-| **調用方式** | 使用者手動執行 `/指令` | Formation Lead 自動調度 |
-| **溝通模式** | 互動式（可提問、可回報） | 無頭模式（不提問、直接執行） |
-| **Git 權限** | ✅ 允許（Lead Agent） | ❌ 禁止（由 Lead 統一管理） |
-| **工作流程** | 完整 12 步 Pipeline 流程 | 專注單一任務執行 |
-| **適用場景** | 用戶在場、需要交互 | 用戶離線、自動化排程 |
-| **定義格式** | Markdown (SKILL.md) | YAML (skill.yaml) |
-
-**關鍵行為差異**：
-
-```yaml
-# CLAUDE.md Skill（如 /開發）
-- 分析任務、拆解子任務
-- 展示計劃給用戶
-- 等待用戶確認
-- 執行開發
-- 建立 commit、merge branch
-
-# Formation Legacy Skill（如 developer.yaml）
-- 讀取任務（task-api.js get）
-- 認領任務（task-api.js claim）
-- 執行開發（根據 scope_paths + requirements）
-- 完成任務（task-api.js complete）
-- 禁止 git 操作（Rule 5：由 Lead 統一管理）
-```
-
----
-
-## 📁 目錄結構
-
-```
-.formation/legacy/
-├── scheduler.yaml    # Scheduler 配置（核心）
-├── developer.yaml    # 泛用開發者
-├── frontend.yaml     # 前端開發
-├── backend.yaml      # 後端開發
-├── designer.yaml     # UI/UX 設計
-├── pm.yaml           # 產品經理
-├── qa.yaml           # 測試工程師
-├── sre.yaml          # SRE 工程師
-└── review.yaml       # 專案檢視（self-enhancement）
-```
-
----
-
-## 🔧 ROLE_SKILL_MAP（角色對應表）
-
-Formation Legacy Scheduler 根據任務的 `role` 欄位，從以下對應表找到 Skill 檔案：
-
-```yaml
-# 定義於 .formation/legacy/scheduler.yaml
-formation_dispatch:
-  role_skill_map:
-    developer: developer         # 泛用開發
-    frontend: frontend           # 前端開發
-    backend: backend             # 後端開發
-    designer: designer           # UI/UX 設計
-    qa: qa                       # 測試工程師
-    qa_engineer: qa              # 測試工程師（別名）
-    sre: sre                     # SRE 工程師
-    pm: pm                       # 產品經理
-    product_manager: pm          # 產品經理（別名）
-    lead: lead                   # Lead-only 任務（Scheduler 自己處理）
-  default_skill: developer       # 未匹配時的預設 Skill
-  review_skill: review           # Self-enhancement 專用
-```
-
-**範例**：
-
-```yaml
-# 任務定義（TASK_172.yaml）
-id: TASK_172
-role: frontend  # ← 會對應到 frontend.yaml
-
-# Scheduler 調度流程
-1. 讀取 TASK_172.yaml，取得 role: frontend
-2. 從 role_skill_map 找到 frontend → frontend.yaml
-3. 使用 Formation 系統派出 subagent：
-   node .formation/tools/headless.js \
-     --skill=frontend \
-     --task=TASK_172 \
-     --formation=legacy
-```
-
----
-
-## 🧑‍💻 角色定義（8 個 Legacy Skills）
-
-### 1. developer.yaml（泛用開發者）
-
-**適用任務**：不限前後端的開發工作（代碼實作、文檔撰寫、工具腳本）
-
-#### YAML 結構
-
-```yaml
-skill: developer
-formation: legacy
-version: "1.0"
-
-name: Developer
-description: 泛用開發者。根據任務需求讀取 codebase、實作變更。不限前後端。Git 由 Formation Lead 管理。
-
-role:
-  identity: |
-    你是開發者。根據任務的 scope_paths 和 requirements 來判斷需要做什麼。
-    可能是前端、後端、工具腳本、文檔、設定檔 — 任何開發工作都在你的職責內。
-    遵循專案現有的風格和結構。
-  priority: 準確完成任務需求，產出可用的變更。
-
-input:
-  required:
-    - task: 任務 ID 或具體描述
-  optional:
-    - scope: 修改範圍
-
-output:
-  primary: 符合任務需求的程式碼或文檔變更
-  secondary: 完成摘要（變更檔案、需注意的事項）
-
-behavior:
-  - 先讀任務的 scope_paths 和 requirements，理解範圍再動手
-  - 遵循 codebase 的命名慣例和目錄結構
-  - 只改必要的部分，不順便重構
-  - 完成後使用 task-api.js complete 標記任務完成
-  - 禁止執行任何 git 操作（commit、branch、merge）— Git 由 Formation Lead 統一管理
-  - 如果任務涉及多個領域，逐一處理，不跳過
-
-collaboration:
-  task_api: node .collaboration/core/task-api.js
-
-  workflow:
-    - step: 讀取任務
-      run: node .collaboration/core/task-api.js get {task_id}
-      note: 取得 scope_paths、requirements、acceptance_criteria
-
-    - step: 認領任務
-      run: node .collaboration/core/task-api.js claim {task_id}
-
-    - step: 執行開發
-      actions:
-        - 根據 scope_paths 讀取相關檔案
-        - 根據 requirements 逐一實作
-        - 根據 acceptance_criteria 驗證成果
-        - 注意：禁止 git 操作，由 Formation Lead 統一管理
-
-    - step: 完成任務
-      run: node .collaboration/core/task-api.js complete {task_id}
-
-  on_blocked:
-    run: node .collaboration/core/task-api.js move {task_id} blocked
-```
-
-#### 使用範例
-
-```bash
-# 由 Formation Lead 自動調度
-# 任務定義：TASK_172.yaml，role: developer
-
-# Scheduler 內部呼叫：
-node .formation/tools/headless.js \
-  --skill=developer \
-  --task=TASK_172 \
-  --formation=legacy
-```
-
----
-
-### 2. frontend.yaml（前端開發）
-
-**適用任務**：React/TypeScript 組件實作、UI 整合、樣式調整
-
-#### YAML 結構
-
-```yaml
-skill: frontend
-formation: legacy
-version: "1.0"
-
-name: Frontend Developer
-description: 前端開發。React/TypeScript、組件實作、UI 整合、樣式調整。
-
-role:
-  identity: |
-    你是前端開發者。用 React + TypeScript 實作 UI 組件、頁面、互動邏輯。
-    遵循專案現有的設計系統和元件結構。
-  priority: 產出可用的前端變更，遵循 codebase 現有風格。
-
-input:
-  required:
-    - task: 任務 ID 或具體描述
-  optional:
-    - scope: 修改範圍（組件路徑）
-    - design_spec: 設計規範參考
-
-output:
-  primary: React/TypeScript 組件或頁面變更
-  secondary: 完成摘要（變更檔案、需注意的事項）
-
-behavior:
-  - 先讀現有組件結構，理解設計系統再動手
-  - 遵循 codebase 的命名慣例和目錄結構
-  - 使用現有的 UI 元件庫，不引入新依賴
-  - 確保 RWD 和無障礙基本要求
-  - 只改必要的部分，不順便重構
-
-collaboration:
-  task_api: node .collaboration/core/task-api.js
-
-  workflow:
-    - step: 讀取任務
-      run: node .collaboration/core/task-api.js get {task_id}
-      note: 取得 scope_paths、requirements、acceptance_criteria
-
-    - step: 認領任務
-      run: node .collaboration/core/task-api.js claim {task_id}
-
-    - step: 執行開發
-      actions:
-        - 根據 scope_paths 讀取相關組件
-        - 根據 requirements 逐一實作
-        - 根據 acceptance_criteria 驗證成果
-        - 注意：禁止 git 操作，由 Formation Lead 統一管理
-
-    - step: 完成任務
-      run: node .collaboration/core/task-api.js complete {task_id}
-
-  on_blocked:
-    run: node .collaboration/core/task-api.js move {task_id} blocked
-```
-
-#### 關鍵特性
-
-- **設計系統優先**：先讀現有組件結構，不引入新依賴
-- **RWD + 無障礙**：基本要求，不需過度工程
-- **風格一致**：遵循 codebase 現有慣例
-
----
-
-### 3. backend.yaml（後端開發）
-
-**適用任務**：API 設計、資料庫 Schema、Python/FastAPI、業務邏輯
-
-#### YAML 結構
-
-```yaml
-skill: backend
-formation: legacy
-version: "1.0"
-
-name: Backend Engineer
-description: 後端開發。API 設計、資料庫 Schema、Python/FastAPI、業務邏輯。
-
-role:
-  identity: |
-    你是後端工程師。設計並實作 API、資料庫 Schema、後端業務邏輯。
-    注重安全性、效能和 API 設計規範。
-  priority: 產出安全可靠的後端實作，API 介面清晰。
-
-input:
-  required:
-    - task: 任務 ID 或具體描述
-  optional:
-    - scope: 修改範圍（API 路徑或模組）
-    - api_spec: API 規格參考
-
-output:
-  primary: API 端點、資料庫 Migration、後端邏輯
-  secondary: API 文檔更新、測試用例
-
-behavior:
-  - 先檢查現有 API 結構和資料模型
-  - 設計 RESTful API，遵循現有命名慣例
-  - 確保輸入驗證和錯誤處理
-  - 注意 SQL injection、XSS 等安全問題
-  - 有 RLS 策略的要確認安全政策正確
-
-collaboration:
-  task_api: node .collaboration/core/task-api.js
-
-  workflow:
-    - step: 讀取任務
-      run: node .collaboration/core/task-api.js get {task_id}
-
-    - step: 認領任務
-      run: node .collaboration/core/task-api.js claim {task_id}
-
-    - step: 執行開發
-      actions:
-        - 分析現有 API 和資料模型
-        - 設計或修改 Schema
-        - 實作 API 端點和業務邏輯
-        - 注意：禁止 git 操作，由 Formation Lead 統一管理
-
-    - step: 完成任務
-      run: node .collaboration/core/task-api.js complete {task_id}
-
-  on_blocked:
-    run: node .collaboration/core/task-api.js move {task_id} blocked
-```
-
-#### 安全性要求
-
-- **輸入驗證**：所有 API 端點必須驗證輸入
-- **錯誤處理**：統一錯誤回應格式
-- **安全性**：防止 SQL injection、XSS、CSRF
-- **RLS 策略**：確認 Row-Level Security 正確配置
-
----
-
-### 4. designer.yaml（UI/UX 設計）
-
-**適用任務**：設計規範撰寫、視覺稿、互動設計、設計系統維護
-
-#### YAML 結構
-
-```yaml
-skill: designer
-formation: legacy
-version: "1.0"
-
-name: Designer
-description: UI/UX 設計。設計規範、視覺稿、互動設計、設計系統維護。
-
-role:
-  identity: |
-    你是 UI/UX 設計師。產出設計規範、組件規格、視覺風格定義。
-    以用戶體驗為核心，確保設計的一致性和可實現性。
-  priority: 產出可執行的設計規範，而非抽象概念。
-
-input:
-  required:
-    - task: 任務 ID 或設計需求描述
-  optional:
-    - context: 現有設計系統或品牌指南
-    - target: 目標頁面或組件
-
-output:
-  primary: 設計規範文件（DESIGN_SPEC.md）或組件規格
-  secondary: 設計決策記錄、參考資料
-
-behavior:
-  - 先了解現有設計系統和視覺風格
-  - 設計規範要具體到可以直接實作（顏色值、間距、字體大小）
-  - 考慮 RWD 和無障礙
-  - 與現有元件庫一致
-  - 產出 Markdown 格式的規範文件
-
-collaboration:
-  task_api: node .collaboration/core/task-api.js
-
-  workflow:
-    - step: 讀取任務
-      run: node .collaboration/core/task-api.js get {task_id}
-
-    - step: 認領任務
-      run: node .collaboration/core/task-api.js claim {task_id}
-
-    - step: 設計分析
-      actions:
-        - 檢查現有設計系統
-        - 分析需求與用戶場景
-        - 產出設計規範或視覺稿
-
-    - step: 完成任務
-      run: node .collaboration/core/task-api.js complete {task_id}
-
-  on_blocked:
-    run: node .collaboration/core/task-api.js move {task_id} blocked
-```
-
-#### 設計輸出規範
-
-**設計規範必須包含**：
-- **顏色值**：Hex 或 RGB（如 `#3B82F6`）
-- **間距值**：具體數值（如 `16px`, `2rem`）
-- **字體大小**：具體數值（如 `14px`, `1.125rem`）
-- **RWD 斷點**：具體斷點值（如 `768px`, `1024px`）
-
-**範例輸出**：
-```markdown
-## 主按鈕規格
-
-- **顏色**：背景 #3B82F6（藍色），文字 #FFFFFF（白色）
-- **圓角**：8px
-- **內距**：上下 12px、左右 24px
-- **字體**：14px, font-weight 600
-- **懸停狀態**：背景 #2563EB
-- **RWD**：手機版全寬，桌面版固定寬度 200px
-```
-
----
-
-### 5. pm.yaml（產品經理）
-
-**適用任務**：需求分析、PRD 撰寫、任務拆解、驗收標準定義
-
-#### YAML 結構
-
-```yaml
-skill: pm
-formation: legacy
-version: "1.0"
-
-name: Product Manager
-description: 需求分析。PRD 撰寫、任務拆解、用戶故事、驗收標準定義。
-
-role:
-  identity: |
-    你是產品經理。分析需求、撰寫 PRD、拆解任務、定義驗收標準。
-    確保需求清晰、可執行、有明確的完成定義。
-  priority: 產出可執行的任務定義，而非完美的文檔。
-
-input:
-  required:
-    - task: 任務 ID 或需求描述
-  optional:
-    - spec: 產品規格參考（dev/PRODUCT_SPEC.md）
-    - context: 背景資訊
-
-output:
-  primary: 任務拆解（TASK_XXX.yaml 格式）或 PRD 文件
-  secondary: 優先級建議、依賴分析
-
-behavior:
-  - 先理解用戶目標再拆解任務
-  - 每個任務有明確的驗收標準
-  - 任務粒度適中（15-20 分鐘可完成）
-  - 標示依賴關係和 scope_paths
-  - 使用 task-api.js 建立任務卡
-
-collaboration:
-  task_api: node .collaboration/core/task-api.js
-
-  workflow:
-    - step: 讀取任務
-      run: node .collaboration/core/task-api.js get {task_id}
-
-    - step: 認領任務
-      run: node .collaboration/core/task-api.js claim {task_id}
-
-    - step: 需求分析
-      actions:
-        - 閱讀 dev/PRODUCT_SPEC.md 了解產品目標
-        - 分析需求並拆解為可執行任務
-        - 使用 task-api.js create 建立子任務
-        - 定義依賴和優先級
-
-    - step: 完成任務
-      run: node .collaboration/core/task-api.js complete {task_id}
-
-  on_blocked:
-    run: node .collaboration/core/task-api.js move {task_id} blocked
-```
-
-#### 任務拆解規範（PPL-101）
-
-**粒度標準**：
-- 每個任務 15-20 分鐘可完成
-- 有明確的驗收標準
-- 標示依賴關係和 scope_paths
-- 優先級明確（P0/P1/P2/P3）
-
-**範例拆解**：
-```yaml
-# 功能：「搜尋功能改進」
-→ TASK_147: 建立 Pipeline 執行規則文檔（20 分鐘）
-→ TASK_148: 更新 CLAUDE.md 工作流程說明（20 分鐘）
-→ TASK_149: 更新系統文檔（18 分鐘）
-→ TASK_150: 建立 Pipeline 完整使用指南（20 分鐘）
-```
-
----
-
-### 6. qa.yaml（測試工程師）
-
-**適用任務**：測試策略、單元測試、整合測試、缺陷追蹤
-
-#### YAML 結構
-
-```yaml
-skill: qa
-formation: legacy
-version: "1.0"
-
-name: QA Engineer
-description: 測試與品質保證。測試策略、單元測試、整合測試、缺陷追蹤。
-
-role:
-  identity: |
-    你是 QA 工程師。撰寫測試案例、執行驗證、追蹤缺陷。
-    確保功能正確、邊界條件覆蓋、回歸測試通過。
-  priority: 找出問題並驗證修復，而非完美覆蓋率。
-
-input:
-  required:
-    - task: 任務 ID 或測試需求描述
-  optional:
-    - scope: 測試範圍（模組或功能）
-    - test_type: 測試類型（unit / integration / e2e）
-
-output:
-  primary: 測試檔案或測試報告
-  secondary: 缺陷清單、覆蓋率摘要
-
-behavior:
-  - 先理解功能需求再設計測試案例
-  - 覆蓋正常路徑和邊界條件
-  - 使用專案現有的測試框架
-  - 發現 Bug 時記錄重現步驟
-  - 測試要可獨立執行，不依賴外部狀態
-
-collaboration:
-  task_api: node .collaboration/core/task-api.js
-
-  workflow:
-    - step: 讀取任務
-      run: node .collaboration/core/task-api.js get {task_id}
-
-    - step: 認領任務
-      run: node .collaboration/core/task-api.js claim {task_id}
-
-    - step: 測試執行
-      actions:
-        - 分析功能需求和驗收標準
-        - 設計測試案例
-        - 撰寫並執行測試
-        - 記錄結果
-
-    - step: 完成任務
-      run: node .collaboration/core/task-api.js complete {task_id}
-
-  on_blocked:
-    run: node .collaboration/core/task-api.js move {task_id} blocked
-```
-
-#### 測試策略
-
-**測試覆蓋**：
-- ✅ 正常路徑（Happy Path）
-- ✅ 邊界條件（Boundary Cases）
-- ✅ 錯誤處理（Error Handling）
-- ⚠️ 覆蓋率非目標，找出真實問題才是優先
-
-**測試類型**：
-- **Unit**：單元測試（函數級別）
-- **Integration**：整合測試（模組級別）
-- **E2E**：端到端測試（完整流程）
-
----
-
-### 7. sre.yaml（SRE 工程師）
-
-**適用任務**：Supabase 管理、資料庫遷移、RLS 策略、監控
-
-#### YAML 結構
-
-```yaml
-skill: sre
-formation: legacy
-version: "1.0"
-
-name: SRE Agent
-description: 基礎設施與部署。Supabase 管理、資料庫遷移、RLS 策略、監控。
-
-role:
-  identity: |
-    你是 SRE 工程師。管理 Supabase 環境、資料庫遷移、RLS 安全策略、部署流程。
-    確保基礎設施穩定可靠。
-  priority: 安全第一，操作前備份，變更可回滾。
-
-input:
-  required:
-    - task: 任務 ID 或基礎設施需求
-  optional:
-    - env: 環境（local / staging / production）
-    - scope: 影響範圍（table / rls / migration）
-
-output:
-  primary: Migration 文件、RLS 策略、部署配置
-  secondary: 操作日誌、回滾計劃
-
-behavior:
-  - 操作前確認環境和備份狀態
-  - Migration 必須可回滾（同時寫 up 和 down）
-  - RLS 策略預設拒絕，明確允許
-  - 避免破壞性操作（DROP TABLE 等需要額外確認）
-  - 記錄所有環境變更
-
-collaboration:
-  task_api: node .collaboration/core/task-api.js
-
-  workflow:
-    - step: 讀取任務
-      run: node .collaboration/core/task-api.js get {task_id}
-
-    - step: 認領任務
-      run: node .collaboration/core/task-api.js claim {task_id}
-
-    - step: 基礎設施操作
-      actions:
-        - 確認環境狀態
-        - 執行 Migration 或配置變更
-        - 驗證變更結果
-        - 注意：禁止 git 操作，由 Formation Lead 統一管理
-
-    - step: 完成任務
-      run: node .collaboration/core/task-api.js complete {task_id}
-
-  on_blocked:
-    run: node .collaboration/core/task-api.js move {task_id} blocked
-```
-
-#### 安全性原則
-
-**Migration 規範**：
-- ✅ 必須可回滾（同時寫 `up` 和 `down`）
-- ✅ 測試環境先驗證
-- ❌ 避免破壞性操作（DROP TABLE, ALTER COLUMN TYPE 等）
-
-**RLS 策略**：
-- **預設拒絕**：所有資料預設不可存取
-- **明確允許**：明確定義誰可以做什麼
-- **驗證**：確認策略正確覆蓋所有場景
-
----
-
-### 8. review.yaml（專案檢視）
-
-**適用任務**：Self-enhancement 模式專用，分析專案進度並決定是否建立新任務
-
-#### YAML 結構
-
-```yaml
-skill: review
-formation: legacy
-version: "1.0"
-
-name: Product Review
-description: |
-  專案檢視。分析 PRODUCT_SPEC 與當前實作狀態，判斷是否需要新任務或已完成。
-  用於 self-enhancement 模式的自動化循環。
-
-role:
-  identity: |
-    你是專案檢視員。你的工作是分析產品規格與當前進度，
-    判斷是否需要建立新任務、或專案已達成目標。
-  priority: 精準判斷專案完成度，避免過度開發或遺漏功能。
-
-input:
-  required:
-    - spec: 產品規格（dev/PRODUCT_SPEC.md）
-  optional:
-    - progress: 進度追蹤（dev/pipeline/PROGRESS.md）
-    - status: 自我增強狀態（dev/pipeline/SELF_ENHANCEMENT_STATUS.json）
-
-output:
-  primary: 更新 SELF_ENHANCEMENT_STATUS.json 的 decision 欄位
-  secondary: 如有需要，建立新任務到 .collaboration/tasks/backlog/
-
-behavior:
-  - 讀取 dev/PRODUCT_SPEC.md 了解產品目標
-  - 掃描 .collaboration/tasks/ 的各狀態目錄，統計進度
-  - 比對已完成功能與規格要求
-  - 判斷：
-    - "continue" — 有未完成功能，建立新任務
-    - "complete" — 所有功能已實現
-    - "complete_with_suggestions" — 核心完成，有優化建議
-  - 更新 dev/pipeline/SELF_ENHANCEMENT_STATUS.json
-  - 使用 task-api.js 建立新任務（如需要）
-
-collaboration:
-  task_api: node .collaboration/core/task-api.js
-
-  workflow:
-    - step: 分析產品規格
-      actions:
-        - 讀取 dev/PRODUCT_SPEC.md
-        - 讀取 dev/pipeline/PROGRESS.md（如存在）
-
-    - step: 統計專案進度
-      run: node .collaboration/core/task-api.js stats
-
-    - step: 比對並判斷
-      actions:
-        - 列出已完成的功能
-        - 找出規格中尚未實現的部分
-        - 決定 decision 值
-
-    - step: 建立新任務（如需要）
-      run: node .collaboration/core/task-api.js create --title "..." --priority P1
-
-    - step: 更新狀態
-      actions:
-        - 寫入 decision 到 SELF_ENHANCEMENT_STATUS.json
-        - 格式：{"decision": "continue|complete|complete_with_suggestions", ...}
-```
-
-#### Decision 欄位定義
-
-| 值 | 說明 | 行為 |
-|----|------|------|
-| `continue` | 有未完成功能 | 建立新任務，Scheduler 繼續執行 |
-| `complete` | 所有功能已實現 | Scheduler 停止迭代 |
-| `complete_with_suggestions` | 核心完成，有優化建議 | Scheduler 停止，建議記錄到 .memory/ |
-
-**範例輸出**（`SELF_ENHANCEMENT_STATUS.json`）：
-```json
-{
-  "decision": "continue",
-  "reason": "尚未實現「任務批量操作」功能",
-  "new_tasks": ["TASK_224"],
-  "timestamp": "2026-02-20T12:00:00Z"
-}
-```
-
----
-
-## 🚀 Legacy Scheduler 工作流程
-
-### 完整流程圖
-
-```
-┌─────────────────────────────────────────┐
-│ Formation Legacy Scheduler 啟動         │
-│ (node .formation/tools/legacy-scheduler.js) │
-└─────────────────────────────────────────┘
-   ↓
-┌─ Step 1: 掃描待辦任務 ──────────────────┐
-│ - 新系統：.collaboration/tasks/backlog/  │
-│ - 舊系統：dev/pipeline/tasks/            │
-│ - 選擇最高優先級 pending 任務            │
-└─────────────────────────────────────────┘
-   ↓
-┌─ Step 2: 判斷任務類型 ──────────────────┐
-│ role === "lead"? → Lead-only 任務        │
-│ role !== "lead"? → 一般任務（派給 subagent）│
-└─────────────────────────────────────────┘
-   ↓
-┌─ Branch A: Lead-only 任務 ──────────────┐
-│ 1. Scheduler 自己執行（post-complete.js）│
-│ 2. task-api.js complete {task_id}        │
-└─────────────────────────────────────────┘
-   ↓
-┌─ Branch B: 一般任務 ─────────────────────┐
-│ 1. 從 role_skill_map 取得 Skill 名稱     │
-│ 2. 使用 Formation 系統派出 subagent：    │
-│    node .formation/tools/headless.js \   │
-│      --skill={skill_name} \              │
-│      --task={task_id} \                  │
-│      --formation=legacy                  │
-│ 3. Subagent 執行任務（禁止 git 操作）    │
-│ 4. Subagent 完成：task-api.js complete   │
-│ 5. Scheduler 執行 post-complete：        │
-│    - Archive 舊任務（雙系統）            │
-│    - Git branch + commit + merge         │
-└─────────────────────────────────────────┘
-   ↓
-┌─ Step 3: 檢查下一個任務 ─────────────────┐
-│ - 有待辦 → 回到 Step 1                   │
-│ - 無待辦 + self-enhancement 啟用         │
-│   → 執行 review skill                    │
-│ - 無待辦 + self-enhancement 停用         │
-│   → 進入 idle check（20s 輪詢）          │
-└─────────────────────────────────────────┘
-```
-
-### Self-Enhancement 循環
-
-```
-┌─ 無待辦任務 ─────────────────────────────┐
-│ 啟用 self-enhancement: true               │
-└─────────────────────────────────────────┘
-   ↓
-┌─ 執行 review skill ──────────────────────┐
-│ node .formation/tools/headless.js \       │
-│   --skill=review \                        │
-│   --task="專案檢視" \                     │
-│   --formation=legacy                      │
-└─────────────────────────────────────────┘
-   ↓
-┌─ review skill 分析專案 ──────────────────┐
-│ 1. 讀取 dev/PRODUCT_SPEC.md               │
-│ 2. 統計任務進度（task-api.js stats）     │
-│ 3. 比對已完成功能與規格                  │
-│ 4. 決定 decision 值                       │
-└─────────────────────────────────────────┘
-   ↓
-┌─ decision: continue ─────────────────────┐
-│ 1. 建立新任務（task-api.js create）      │
-│ 2. 回到 Scheduler 主循環                 │
-└─────────────────────────────────────────┘
-   ↓
-┌─ decision: complete ─────────────────────┐
-│ 1. Scheduler 停止迭代                    │
-│ 2. 記錄完成狀態                          │
-└─────────────────────────────────────────┘
-```
-
----
-
-## ⚙️ Scheduler 配置（scheduler.yaml）
-
-### 核心配置
-
-```yaml
-# .formation/legacy/scheduler.yaml
-config:
-  # 首次執行前等待秒數
-  initial_delay_secs: 30
-  # 執行間隔（分鐘）
-  interval_minutes: 20
-  # 無任務時輪詢間隔（秒）
-  idle_check_secs: 20
-  # 提前完成時的等待秒數
-  early_finish_delay_secs: 30
-  # 任務超時（分鐘）
-  dev_timeout_minutes: 60
-  # review skill 超時（分鐘）
-  review_timeout_minutes: 30
-  # 是否啟用 self-enhancement（review skill + 自動建立任務）
-  enable_self_enhancement: false
-```
-
-### 狀態機
-
-```
-stopped → waiting → running_dev → paused → completed
-                       ↓           ↑
-                  running_review ──┘
-                       ↓
-                    idle / error
-```
-
-### Post-Complete 配置
-
-```yaml
-post_complete:
-  # Archive 保留數量
-  keep: 10
-  # 雙系統 archive
-  archive_new: ".collaboration/tasks/done → archived"
-  archive_legacy: "dev/pipeline/completed → archived"
-  # Git 分支管理
-  git_flow: "task/task_xxx → user_branch → (手動) main"
-```
-
----
-
-## 🛠️ 新增 Legacy Skill 指南
-
-### 步驟
-
-1. **建立 YAML 檔案**（`.formation/legacy/your_skill.yaml`）
-
-```yaml
-skill: your_skill
-formation: legacy
-version: "1.0"
-
-name: Your Skill Name
-description: 簡短描述你的 Skill 職責
-
-role:
-  identity: |
-    你是...
-  priority: 優先產出...
-
-input:
-  required:
-    - task: 任務 ID 或具體描述
-
-output:
-  primary: 主要產出
-  secondary: 次要產出
-
-behavior:
-  - 行為規範 1
-  - 行為規範 2
-
-collaboration:
-  task_api: node .collaboration/core/task-api.js
-
-  workflow:
-    - step: 讀取任務
-      run: node .collaboration/core/task-api.js get {task_id}
-
-    - step: 認領任務
-      run: node .collaboration/core/task-api.js claim {task_id}
-
-    - step: 執行工作
-      actions:
-        - 具體步驟
-
-    - step: 完成任務
-      run: node .collaboration/core/task-api.js complete {task_id}
-
-  on_blocked:
-    run: node .collaboration/core/task-api.js move {task_id} blocked
-```
-
-2. **更新 `scheduler.yaml` 的 `role_skill_map`**
-
-```yaml
-formation_dispatch:
-  role_skill_map:
-    # ... 現有對應 ...
-    your_role: your_skill  # 新增對應
-```
-
-3. **測試 Skill**
-
-```bash
-# 使用 headless.js 測試
-node .formation/tools/headless.js \
-  --skill=your_skill \
-  --task=TASK_XXX \
-  --formation=legacy \
-  --dry-run
-```
-
-4. **更新文檔**（本文件）
-
----
-
-## 🔗 相關文檔
-
-| 文檔 | 路徑 | 說明 |
-|------|------|------|
-| **Formation 系統概述** | `.system/formation/README.md` | 陣型選擇指南 |
-| **Legacy Scheduler** | `.formation/tools/legacy-scheduler.js` | Scheduler 實作 |
-| **Post-Complete** | `.formation/tools/post-complete.js` | Archive + Git 自動化 |
-| **Headless Runner** | `.formation/tools/headless.js` | 無頭啟動器 |
-| **Task API** | `.collaboration/core/task-api.js` | 任務管理 API |
-| **CLAUDE.md Skills** | `.claude/skills/` | 互動式 Agent Skills |
-
----
-
-## 📝 版本歷史
-
-- **v1.0** (2026-02-20): 初始版本，記錄 8 個 Legacy Skills 定義
-
----
-
-**維護者**: Developer Team
-**相關任務**: TASK_217