🔗 重要備忘 #101

PendingMemo 與 Todo-Driver 整合機制

📅 2026-04-16  |  todo-driver PendingMemo 整合機制
🎯 問題核心

當主公說「記錄下三個方案 先執行A」→ 由貞立即執行 → 完成,但存在三個隱患:

⚖️ 有無 PendingMemo 的差異對比
❌ 無 PendingMemo(舊做法)
主公:記錄下三個方案 先執行A
由貞:執行中...
由貞:✅ 完成

todo-driver 看到的:
「無相關待辦記錄」

問題:不知道主公說過這件事
無法統計、無法追溯決策
✅ 有 PendingMemo(改進後)
主公:記錄下三個方案 先執行A
由貞:📝 創建 MEMO-004 進行中...
由貞:✅ 完成,狀態更新已完成

todo-driver 看到的:
✅ 今日已完成 #004
- 三方案分析 → 執行方案A
- 耗時:15分鐘
⚡ 方案一:強制記錄機制(推薦)

核心原則:任何多步驟任務,執行前必須創建 PendingMemo

主公:「記錄下三個方案 先執行A」
     ↓
Step 1: 立即創建 PendingMemo(MEMO-004)→ 狀態:待確認
     ↓
Step 2: 更新狀態為「進行中」→ 標記執行方案A + 記錄開始時間
     ↓
Step 3: 執行方案A → 每完成子步驟更新 progress
     ↓
Step 4: 完成 → 標記已完成 + 記錄耗時 + 生成摘要
     ↓
Step 5: todo-driver 可見 → 統計/追溯/報告全部可用
🔍 方案二:自動化監管(todo-driver 掃描邏輯)
function scanAllTodos() {
  // 1. 讀取正式待辦庫
  todos.push(...readPendingData());

  // 2. 讀取 PendingMemo(Phase 3 新增)
  const memos = readPendingMemo();

  // 3. 分類處理
  memos.filter(m => m.status === '進行中')  → 優先顯示(🔴)
  memos.filter(m => m.status === '已完成')  → 今日完成區(✅)
  memos.filter(m => m.status === '待確認')  → 待處理區(📋)
}

todo-driver 整合後的輸出示例

🔥 TED 待辦追蹤 - 2026-04-16

════════════════════════════════
🚨 進行中(來自對話)
════════════════════════════════
MEMO-005  Phase 3 todo-driver 整合
  進度:1/4 步驟 · 已耗時:5分鐘

════════════════════════════════
📋 待處理(來自正式庫)
════════════════════════════════
PENDING-005  待辦採集自動化
PENDING-007  pendingdata 驗證方案

════════════════════════════════
✅ 今日已完成(來自對話)
════════════════════════════════
MEMO-004  HTML報告導航欄 · 15分鐘
🔄 方案三:中斷恢復機制
[Session 重啟後,主公執行 todo-driver]

todo-driver 掃描發現「進行中」的 Memo:
┌─────────────────────────────────────┐
│ ⚠️  發現未完成的待辦                │
│ MEMO-004  HTML報告導航欄問題        │
│ 最後狀態(07:30):                 │
│ ✅ 創建 report-viewer.html          │
│ ✅ 設計 iframe 載入機制             │
│ ⏳ 部署到 workskm(未完成)          │
│                                     │
│ 是否:[1] 繼續執行 [2] 標記完成     │
│       [3] 取消此待辦                │
└─────────────────────────────────────┘
🏗️ 關鍵設計決策
📋 整合機制總結
機制作用
🔴 強制創建任何多步驟任務執行前必須創建 Memo
📊 狀態追蹤執行前/中/後都有明確狀態記錄
🔗 雙源整合todo-driver 同時讀取 PendingData + PendingMemo
🔄 斷點恢復中斷後可從 Memo 恢復,不遺漏
定時掃描Automation 定期檢查,主動提醒超時
「沒有 Memo 記錄的任務,等於沒有執行過」