- name
- ideas2tasks
- description
- |
- metadata
- emoji
- 📋
- version
- 2.1.0
- last_update
- 2026-04-12
ideas2tasks — 想法轉敏捷任務
核心概念
將零散的想法（ideas）系統化轉為可執行的專案任務（tasks），搭配虛擬 Scrum 團隊成員分工執行。
📂 目錄結構
/Users/claw/Ideas/ # 臨時想法存放區
├── *.txt # 待處理的 idea 檔案
└── _done/ # 已處理歸檔區（自動移入）
/Users/claw/Tasks/ # 專案任務區
└── <project-name>/
├── README.md # 專案概覽、成員分工、進度
└── tasks/
├── T001.md # 個別任務檔案
├── T002.md
└── ...👥 團隊成員
| 角色 | 名稱 | OpenClaw Agent ID | Workspace |
|---|---|---|---|
| Planner | 豪（用戶本人） | main | /Users/claw/.qclaw/workspace/ |
| Coder 1 | 碼農 1 號 | agent-coder1 | ~/.qclaw/workspace-coder1/ |
| Coder 2 | 碼農 2 號 | agent-coder2 | ~/.qclaw/workspace-coder2/ |
| DocWriter | 安安 | agent-ann | ~/.qclaw/workspace-ann/ |
| Reviewer | 樂樂 | agent-lele | ~/.qclaw/workspace-lele/ |
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/<project-name>/README.md
/Users/claw/Tasks/<project-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/<filename>.txt /Users/claw/Ideas/_done/📝 Task 檔案格式
每個 task md 檔案格式：
---
id: T001
project: <project-name>
title: <任務標題>
assignee: <成員名稱>
priority: high|medium|low
status: pending|in-progress|review|done
created: YYYY-MM-DD
updated: YYYY-MM-DD
---
## 描述
<任務詳細說明>
## 完成條件
- [ ] <具體可驗證的條件 1>
- [ ] <具體可驗證的條件 2>
## 產出
<預期產出物：腳本、文檔、配置等>
## 備註
<補充說明>📊 專案 README 格式
# <專案名稱>
## 概覽
<專案簡述>
## 團隊分工
| 角色 | 成員 | 負責 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 執行：
- 執行
scripts/lifecycle.py（掃描 → 分類 → 彙整摘要） - 結果寫入
scripts/lifecycle_status.json（供 AI 讀取） - 有待處理 tasks → 發送摘要到 Telegram，請豪確認
- 無新 idea → 安靜（不通知）
⚠️ 重要規則
- 專案命名必須先確認 — 不可未確認就直接建立目錄
- Task 拆分上限 10 個 — 超過需說明原因並等確認
- 已標記 done 的 idea task — 檔案內含 "done" 的行視為已完成，整體仍需分析是否還有未完成項
- 歸檔不刪除 — 移到
_done/而非刪除 - 空檔案跳過 — 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/<project-name>
# 手動標記 task 完成（同時同步 idea 檔）
python3 task_completion_hook.py /Users/claw/Tasks/<project>/tasks/T001.md詳見：docs/STATUS_SYNC_FIX.md