ideas2tasks — 想法轉敏捷任務

核心概念

將零散的想法（ideas）系統化轉為可執行的專案任務（tasks），搭配虛擬 Scrum 團隊成員分工執行。

📂 目錄結構

/Users/claw/Ideas/           # 臨時想法存放區
  ├── *.txt                  # 待處理的 idea 檔案
  └── _done/                 # 已處理歸檔區（自動移入）

/Users/claw/Tasks/           # 專案任務區
  └── \x3Cproject-name>/
      ├── README.md          # 專案概覽、成員分工、進度
      └── tasks/
          ├── T001.md        # 個別任務檔案
          ├── T002.md
          └── ...

👥 團隊成員

Spawn 方式：sessions_spawn(agentId="agent-ann") 等，詳見各成員的 IDENTITY.md/SOUL.md。

🔄 完整流程

步驟 1：掃描 Ideas

掃描 /Users/claw/Ideas/*.txt，排除 _done/ 子目錄。 空檔案（0 bytes）跳過不處理。

步驟 2：分析與分類

閱讀每個 idea 檔案的內容，判斷：

• 歸屬哪個專案（新專案或已有專案）
• 涉及哪些技術領域
• 優先級（高/中/低）

步驟 3：拆分 Tasks

• 每個 idea 最多拆成 10 個 tasks
• 若超過 10 個，先說明原因和拆分方式，等用戶確認後再拆
• 每個 task 應具備明確的完成條件

步驟 4：專案命名

• 從 idea 內容提取關鍵字作為專案名稱
• 發給用戶確認後才執行
• 命名風格：英文、簡短、見名知義（如 gold-monitor、backup-system）

步驟 5：建立專案結構

確認後建立目錄和檔案：

/Users/claw/Tasks/\x3Cproject-name>/README.md
/Users/claw/Tasks/\x3Cproject-name>/tasks/T001.md ~ T0xx.md

步驟 6：分配任務

根據 task 類型分配給對應成員：

• 開發/腳本 → Coder 1 或 Coder 2
• 文檔撰寫 → DocWriter
• 驗收/審核 → Reviewer
• 規劃/協調 → Planner（豪）

步驟 7：歸檔 Idea 檔案

將已處理的 .txt 移到 /Users/claw/Ideas/_done/：

mkdir -p /Users/claw/Ideas/_done
mv /Users/claw/Ideas/\x3Cfilename>.txt /Users/claw/Ideas/_done/

📝 Task 檔案格式

每個 task md 檔案格式：

---
id: T001
project: \x3Cproject-name>
title: \x3C任務標題>
assignee: \x3C成員名稱>
priority: high|medium|low
status: pending|in-progress|review|done
created: YYYY-MM-DD
updated: YYYY-MM-DD
---

## 描述
\x3C任務詳細說明>

## 完成條件
- [ ] \x3C具體可驗證的條件 1>
- [ ] \x3C具體可驗證的條件 2>

## 產出
\x3C預期產出物：腳本、文檔、配置等>

## 備註
\x3C補充說明>

📊 專案 README 格式

# \x3C專案名稱>

## 概覽
\x3C專案簡述>

## 團隊分工
| 角色 | 成員 | 負責 Tasks |
|------|------|-----------|
| Planner | 寶寶 | T001, T005 |
| Coder 1 | 碼農 1 號 | T002, T003 |
| DocWriter | 安安 | T004 |
| Reviewer | 樂樂 | 全部 |

## 進度
- 總 tasks: N
- 已完成: X
- 進行中: Y
- 待處理: Z

## Task 列表
| ID | 標題 | 負責人 | 狀態 | 優先級 |
|----|------|--------|------|--------|
| T001 | ... | ... | pending | high |

⏰ Lifecycle（每日定時）

cron 每天 09:00 Asia/Taipei 執行：

1. 執行 scripts/lifecycle.py（掃描 → 分類 → 彙整摘要）
2. 結果寫入 scripts/lifecycle_status.json（供 AI 讀取）
3. 有待處理 tasks → 發送摘要到 Telegram，請豪確認
4. 無新 idea → 安靜（不通知）

⚠️ 重要規則

1. 專案命名必須先確認 — 不可未確認就直接建立目錄
2. Task 拆分上限 10 個 — 超過需說明原因並等確認
3. 已標記 done 的 idea task — 檔案內含 "done" 的行視為已完成，整體仍需分析是否還有未完成項
4. 歸檔不刪除 — 移到 _done/ 而非刪除
5. 空檔案跳過 — 0 bytes 的 .txt 不處理

🔧 狀態同步系統（v2.1.0）

核心問題修復

問題： 兩套狀態系統不同步

• Ideas/*.txt 的 task.N done 標記
• Tasks/*/tasks/T*.md 的 Status: done
• Agent 完成後只改 T*.md → idea 檔未同步 → 重複建立

解決方案：

1. 統一狀態讀取（task_status.py）

• 正規化讀取（忽略大小寫、emoji、空白）
• 統一寫入格式：Status: pending / in-progress / done

2. 狀態同步器（sync_status.py）

• Task 完成 → 自動更新 idea 檔的 task.N done 標記
• 提供手動同步工具：python3 sync_status.py --fix-history

3. Task 完成掛鉤（task_completion_hook.py）

• Agent 完成時呼叫
• 同步更新 Tasks/ 和 Ideas/ 的狀態
• 用法：python3 task_completion_hook.py /path/to/T001.md

4. Lifecycle 增強

• 優先看 Tasks/ 目錄的實際狀態
• 合併判斷：Tasks/ 已 done → 覆蓋 idea 檔狀態

維護命令

# 檢查同步狀態（預覽）
python3 sync_status.py --dry-run

# 修復歷史不一致
python3 sync_status.py --fix-history

# 掃描專案狀態
python3 task_status.py /Users/claw/Tasks/\x3Cproject-name>

# 手動標記 task 完成（同時同步 idea 檔）
python3 task_completion_hook.py /Users/claw/Tasks/\x3Cproject>/tasks/T001.md

詳見：docs/STATUS_SYNC_FIX.md