kenaz 0.3.18 → 0.3.20

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

@@ -13,7 +13,7 @@ description: 架構設計、需求拆解、任務分派、接口定義、多Agen
 2. **任務拆解**：將大型需求拆解為可獨立執行的任務單元
 3. **Scope 定義**：為每個任務定義精確的路徑範圍（避免衝突）
 4. **接口設計**：定義模組之間的接口規範，確保整合順利
-5. **任務分派**：將任務寫入 `TASK_QUEUE.json` 並分派給適合的 Agent
+5. **任務分派**：以 task-api 建立任務卡並指定適合的 role
 
 ## 技能
 * **系統分析**：識別系統架構邊界和模組劃分
@@ -24,9 +24,8 @@ description: 架構設計、需求拆解、任務分派、接口定義、多Agen
 
 ## 文件路徑
 * **產品規格**：`dev/PRODUCT_SPEC.md`
-* **任務佇列**：`dev/pipeline/TASK_QUEUE.json`
-* **進度追蹤**：`dev/pipeline/PROGRESS.md`
-* **待處理任務**：`dev/pipeline/tasks/`
+* **任務卡**：`.kenaz/tasks/{backlog,active,done,blocked,cancel}/`（YAML，目錄即狀態）
+* **任務 API**：`node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .collaboration/core/task-api.js`
 * **接口文檔**：
   - `docs/api_spec.md`（API 接口）
   - `docs/component_spec.md`（組件接口）
@@ -171,97 +170,17 @@ def assign_agent(task: Task) -> str:
 
 > "接口定義已撰寫至 [文件路徑]"
 
-### 5. 產出任務檔案
-**將任務寫入 Pipeline 系統。**
+### 5. 產出任務卡
+**用 task-api 建立任務卡**（`node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .collaboration/core/task-api.js --help` 列出全部欄位）。
 
-1. **建立任務文件**（`dev/pipeline/tasks/TASK_XXX_描述.md`）
-   - 檔案名稱格式：`TASK_XXX_簡短英文描述.md`
-   - 例如：`TASK_022_login_ui.md`
-
-2. **寫入 TASK_QUEUE.json**：
-   ```json
-   {
-       "id": "TASK_XXX",
-       "title": "實作用戶登入 UI",
-       "status": "pending",
-       "priority": "P1",
-       "estimated_hours": 4,
-       "scope": ["src/components/auth/", "src/utils/auth.ts"],
-       "dependencies": ["TASK_AAA"],
-       "blocked_by": ["TASK_AAA"],
-       "blocks": [],
-       "source": "用戶需求 / PRD P1 項目",
-       "source_file": "TASK_XXX_login_ui.md",
-       "created_at": "2026-01-31T10:00:00.000Z"
-   }
-   ```
-
-   **重要**：`source_file` 字段必須與步驟 1 建立的任務文件名稱一致，Dashboard 依賴此字段讀取任務詳細描述。
-
-3. **更新 PROGRESS.md**
-
-> "已建立 [N] 個新任務，已更新 TASK_QUEUE.json"
-
----
-
-## 使用 Orchestrator 模組
-
-Architect Agent 可以使用 `dev/pipeline/orchestrator/` 中的工具：
-
-### 任務佇列管理
-```python
-from dev.pipeline.orchestrator.task_queue import (
-    TaskQueue, Task, TaskStatus, TaskPriority, AgentType, TaskScope
-)
-
-# 載入任務佇列
-queue = TaskQueue("dev/pipeline/TASK_QUEUE.json")
-
-# 建立新任務
-new_task = Task(
-    id="TASK_022",
-    title="實作用戶登入 UI",
-    status=TaskStatus.PENDING,
-    priority=TaskPriority.P1,
-    scope=TaskScope(paths=["src/components/auth/"], files=[]),
-    dependencies=["TASK_021"],
-    assigned_agent=AgentType.FRONTEND
-)
-
-queue.add_task(new_task)
-queue.save()
-```
-
-### 依賴驗證
-```python
-from dev.pipeline.orchestrator.dependency_resolver import DependencyResolver
-
-resolver = DependencyResolver()
-
-# 添加任務和依賴
-resolver.add_task("TASK_022", dependencies=["TASK_021"])
-resolver.add_task("TASK_023", dependencies=["TASK_021", "TASK_022"])
-
-# 驗證無循環依賴
-if not resolver.validate_no_cycles():
-    cycle = resolver.get_cycle()
-    print(f"檢測到循環依賴: {cycle}")
-
-# 查看依賴圖
-print(resolver.visualize())
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .collaboration/core/task-api.js create --title "實作用戶登入 UI" --description "..."   --priority P1 --role frontend --tags code
+node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .collaboration/core/task-api.js update TASK_XXX --append --acceptance-criteria "..." --technical-notes "..."
 ```
 
-### 路徑鎖定檢查
-```python
-from dev.pipeline.orchestrator.lock_manager import PathLockManager
-
-lock_manager = PathLockManager("dev/pipeline/LOCK_STATE.json")
+每張卡寫明 scope_paths（精確路徑，避免並行衝突）、dependencies（不得循環）、requirements、acceptance_criteria。
 
-# 檢查路徑是否被鎖定
-if lock_manager.is_locked("src/components/auth/"):
-    holder = lock_manager.get_lock_holder("src/components/auth/")
-    print(f"路徑已被 {holder} 鎖定")
-```
+> "已建立 [N] 張任務卡：TASK_..."
 
 ---
 
@@ -284,7 +203,7 @@ if lock_manager.is_locked("src/components/auth/"):
    - TASK_023 → TASK_022
    - TASK_024 → TASK_022
 5. 撰寫接口規範
-6. 更新 TASK_QUEUE.json
+6. 以 task-api 建立任務卡
 ```
 
 ### 範例 2：處理並行開發

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

@@ -285,5 +285,4 @@ Agent 分析：
 ### 相關系統
 - `.rule/` - 規則系統（評估發現的重複問題可提升為規則）
 - `.failure/` - 失敗學習系統（評估時參考失敗經驗）
-- `.memory/` - 記憶系統（評估經驗可沉澱為記憶）
 - `dev/PRODUCT_SPEC.md` - 產品規格（功能評估對應 Feature ID）

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

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

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

@@ -262,7 +262,7 @@ description: 程式碼審查、三級問題分類（Blocker/Suggestion/Nit）、
 
 ### 驗證先例（grounding）
 
-`.failure/pipeline/FAIL-003-queue-pollution.yaml` 記錄了 task lifecycle 的 antisymmetry 破損：task 被 `claim`（移到 active/）後未正確 `complete`（移到 done/），導致 `TASK_QUEUE.json` 被累積的 orphan state 污染。若當時有 mutation_counterpart 稽核，`claim` 無對稱 `complete`/`move` 路徑會在 review 階段被標記為 **[BLOCKER] orphan**。
+歷史案例（舊 TASK_QUEUE 佇列，已退役）：task 被 `claim`（移到 active/）後未正確 `complete`（移到 done/），導致佇列被累積的 orphan state 污染。若當時有 mutation_counterpart 稽核，`claim` 無對稱 `complete`/`move` 路徑會在 review 階段被標記為 **[BLOCKER] orphan**。
 
 ### Grep 檢查清單
 

package/core/plugins/kenaz/skills/code_reviewer/patterns.yaml

@@ -24,7 +24,7 @@ mutation_counterpart:
       rationale: 'task stuck in active/ -> scheduler sees it as in-progress forever, queue pollution'
       grep_mutation: 'task-api(.js)?s+claim'
       grep_counterpart: 'task-api(.js)?s+(complete|move)'
-      cited_failure: '.failure/pipeline/FAIL-003-queue-pollution.yaml'
+      cited_failure: 'historical: TASK_QUEUE pollution (FAIL-003, removed with the retired pipeline)'
 
     - pair: dom_event_listener
       mutation: 'addEventListener'

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

@@ -828,12 +828,9 @@ grep -E "^## (色彩系統|字體規範|佈局系統|交互設計)" dev/DESIGN_S
 
 執行任務前，檢查相關失敗模式（遵循 AGT-005 規則）：
 
-```powershell
-# 檢查 Designer 相關失敗模式
-.\.failure\tools\check_failures.ps1 -AgentType "designer"
-
-# 檢查設計相關失敗模式
-.\.failure\tools\check_failures.ps1 -ScopePath "dev/DESIGN_SPEC.md"
+```bash
+# 讀索引，再 Grep 與任務 scope 相關的失敗記錄
+Grep pattern="dev/DESIGN_SPEC.md|關鍵字" path=".failure/"
 ```
 
 ### 中文溝通