kenaz 0.3.18 → 0.3.19

package/core/.claude/skills/legacy_dev/SKILL.md

@@ -1,202 +0,0 @@
----
-name: Legacy Dev Agent
-description: 開發協調 Agent（使用新任務系統 .collaboration/tasks/）— 排程器自動呼叫，持續迭代
----
-
-# Legacy Dev Agent (開發協調 Agent)
-
-## 角色
-你是一個高度自治的 **開發協調 Agent**。你的核心職責是基於規格文件，按照任務清單，持續、迭代地推進開發進度。**當需要完成複雜子任務時，你必須調用專業 Agent 來協助執行任務。**
-
-## 任務系統
-
-**本 Agent 使用新任務系統（`.collaboration/tasks/`），不使用舊系統（`dev/pipeline/`）。**
-
-### 目錄結構
-```
-.collaboration/tasks/
-├── backlog/     # 待處理（原 pending）
-├── active/      # 進行中（原 in_progress）
-├── done/        # 已完成（原 completed）
-├── blocked/     # 阻塞中
-├── cancel/      # 已取消
-└── archived/    # 已封存
-```
-
-### 任務 API
-所有任務操作必須使用 `node .collaboration/core/task-api.js`：
-
-```bash
-# 列出待辦任務
-node .collaboration/core/task-api.js list --status pending
-
-# 取得任務詳情
-node .collaboration/core/task-api.js get TASK_XXX
-
-# 認領任務（backlog → active）
-node .collaboration/core/task-api.js claim TASK_XXX
-
-# 完成任務（active → done）
-node .collaboration/core/task-api.js complete TASK_XXX
-
-# 阻塞任務
-node .collaboration/core/task-api.js move TASK_XXX blocked
-
-# 查看統計
-node .collaboration/core/task-api.js stats
-```
-
-### YAML 欄位（v3.3）
-| 欄位 | 說明 |
-|------|------|
-| `id` | TASK_XXX |
-| `title` | 任務標題 |
-| `priority` | P0 / P1 / P2 / P3 |
-| `role` | designer / developer / frontend / pm / sre / team_developer / team_strategy |
-| `rigor` | high（需 team）/ medium / low |
-| `tags` | [doc, code, plan, fix, refactor, test, design, review] |
-| `dependencies` | 依賴的 TASK_ID 列表 |
-| `scope_paths` | 影響的檔案/目錄 |
-| `requirements` | 需求列表 |
-| `acceptance_criteria` | 驗收標準 |
-
----
-
-## 任務
-1. **閱讀規格**：每次執行前，讀取 `dev/PRODUCT_SPEC.md` 確定總體目標。
-2. **管理進度**：使用 task-api.js 管理任務狀態。
-3. **執行任務**：從 backlog 中選取最優先任務並完成。
-4. **調用專業 Agent**：根據任務性質，讀取並調用對應的專業 Agent Skill。
-5. **日誌記錄**：寫入執行日誌至 `.formation/logs/legacy/`。
-
-## 文件路徑
-* **規格文件**：`dev/PRODUCT_SPEC.md`
-* **任務目錄**：`.collaboration/tasks/` (backlog / active / done / blocked)
-* **任務 API**：`node .collaboration/core/task-api.js`
-* **任務日誌**：`.formation/logs/legacy/`
-
----
-
-## 專業 Agent 資源庫
-
-當任務涉及特定專業領域時，**必須讀取 `.formation/legacy/` 下對應的 Skill YAML**，按照其 `role`、`behavior`、`workflow` 執行。
-
-### 可用 Skill 清單
-
-| Skill | 路徑 | 適用場景 |
-|-------|------|---------|
-| **Product Manager** | `.formation/legacy/pm.yaml` | 需求分析、PRD 撰寫、任務拆解 |
-| **Designer** | `.formation/legacy/designer.yaml` | UI/UX 設計、設計規範、視覺稿 |
-| **Backend Engineer** | `.formation/legacy/backend.yaml` | API 設計、資料庫、Python |
-| **Frontend Developer** | `.formation/legacy/frontend.yaml` | React/TypeScript、組件實作、UI |
-| **QA Engineer** | `.formation/legacy/qa.yaml` | 測試策略、品質保證、缺陷追蹤 |
-| **SRE Agent** | `.formation/legacy/sre.yaml` | Supabase、部署、監控、RLS |
-
-### 任務 role 對應表
-
-| 任務 `role` 欄位 | 讀取 Skill |
-|-----------------|-----------|
-| `pm` | `.formation/legacy/pm.yaml` |
-| `designer` | `.formation/legacy/designer.yaml` |
-| `developer`, `backend` | `.formation/legacy/backend.yaml` |
-| `frontend` | `.formation/legacy/frontend.yaml` |
-| `qa` | `.formation/legacy/qa.yaml` |
-| `sre` | `.formation/legacy/sre.yaml` |
-
----
-
-## 工作流程
-
-### 1. 進度管理
-
-**每次任務啟動時，必須先執行此功能。**
-
-1. **查詢待辦任務**：
-   ```bash
-   node .collaboration/core/task-api.js list --status pending
-   ```
-
-2. **選取最優先任務**：
-   - P0 > P1 > P2 > P3
-   - 同優先級選 ID 最小的
-   - 跳過依賴未滿足的任務（檢查 `dependencies` 中的任務是否都在 `done/` 中）
-
-3. **認領任務**：
-   ```bash
-   node .collaboration/core/task-api.js claim TASK_XXX
-   ```
-
-4. **識別所需 Agent**：
-   - 分析 `role` 欄位和任務內容，確定調用哪個專業 Agent
-
-### 2. Agent 調用
-
-1. **讀取 Skill YAML**：
-   ```
-   Read(".formation/legacy/{role}.yaml")
-   ```
-   根據任務的 `role` 欄位選擇對應的 skill 檔案。
-
-2. **切換角色模式**：按照 YAML 中的 `role`、`behavior`、`workflow` 執行
-
-3. **執行專業任務**：以該 Skill 的身份完成任務
-
-4. **返回協調模式**：任務完成後返回 Legacy Dev Agent 角色
-
-### 3. 任務執行與完成
-
-1. **執行任務**
-
-2. **建立 Git Commit**：
-   - 格式：`[TASK_XXX] 簡短描述`
-   - 每個任務至少 1 個 commit
-
-3. **完成任務**：
-   ```bash
-   node .collaboration/core/task-api.js complete TASK_XXX
-   ```
-
-4. **撰寫日誌**：
-   - 寫入 `.formation/logs/legacy/YYYYMMDD_HHMMSS_TASK_XXX.md`
-   - 記錄：調用了哪些 Agent、執行過程、結果、Git commit hash
-
-5. **驗證**：
-   - 確認任務已從 `backlog/` 移至 `done/`
-   - 確認 Git commit 存在
-
----
-
-## 錯誤處理
-
-### 任務執行失敗時
-1. 將任務移至 blocked：
-   ```bash
-   node .collaboration/core/task-api.js move TASK_XXX blocked
-   ```
-2. 記錄失敗原因到日誌
-3. 繼續處理下一個可執行任務
-
-### Agent 調用失敗時
-1. 確認 Skill 文件路徑正確
-2. 重新讀取 Skill 文件
-3. 如果問題持續，直接應用該 Agent 的核心職責邏輯
-
----
-
-## 執行範例
-
-### 排程器自動呼叫
-```
-排程器 → claude -p /legacy_dev --permission-mode acceptEdits
-         ↓
-Legacy Dev Agent 啟動
-         ↓
-1. node .collaboration/core/task-api.js list --status pending
-2. 選取 TASK_188 (P0, frontend)
-3. node .collaboration/core/task-api.js claim TASK_188
-4. Read(".formation/legacy/frontend.yaml")
-5. 切換 Frontend Developer 模式，執行任務
-6. git commit -m "[TASK_188] 實作搜尋功能"
-7. node .collaboration/core/task-api.js complete TASK_188
-8. 寫入日誌
-```

package/core/.claude/skills/sunny/SKILL.md

@@ -1,74 +0,0 @@
----
-name: sunny
-description: 內部系統開發模式，繞過 CLAUDE.md 工作流程限制
----
-
-# Sunny - 內部系統開發 Agent
-
-## 角色
-
-你是 **Sunny**，專門處理 Kenaz AI 內部系統開發的 Agent。
-
-當用戶需要開發或修改系統本身（如 .collaboration、.rule、.formation 等）時，正常的工作流程規則會產生衝突。你的存在就是為了解決這個問題。
-
-## 規則優先級
-
-```
-1. .rule/*          ← 絕對遵守（永不違反）
-2. .system/sunny/*  ← 你的專屬規則
-3. CLAUDE.md        ← 可選擇性忽略
-```
-
-**首次執行時，必須讀取**：`.system/sunny/RULES.json`
-
-## 你可以做的事
-
-- ✅ 直接修改 `.collaboration/`、`.failure/`、`.rule/`、`.formation/` 等系統目錄
-- ✅ 直接使用 Task 工具
-- ✅ 跳過「展示計劃」步驟，直接執行
-- ✅ 不遵循 PM → Design → Dev 流程
-- ✅ 修改 CLAUDE.md 本身
-
-## 你絕對不能做的事
-
-- ❌ 違反 `.rule/` 中的任何規則
-- ❌ 在專案目錄外輸出檔案（GEN-007）
-- ❌ 違反安全相關規則（SEC-*）
-- ❌ 破壞資料完整性（DATA-*）
-
-## 核心心態
-
-**完美達成 > 一切**
-
-- ✅ 只關注：能不能完美達成目標
-- ✅ 策略討論聚焦：可行性、不可行性、如何修正策略
-- ❌ 不考慮成本（token、時間、API 費用）— 成本都是小事
-- ❌ 禁止因成本考量進入保守狀態
-
-## 工作風格
-
-1. **簡潔** - 減少冗餘說明，直接執行
-2. **高效** - 不需要多輪確認，直接完成任務
-3. **透明** - 完成後簡要回報做了什麼
-
-## 啟動提示
-
-當用戶使用 `/sunny` 時，回應：
-
-```
-☀️ Sunny 模式已啟動
-
-規則優先級：.rule/* > .system/sunny/* > CLAUDE.md
-可忽略：工作流程、團隊調用、Pipeline 規則
-絕對遵守：GEN-007、SEC-*、DATA-*
-
-請告訴我要做什麼？
-```
-
-## 退出
-
-當用戶說「退出」、「exit」或工作完成時，回應：
-
-```
-☀️ Sunny 模式已結束，恢復正常工作流程。
-```

package/core/.collaboration/cli/commands/assign.js

@@ -1,39 +0,0 @@
-/**
- * assign 命令 - 分配任務給他人
- */
-
-const { TaskAPI } = require('../../core/task-api.js');
-const { getPositional, parseArgs } = require('../utils/arg-parser');
-const { success, error } = require('../utils/output');
-
-module.exports = {
-  name: 'assign',
-  description: '分配任務給他人',
-  options: ['--to'],
-
-  async execute(args) {
-    const taskId = getPositional(args, 0);
-    const { to: assignee } = parseArgs(args, ['to']);
-
-    if (!taskId) {
-      error('缺少任務 ID');
-      return 1;
-    }
-
-    if (!assignee) {
-      error('缺少 --to 參數');
-      return 1;
-    }
-
-    try {
-      const api = new TaskAPI();
-      const task = await api.claimTask(taskId, assignee);
-      success(`任務已分配: ${task.id}`);
-      console.log(`分配給: ${assignee}`);
-      return 0;
-    } catch (err) {
-      error(`分配失敗: ${err.message}`);
-      return 1;
-    }
-  }
-};

package/core/.collaboration/cli/commands/claim.js

@@ -1,33 +0,0 @@
-/**
- * claim 命令 - 認領任務
- */
-
-const { TaskAPI } = require('../../core/task-api.js');
-const { getPositional } = require('../utils/arg-parser');
-const { success, error } = require('../utils/output');
-
-module.exports = {
-  name: 'claim',
-  description: '認領任務',
-  options: [],
-
-  async execute(args) {
-    const taskId = getPositional(args, 0);
-    if (!taskId) {
-      error('缺少任務 ID');
-      return 1;
-    }
-
-    try {
-      const api = new TaskAPI();
-      const task = await api.claimTask(taskId);
-      success(`任務已認領: ${task.id}`);
-      console.log(`分配給: ${task.assigned_to.name}`);
-      console.log(`狀態: ${task.status}`);
-      return 0;
-    } catch (err) {
-      error(`認領失敗: ${err.message}`);
-      return 1;
-    }
-  }
-};

package/core/.collaboration/cli/commands/complete.js

@@ -1,44 +0,0 @@
-/**
- * complete 命令 - 標記任務為完成
- */
-
-const { TaskAPI } = require('../../core/task-api.js');
-const { getPositional, parseArgs } = require('../utils/arg-parser');
-const { success, error } = require('../utils/output');
-
-module.exports = {
-  name: 'complete',
-  description: '標記任務為完成',
-  options: ['--actual-hours'],
-
-  async execute(args) {
-    const taskId = getPositional(args, 0);
-    if (!taskId) {
-      error('缺少任務 ID');
-      return 1;
-    }
-
-    const parsed = parseArgs(args, ['actual-hours']);
-
-    try {
-      const api = new TaskAPI();
-
-      const options = {};
-      if (parsed['actual-hours']) {
-        options.actual_hours = parseFloat(parsed['actual-hours']);
-      }
-
-      const task = await api.completeTask(taskId, options);
-      success(`任務已完成: ${task.id}`);
-      console.log(`執行者: ${task.executed_by.name}`);
-      console.log(`完成時間: ${task.executed_by.timestamp}`);
-      if (task.actual_hours) {
-        console.log(`實際工時: ${task.actual_hours} 小時`);
-      }
-      return 0;
-    } catch (err) {
-      error(`完成失敗: ${err.message}`);
-      return 1;
-    }
-  }
-};

package/core/.collaboration/cli/commands/create.js

@@ -1,110 +0,0 @@
-/**
- * create 命令 - 建立新任務
- *
- * 支援所有 task-api.js createTask() 欄位：
- *   基本：--title, --description, --priority, --role, --complexity, --rigor, --branch
- *   陣列（逗號分隔）：--tags, --deps, --scope-paths, --feature-ids, --keywords
- *   多值（可重複）：--requirements, --acceptance-criteria, --technical-notes
- *   數值：--estimated-hours
- *   文字：--source, --notes
- */
-
-const { TaskAPI } = require('../../core/task-api.js');
-const { parseArgs, parseCsv, parseMulti } = require('../utils/arg-parser');
-const { success, error } = require('../utils/output');
-
-module.exports = {
-  name: 'create',
-  description: '建立新任務',
-  options: [
-    '--title', '--description', '--priority', '--role',
-    '--tags', '--branch', '--complexity', '--rigor',
-    '--deps', '--scope-paths', '--estimated-hours',
-    '--requirements', '--acceptance-criteria', '--technical-notes',
-    '--feature-ids', '--keywords', '--source', '--notes'
-  ],
-
-  async execute(args) {
-    const parsed = parseArgs(args, [
-      'title', 'description', 'priority', 'role',
-      'branch', 'complexity', 'rigor',
-      'estimated-hours', 'source', 'notes'
-    ]);
-
-    if (!parsed.title) {
-      error('缺少 --title 參數');
-      return 1;
-    }
-
-    try {
-      const api = new TaskAPI();
-
-      // 逗號分隔的陣列欄位
-      const tags = parseCsv(args, 'tags');
-      const dependencies = parseCsv(args, 'deps');
-      const scopePaths = parseCsv(args, 'scope-paths');
-      const featureIds = parseCsv(args, 'feature-ids');
-      const keywords = parseCsv(args, 'keywords');
-
-      // 多值欄位（可重複 --flag "value1" --flag "value2"）
-      const requirements = parseMulti(args, 'requirements');
-      const acceptanceCriteria = parseMulti(args, 'acceptance-criteria');
-      const technicalNotes = parseMulti(args, 'technical-notes');
-
-      // 數值欄位
-      const estimatedHours = parsed['estimated-hours']
-        ? parseFloat(parsed['estimated-hours'])
-        : null;
-
-      const taskData = {
-        title: parsed.title,
-        description: parsed.description || '',
-        priority: parsed.priority || 'P2',
-        role: parsed.role || 'developer',
-        tags,
-        branch: parsed.branch || null,
-        complexity: parsed.complexity || 'medium',
-        rigor: parsed.rigor || 'medium',
-        dependencies,
-        scope_paths: scopePaths,
-        estimated_hours: estimatedHours,
-      };
-
-      // 多值欄位：僅在有值時傳入（避免覆蓋 API 預設）
-      if (requirements.length > 0) taskData.requirements = requirements;
-      if (acceptanceCriteria.length > 0) taskData.acceptance_criteria = acceptanceCriteria;
-      if (technicalNotes.length > 0) taskData.technical_notes = technicalNotes;
-
-      // 可選文字欄位
-      if (featureIds.length > 0) taskData.feature_ids = featureIds;
-      if (keywords.length > 0) taskData.keywords = keywords;
-      if (parsed.source) taskData.source = parsed.source;
-      if (parsed.notes) taskData.notes = parsed.notes;
-
-      const task = await api.createTask(taskData);
-
-      success(`任務已建立: ${task.id}`);
-      console.log(`Hash: ${task.hash}`);
-      console.log(`標題: ${task.title}`);
-      console.log(`優先級: ${task.priority}`);
-      console.log(`角色: ${task.role}`);
-      console.log(`嚴謹度: ${task.rigor}`);
-      console.log(`複雜度: ${task.complexity}`);
-      if (tags.length > 0) console.log(`標籤: ${tags.join(', ')}`);
-      if (task.branch) console.log(`分支: ${task.branch}`);
-      if (dependencies.length > 0) console.log(`依賴: ${dependencies.join(', ')}`);
-      if (scopePaths.length > 0) console.log(`範圍: ${scopePaths.join(', ')}`);
-      if (requirements.length > 0) console.log(`需求: ${requirements.length} 項`);
-      if (acceptanceCriteria.length > 0) console.log(`驗收標準: ${acceptanceCriteria.length} 項`);
-      if (technicalNotes.length > 0) console.log(`技術筆記: ${technicalNotes.length} 項`);
-      if (estimatedHours) console.log(`預估工時: ${estimatedHours}h`);
-      if (keywords.length > 0) console.log(`關鍵字: ${keywords.join(', ')}`);
-      console.log(`建立者: ${task.created_by.name}`);
-      console.log(`檔案路徑: ${task._file_path}`);
-      return 0;
-    } catch (err) {
-      error(`建立失敗: ${err.message}`);
-      return 1;
-    }
-  }
-};

package/core/.collaboration/cli/commands/get.js

@@ -1,83 +0,0 @@
-/**
- * get 命令 - 取得任務詳情
- */
-
-const { TaskAPI } = require('../../core/task-api.js');
-const { getPositional } = require('../utils/arg-parser');
-const { error } = require('../utils/output');
-
-// 可選載入 LockManager
-let LockManager = null;
-try {
-  LockManager = require('../../core/lock-manager.js').LockManager;
-} catch { /* 模組不存在，忽略 */ }
-
-module.exports = {
-  name: 'get',
-  description: '取得任務詳情',
-  options: [],
-
-  async execute(args) {
-    const taskId = getPositional(args, 0);
-    if (!taskId) {
-      error('缺少任務 ID');
-      return 1;
-    }
-
-    try {
-      const api = new TaskAPI();
-      const task = await api.getTask(taskId);
-
-      if (!task) {
-        error(`任務不存在: ${taskId}`);
-        return 1;
-      }
-
-      console.log('任務詳情:\n');
-      console.log(`ID:        ${task.id}`);
-      console.log(`標題:      ${task.title}`);
-      console.log(`描述:      ${task.description || '無'}`);
-      console.log(`狀態:      ${task.status}`);
-      console.log(`優先級:    ${task.priority}`);
-      console.log(`建立者:    ${task.created_by.name} (@${task.created_by.git_user})`);
-      console.log(`建立時間:  ${task.created_by.timestamp}`);
-
-      if (task.assigned_to) {
-        console.log(`分配給:    ${task.assigned_to.name} (@${task.assigned_to.git_user})`);
-        console.log(`分配時間:  ${task.assigned_to.timestamp}`);
-      }
-
-      if (task.executed_by) {
-        console.log(`執行者:    ${task.executed_by.name} (@${task.executed_by.git_user})`);
-      }
-
-      if (task.collaborators && task.collaborators.length > 0) {
-        console.log(`協作者:    ${task.collaborators.map(c => c.name).join(', ')}`);
-      }
-
-      console.log(`版本:      ${task._version || 1}`);
-      console.log(`來源:      ${task._source}`);
-
-      if (task._file_path) {
-        console.log(`檔案:      ${task._file_path}`);
-      }
-
-      // 檢查鎖定狀態（如果 LockManager 存在）
-      if (LockManager) {
-        const lockMgr = new LockManager();
-        const lockInfo = await lockMgr.getLockInfo(taskId);
-        if (lockInfo) {
-          console.log(`\n🔒 鎖定資訊:`);
-          console.log(`   鎖定者:    ${lockInfo.locked_by}`);
-          console.log(`   鎖定時間:  ${lockInfo.locked_at}`);
-          console.log(`   過期時間:  ${lockInfo.expires_at}`);
-        }
-      }
-
-      return 0;
-    } catch (err) {
-      error(`查詢失敗: ${err.message}`);
-      return 1;
-    }
-  }
-};

package/core/.collaboration/cli/commands/index.js

@@ -1,52 +0,0 @@
-/**
- * 命令註冊表
- */
-
-const commands = {
-  create: require('./create'),
-  list: require('./list'),
-  get: require('./get'),
-  claim: require('./claim'),
-  assign: require('./assign'),
-  transfer: require('./transfer'),
-  complete: require('./complete'),
-  lock: require('./lock'),
-  unlock: require('./unlock'),
-  rebuild: require('./rebuild'),
-  stats: require('./stats'),
-  search: require('./search'),
-};
-
-const CommandRegistry = {
-  /**
-   * 執行命令
-   * @param {string} name - 命令名稱
-   * @param {string[]} args - 參數
-   * @returns {Promise<number>} 退出碼
-   */
-  async execute(name, args) {
-    const cmd = commands[name];
-    if (!cmd) {
-      throw new Error(`未知命令: ${name}`);
-    }
-    return cmd.execute(args);
-  },
-
-  /**
-   * 取得所有命令
-   * @returns {Object}
-   */
-  getAll() {
-    return commands;
-  },
-
-  /**
-   * 取得命令名稱列表
-   * @returns {string[]}
-   */
-  list() {
-    return Object.keys(commands);
-  },
-};
-
-module.exports = { CommandRegistry };

package/core/.collaboration/cli/commands/list.js

@@ -1,51 +0,0 @@
-/**
- * list 命令 - 列出任務
- */
-
-const { TaskAPI } = require('../../core/task-api.js');
-const { parseArgs } = require('../utils/arg-parser');
-const { error } = require('../utils/output');
-
-module.exports = {
-  name: 'list',
-  description: '列出任務',
-  options: ['--status', '--assigned-to', '--priority'],
-
-  async execute(args) {
-    const { status, priority } = parseArgs(args, ['status', 'priority']);
-    const assignedTo = parseArgs(args, ['assigned-to'])['assigned-to'];
-
-    const query = {};
-    if (status) query.status = status;
-    if (assignedTo) query.assigned_to = assignedTo;
-    if (priority) query.priority = priority;
-
-    try {
-      const api = new TaskAPI();
-      const tasks = await api.queryTasks(query);
-
-      if (tasks.length === 0) {
-        console.log('沒有符合條件的任務');
-        return 0;
-      }
-
-      console.log(`找到 ${tasks.length} 個任務:\n`);
-
-      tasks.forEach(task => {
-        const assignee = task.assigned_to ? task.assigned_to.name : '未分配';
-        const source = task._source === 'new' ? '🆕' : '📦';
-        console.log(`${source} [${task.id}] ${task.title}`);
-        console.log(`   狀態: ${task.status} | 優先級: ${task.priority} | 分配給: ${assignee}`);
-        if (task.description) {
-          console.log(`   描述: ${task.description.substring(0, 60)}...`);
-        }
-        console.log('');
-      });
-
-      return 0;
-    } catch (err) {
-      error(`查詢失敗: ${err.message}`);
-      return 1;
-    }
-  }
-};