kenaz 0.3.17 → 0.3.19

package/core/plugins/kenaz/skills/qa_engineer/SKILL.md

@@ -78,7 +78,7 @@ description: QA Lead（溝通者）- 測試策略、團隊調度、品質保證
 
 **你的操作**:
 1. 讀取 `dev/PRODUCT_SPEC.md` - 了解專案規格
-2. 讀取相關任務文件（`dev/pipeline/tasks/TASK_XXX.yaml`）- 了解驗收標準
+2. 讀取相關任務文件（`node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .collaboration/core/task-api.js get TASK_XXX`）- 了解驗收標準
 3. 讀取 `.failure/INDEX.yaml` - 檢查相關失敗模式（AGT-005 規則）
 
 **CLI 匯報格式**:
@@ -156,14 +156,14 @@ description: QA Lead（溝通者）- 測試策略、團隊調度、品質保證
 4. 搜尋相關代碼（Grep `backend/` 或 `src/`）
 5. 檢查 API 文檔（Read `dev/API_SPEC.md`）
 6. 查閱歷史缺陷（Grep `dev/BUG_LIST.md`）
-7. 查閱類似任務（Grep `dev/pipeline/completed/`）
+7. 查閱類似任務（`task-api.js search KEYWORD`）
 
 **CLI 匯報格式**:
 ```
 🔍 背景調研
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 相關 Feature: F-XXX
-驗收標準: dev/pipeline/tasks/TASK_XXX.yaml
+驗收標準: `task-api.js get TASK_XXX`
 現有測試: tests/test_user_service.py
 測試覆蓋率: 65%（需提升至 80%）
 相關代碼: backend/services/user_service.py
@@ -735,10 +735,10 @@ Agent 類型根據缺陷性質分配（後端 bug→backend, 前端 bug→fronte
 
 ```bash
 # 讀取新建立的任務文件
-ls dev/pipeline/tasks/TASK_*_fix_*.yaml
+node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .collaboration/core/task-api.js list --status backlog | grep fix
 
-# 確認 TASK_QUEUE.json 已更新
-cat dev/pipeline/TASK_QUEUE.json | grep "fix" -A 5
+# 確認任務卡已建立
+node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .collaboration/core/task-api.js search fix
 ```
 
 #### 10.5 最終匯報
@@ -757,8 +757,7 @@ cat dev/pipeline/TASK_QUEUE.json | grep "fix" -A 5
 | TASK_204 | 缺少 rate limiting | backend | P1 |
 
 Pipeline 已更新:
-✓ TASK_QUEUE.json（+4 修復任務）
-✓ PROGRESS.md
+✓ 任務卡（+4 修復任務）
 
 Issue Report: dev/qa/QA_ISSUES_20260215_143000.md
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -875,7 +874,7 @@ Issue Report: dev/qa/QA_ISSUES_20260215_143000.md
 🔍 背景調研
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 相關 Feature: F-003（用戶系統）
-驗收標準: dev/pipeline/tasks/TASK_089.yaml
+驗收標準: `task-api.js get TASK_089`
 現有測試: 無
 測試覆蓋率: 0%（需建立測試）
 相關代碼: backend/services/auth_service.py
@@ -981,8 +980,7 @@ Task(
 | TASK_204 | 缺少 rate limiting | backend | P1 |
 
 Pipeline 已更新:
-✓ TASK_QUEUE.json（+4 修復任務）
-✓ PROGRESS.md
+✓ 任務卡（+4 修復任務）
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 下一步: 執行 `/Ansuz` 派工修復，完成後 `/qa` 回歸測試
@@ -1246,12 +1244,9 @@ QA Team 將遵循以下規範（參考 `.rule/code/` 規則）：
 
 執行任務前，檢查相關失敗模式（遵循 AGT-005 規則）：
 
-```powershell
-# 檢查 QA 相關失敗模式
-.\.failure\tools\check_failures.ps1 -AgentType "qa"
-
-# 檢查測試相關失敗模式
-.\.failure\tools\check_failures.ps1 -ScopePath "tests/"
+```bash
+# 讀索引，再 Grep 與任務 scope 相關的失敗記錄
+Grep pattern="tests|關鍵字" path=".failure/"
 ```
 
 **常見失敗模式**：

package/core/plugins/kenaz/skills/spec_optimizer/SKILL.md

@@ -4,296 +4,46 @@ aliases:
   - 規格優化
   - spec
   - optimizer
-description: 專案規格優化、文件整理、知識沉澱專家。根據 .failure、.memory、.rule 進行系統性改良。
+description: 專案規格優化、文件整理、知識沉澱專家。根據 .failure、.rule 與任務卡進行系統性改良。
 ---
 
 # Spec Optimizer Agent
 
 ## 角色
 
-你是一名**規格優化與知識管理專家**，專注於提升專案的規格品質、整理開發經驗、優化工作流程。你的核心職責是將散落的知識系統化、從失敗中提煉規則、持續優化專案文件。
+規格優化與知識管理專家：提升規格品質、整理開發經驗、優化文件。
 
 ## 核心職責
 
-### 1. 規格優化
-- 審查並優化 `dev/PRODUCT_SPEC.md`
-- 確保 Feature ID 制度完整（F-XXX）
-- 驗證規格與實作的一致性
-- 識別規格漂移（Spec Drift）
-
-### 2. 文件整理
-- 更新 `.memory/CONTEXT.md`（專案概況）
-- 更新 `C:/Users/User/.claude/projects/.../memory/MEMORY.md`（個人教訓）
-- 整理 `dev/pipeline/PROGRESS.md`
-- 維護 `.rule/` 規則庫
-
-### 3. 知識沉澱
-- 從 `.failure/` 提取失敗經驗
-- 將重複失敗模式提升為 `.rule/` 規則
-- 記錄關鍵決策和權衡（ADR）
-- 建立最佳實踐文件
-
-### 4. 系統改良
-- 分析工作流程瓶頸
-- 提出改進建議
-- 優化 Agent 協作流程
-- 建立自動化腳本
-
-## 技能
-
-* **文件撰寫**：清晰、結構化的技術文件
-* **知識管理**：分類、索引、檢索優化
-* **模式識別**：從失敗中發現規律
-* **規格設計**：Feature ID、驗收標準、追溯性
-* **流程優化**：識別瓶頸、自動化機會
+1. **規格優化**：審查 `dev/PRODUCT_SPEC.md`；確保 Feature ID（F-XXX）完整；驗證規格與實作一致；識別規格漂移。
+2. **文件整理**：維護 `.rule/` 規則庫與 `.failure/` 失敗索引；更新 PRODUCT_SPEC 的 Feature 狀態。
+3. **知識沉澱**：重複出現的失敗提升為規則；教訓用 `kenaz learn add` 或 Claude 原生記憶檔。
+4. **系統改良**：找出文件間不一致、過期描述並修正。
 
 ## 工作流程
 
-### 階段 1：評估現狀
-
-**輸入**：用戶請求（例如：「整理最近的開發記憶點」）
-
-**執行步驟**：
-1. 讀取關鍵文件：
-   - `dev/PRODUCT_SPEC.md`（了解專案規格）
-   - `dev/pipeline/PROGRESS.md`（了解最新進度）
-   - `.memory/CONTEXT.md`（了解專案現狀）
-   - `.failure/INDEX.yaml`（了解失敗記錄）
-
-2. 識別待處理事項：
-   - 哪些 Feature 已完成但未更新狀態？
-   - 哪些失敗模式重複出現（需要提升為規則）？
-   - 哪些記憶點需要更新？
-   - 哪些文件缺失或過時？
-
-3. 提出整理計劃：
-   ```
-   發現以下待整理事項：
-   1. PRODUCT_SPEC.md - F-007 狀態需更新為 completed
-   2. MEMORY.md - 缺少 2/4-2/5 的開發教訓
-   3. .failure/ - FAIL-003 重複出現，建議提升為規則
-
-   預估時間：30 分鐘
-   ```
-
-### 階段 2：執行整理
-
-**優先順序**：
-1. **Critical**：規格漂移修正、嚴重失敗記錄
-2. **High**：MEMORY.md 更新、重要決策記錄
-3. **Medium**：CONTEXT.md 更新、文件格式優化
-4. **Low**：錦上添花的改進
-
-**執行原則**：
-- ✅ 保持文件簡潔（CONTEXT.md < 100 行）
-- ✅ 使用結構化格式（Markdown 表格、清單）
-- ✅ 提供可執行範例（程式碼片段、指令）
-- ✅ 記錄時間戳和來源
-- ✅ 交叉引用相關文件
-
-**範例輸出**：
-
-#### 更新 MEMORY.md
-```markdown
-## .failure 系統 (2026-02-05)
-
-### 系統建立完成
-- 五大分類：Agent 執行、代碼品質、架構、Pipeline、數據完整性
-- 三個初始失敗記錄：FAIL-001, FAIL-002, FAIL-003
-- 自動化工具：check_failures.ps1, log_failure.ps1, fix_json.js
-
-### 關鍵學習
-1. **JSON BOM 問題**（FAIL-002）：Windows 編輯器會加 BOM，導致解析失敗
-   - 解決：使用 fix_json.js 自動移除
-2. **Queue 污染問題**（FAIL-003）：Scheduler 從 completed/ 同步導致
-   - 解決：改為手動封存（/archive 指令）
-```
+### 1. 評估現狀
+讀取：
+* `dev/PRODUCT_SPEC.md`
+* `.failure/INDEX.yaml`（失敗模式索引）
+* `.rule/INDEX.yaml`（規則索引）
+* 任務狀態：`node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .collaboration/core/task-api.js stats`、`list --status done`
 
-#### 更新 CONTEXT.md
-```markdown
-## 已完成功能
+### 2. 執行整理
+* 更新 PRODUCT_SPEC.md 中已完成 Feature 的狀態
+* 失敗模式在 INDEX 中補齊或標為 retired；重複 2 次以上的提升為 `.rule/` 規則
+* 清除過期文件描述（指向已刪除檔案、已退役系統的段落）
 
-| 功能 | 狀態 | 備註 |
-|------|------|------|
-| 錯誤學習系統 (.failure/) | ✅ | 五分類、三失敗記錄、自動化工具 |
-| 手動記憶點封存 (/archive) | ✅ | 取代自動清理，用戶控制 |
-```
-
-#### 更新 PRODUCT_SPEC.md
-```yaml
-# F-007: 錯誤學習系統 (.failure)
-- Status: completed ✅
-- Completed: 2026-02-05
-```
-
-### 階段 3：驗證品質
-
-**檢查清單**：
-- [ ] 所有 Markdown 語法正確
-- [ ] 程式碼範例可執行
-- [ ] 時間戳記錄完整
-- [ ] 交叉引用連結有效
-- [ ] 文件長度適中（< 200 行警告）
-- [ ] 結構清晰（標題層級正確）
-
-**驗證方法**：
+### 3. 驗證品質
 ```bash
-# 驗證 Markdown 格式
-markdownlint .memory/*.md
-
-# 驗證 JSON 文件
-node .failure/tools/validate_json.js dev/pipeline/TASK_QUEUE.json
-
-# 檢查文件大小
-wc -l .memory/CONTEXT.md
+node .failure/tools/validate_json.js <json 檔>   # 若有 JSON 檔需驗證
 ```
+確認被修改的文件沒有指向不存在的路徑（Grep 驗證）。
 
-### 階段 4：輸出總結
-
-**格式**：
-```
-## ✅ 整理完成
-
-### 更新的文件
-1. .memory/CONTEXT.md - 新增 .failure 系統、/archive 指令
-2. MEMORY.md - 新增 2/4-2/5 開發教訓章節
-3. dev/PRODUCT_SPEC.md - F-007 標記為 completed
-
-### 關鍵改進
-- 記錄了 .failure 系統的完整建立過程
-- 沉澱了 JSON BOM、Queue 污染的解決方案
-- 更新了專案現狀，新 Agent 可快速理解
-
-### 建議下一步
-- 考慮將 FAIL-003 提升為 PPL-003 規則（已重複 2 次）
-- 定期執行 /archive 清理 Queue
-```
-
----
-
-## 文件路徑索引
-
-### 必讀文件
-| 路徑 | 用途 | 更新頻率 |
-|------|------|---------|
-| `dev/PRODUCT_SPEC.md` | 產品規格與 Feature 狀態 | 每個 Feature 完成時 |
-| `.memory/CONTEXT.md` | 專案概況（< 100 行） | 每週或重大變更時 |
-| `C:/Users/User/.claude/.../MEMORY.md` | 個人教訓與最佳實踐 | 每次遇到新問題時 |
-| `dev/pipeline/PROGRESS.md` | 任務進度追蹤 | 每次任務狀態變更 |
-
-### 參考文件
-| 路徑 | 用途 |
-|------|------|
-| `.failure/INDEX.yaml` | 失敗記錄索引 |
-| `.rule/INDEX.yaml` | 規則索引 |
-| `CLAUDE.md` | 專案指導文件 |
-| `.memory/COMPLETED_TASKS.json` | 歷史已完成任務 |
-
----
-
-## 特殊場景處理
-
-### 場景 1：新 Agent Session 開始
-**目標**：讓新 Agent 快速理解專案狀態
-
-**執行**：
-1. 確保 `.memory/CONTEXT.md` 是最新的
-2. 檢查 `PROGRESS.md` 的 Last Update 時間
-3. 驗證 Feature 狀態與實際一致
-
-### 場景 2：重大失敗發生
-**目標**：記錄失敗並防止重複
-
-**執行**：
-1. 使用 `.failure/tools/log_failure.ps1` 記錄
-2. 分析是否與現有失敗記錄重複
-3. 如果重複 >= 2 次，提議提升為 `.rule/` 規則
-
-### 場景 3：Feature 完成
-**目標**：更新規格狀態
-
-**執行**：
-1. 更新 `PRODUCT_SPEC.md` 中的 Feature 狀態
-2. 記錄完成時間
-3. 更新 `CONTEXT.md` 的已完成功能列表
-
-### 場景 4：定期維護
-**目標**：保持文件健康
-
-**執行**（建議每週一次）：
-1. 檢查 `CONTEXT.md` 行數（目標 < 100 行）
-2. 封存舊任務（執行 `/archive`）
-3. 清理過時的記憶點
-4. 驗證所有文件的 Markdown 格式
-
----
-
-## 輸出範本
-
-### 快速整理（30 分鐘）
-```markdown
-## 📝 快速整理報告
-
-### 更新內容
-1. ✅ CONTEXT.md - 新增 [功能名稱]
-2. ✅ MEMORY.md - 記錄 [日期] 的教訓
-3. ✅ PRODUCT_SPEC.md - 更新 F-XXX 狀態
-
-### 關鍵變更
-- [變更 1]
-- [變更 2]
-
-### 時間消耗
-- 評估：5 分鐘
-- 執行：20 分鐘
-- 驗證：5 分鐘
-```
-
-### 完整整理（1-2 小時）
-```markdown
-## 📚 完整整理報告
-
-### 執行摘要
-本次整理涵蓋 [日期範圍]，更新了 [N] 個文件，記錄了 [N] 個關鍵學習。
-
-### 更新文件
-| 文件 | 變更類型 | 說明 |
-|------|---------|------|
-| CONTEXT.md | 新增 | 新功能 X |
-| MEMORY.md | 新增章節 | 失敗教訓 Y |
-| PRODUCT_SPEC.md | 狀態更新 | F-XXX completed |
-
-### 關鍵學習
-1. **[學習 1]**：[描述 + 解決方案]
-2. **[學習 2]**：[描述 + 解決方案]
-
-### 提升為規則的建議
-- FAIL-XXX → RULE-XXX：[理由]
-
-### 下一步建議
-- [ ] [建議 1]
-- [ ] [建議 2]
-```
-
----
-
-## 注意事項
-
-1. **保持簡潔**：CONTEXT.md 務必 < 100 行，過長則分離到其他文件
-2. **時間戳**：所有記憶點必須記錄日期
-3. **可執行**：程式碼範例必須能直接執行
-4. **交叉引用**：相關內容互相連結
-5. **版本控制**：重大變更前先備份
-
-## 協作方式
-
-**與其他 Agent 的分工**：
-- **Product Manager**：建立任務 → Spec Optimizer 更新規格
-- **Dev Agent**：完成開發 → Spec Optimizer 記錄經驗
-- **QA Engineer**：發現 Bug → Spec Optimizer 記錄失敗模式
+### 4. 輸出總結
+列出：更新的文件、關鍵改進、建議下一步。
 
-**何時調用此 Agent**：
-- 完成重要里程碑後
-- 累積多個失敗記錄時
-- 新 Agent 需要理解專案時
-- 定期維護（建議每週）
+## 特殊場景
+* **重大失敗發生**：先記錄到 `.failure/`，再評估是否提升為規則。
+* **Feature 完成**：更新 PRODUCT_SPEC.md 狀態。
+* **定期維護**（建議每週）：掃描過期文件與失效連結。

package/core/plugins/kenaz/skills/sre_agent/SKILL.md

@@ -1324,12 +1324,9 @@ SRE Team 將遵循以下規範（參考 `.rule/code/` 規則）：
 
 執行任務前，檢查相關失敗模式（遵循 AGT-005 規則）：
 
-```powershell
-# 檢查 SRE 相關失敗模式
-.\.failure\tools\check_failures.ps1 -AgentType "sre"
-
-# 檢查 Supabase 相關失敗模式
-.\.failure\tools\check_failures.ps1 -ScopePath "supabase/"
+```bash
+# 讀索引，再 Grep 與任務 scope 相關的失敗記錄
+Grep pattern="supabase|關鍵字" path=".failure/"
 ```
 
 **常見失敗模式**：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kenaz",
-  "version": "0.3.17",
+  "version": "0.3.19",
   "description": "Install Kenaz (plugin, hooks, kenaz-server) for Claude Code and Codex: npx kenaz install",
   "bin": {
     "kenaz": "bin/kenaz.js"
@@ -20,11 +20,11 @@
     "test": "node --test lib/cli.test.js"
   },
   "optionalDependencies": {
-    "@kenazai/server-darwin-arm64": "0.3.17",
-    "@kenazai/server-darwin-x64": "0.3.17",
-    "@kenazai/server-linux-arm64": "0.3.17",
-    "@kenazai/server-linux-x64": "0.3.17",
-    "@kenazai/server-win32-x64": "0.3.17"
+    "@kenazai/server-darwin-arm64": "0.3.19",
+    "@kenazai/server-darwin-x64": "0.3.19",
+    "@kenazai/server-linux-arm64": "0.3.19",
+    "@kenazai/server-linux-x64": "0.3.19",
+    "@kenazai/server-win32-x64": "0.3.19"
   },
   "license": "UNLICENSED",
   "repository": {

package/core/.claude/commands/archive.md

@@ -1,24 +0,0 @@
-# /archive - 封存已完成任務到記憶點
-
-將 TASK_QUEUE.json 中的所有 completed 任務封存到 `.memory/COMPLETED_TASKS.json`。
-
-## 執行步驟
-
-1. 執行封存腳本：
-```bash
-powershell -ExecutionPolicy Bypass -File dev/scripts/archive_completed_tasks.ps1
-```
-
-2. 顯示封存結果
-
-## 使用情境
-
-- 當佇列中累積多個 completed 任務時
-- 定期整理 TASK_QUEUE.json
-- 在開始新一輪開發前清理佇列
-
-## 別名
-
-- `/archive`
-- `存到記憶點`
-- `封存任務`

package/core/.claude/commands/init.md

@@ -1,112 +0,0 @@
-# /init - 初始化新專案
-
-## 用途
-快速重置 Pipeline 狀態並準備開始新專案開發。
-
-## 執行步驟
-
-### 1. 清理舊狀態
-執行以下清理操作：
-
-```powershell
-# 清空任務目錄
-Remove-Item dev/pipeline/tasks/*.md -Force -ErrorAction SilentlyContinue
-
-# 備份已完成任務到 archive
-$archiveDir = "dev/pipeline/archive/$(Get-Date -Format 'yyyy-MM-dd_HHmmss')"
-New-Item -ItemType Directory -Path $archiveDir -Force
-Move-Item dev/pipeline/completed/*.md $archiveDir -Force -ErrorAction SilentlyContinue
-
-# 刪除狀態文件
-Remove-Item dev/pipeline/SELF_ENHANCEMENT_STATUS.json -Force -ErrorAction SilentlyContinue
-```
-
-### 2. 重置 PROGRESS.md
-將 `dev/pipeline/PROGRESS.md` 重置為初始狀態：
-
-```markdown
-# Pipeline Progress Tracking
-
-## Last Update
-- **Time**: [當前時間]
-- **Agent**: System
-- **Session**: Project Initialized
-
----
-
-## Current Status
-
-### Running Tasks
-| Task ID | Name | Progress | Next Step |
-|--------|------|-----|-------|
-| - | None | - | Run /產品 to start |
-
-### Pending Task Queue
-| Priority | Task ID | Name | Status | Est. Hours |
-|-------|--------|------|-----|---------|
-| - | - | None | - | - |
-
-### Completed Tasks
-| Task ID | Name | Completion Date |
-|--------|------|---------|
-| - | - | - |
-
----
-
-## Statistics
-
-### Overall Progress
-\`\`\`
-Total Tasks: 0
-Completed: 0 (0%)
-In Progress: 0 (0%)
-Pending: 0 (0%)
-Blocked: 0 (0%)
-\`\`\`
-
-### Project Status
-\`\`\`
-⏳ Waiting for product requirements...
-Run /產品 to start requirement analysis
-\`\`\`
-```
-
-### 3. 檢查 PRODUCT_SPEC
-- 如果 `dev/PRODUCT_SPEC.md` 存在且內容豐富（>50行），詢問用戶是否保留
-- 如果不存在，從模板建立
-
-### 4. 輸出初始化摘要
-
-```
-========================================
-初始化完成！
-========================================
-已清理: X 個舊任務
-已備份: X 個已完成任務
-PROGRESS.md: 已重置
-
-下一步:
-1. 描述你的產品想法，或使用 /產品
-2. 準備好後執行 /Ansuz 派工
-========================================
-```
-
-### 5. 詢問是否開始需求分析
-
-詢問用戶：
-> 是否現在開始需求分析？請描述你的產品想法，我會以 Product Manager 角色幫你分析並建立任務。
-
-## 快捷方式
-
-也可以使用批次檔：
-```powershell
-.\dev\scripts\INIT_PROJECT.bat
-```
-
-## 參數
-
-| 參數 | 說明 |
-|------|------|
-| `-SkipRAG` | 跳過 RAG 環境設置 |
-| `-SkipCleanup` | 跳過清理舊任務 |
-| `-Quiet` | 靜默模式（無互動確認） |

package/core/.claude/commands/legacy_dev.md

@@ -1,18 +0,0 @@
-# /legacy_dev - 新任務系統開發模式
-
-正在讀取開發協調 Agent（新任務系統）...
-
-請按照以下步驟執行：
-
-1. **讀取 Agent Skill**：讀取 `.claude/skills/legacy_dev/SKILL.md` 內容並按照其框架執行。
-
-2. **查詢待辦任務**：執行 `node .collaboration/core/task-api.js list --status pending` 確認待辦任務。
-
-3. **執行開發流程**：
-   - 【任務選取】：選取最優先的 backlog 任務
-   - 【認領任務】：`node .collaboration/core/task-api.js claim TASK_XXX`
-   - 【任務執行】：調用專業 Agent 完成任務
-   - 【完成任務】：`node .collaboration/core/task-api.js complete TASK_XXX`
-   - 【日誌記錄】：寫入 `.formation/logs/legacy/`
-
-請開始執行。