tarrragon/bulk-evaluate

子任務拆分與 Context 卸載工具

例外情況的批次計算公式: references/context-budget-formula.md

核心概念

問題：主線程的 context 有限。當一個任務需要讀取大量資料（N 個檔案、N 個模組、N 個報告），全部由主線程處理會溢出 context。

解法：把「讀取 + 分析 + 記錄」整包卸載給 Agent，主線程只負責拆分和統計。

關鍵設計：Ticket 既是任務指派，也是分析報告的載體。Agent 把結論直接寫入子 Ticket，主線程不接收完整內容 — 只看 Ticket 狀態和摘要統計。

傳統模式（主線程 context 溢出）:
  主線程讀取 N 個檔案 → 分析 → 產出報告 → context 爆炸

卸載模式（本 Skill）:
  主線程建立 N 個子 Ticket → 派發 Agent → Agent 寫入 Ticket → 主線程只看統計

適用場景

| 場景 | 子任務單位 | 每個子 Ticket 的內容 | |------|-----------|-------------------| | Agent/Skill 合規掃描 | 1 個定義檔案 | 評估結論 + 具體問題 | | 規則一致性檢查 | 1 個規則檔案 | 衝突發現 + 建議修正 | | 測試品質批量審查 | 1 個測試檔案/目錄 | 品質評分 + 改善建議 | | 大型重構影響分析 | 1 個模組/目錄 | 影響範圍 + 遷移方案 | | 多模組效能掃描 | 1 個效能熱點 | 瓶頸分析 + 優化建議 |

通用判斷：只要任務可以表述為「對 N 個獨立單位各做一次相同的分析」，就適用本 Skill。

與 /parallel-evaluation 的區別

| 維度 | /parallel-evaluation | /bulk-evaluate | |------|----------------------|-----------------| | 並行軸 | N 個視角 x 1 組目標 | 1 個標準 x N 個單位 | | 產出物 | 彙整報告（回到主線程） | N 個子 Ticket（不回主線程） | | Context 影響 | 主線程接收彙整結果 | 主線程只看統計摘要 | | 目的 | 多角度快速評估 | 批量處理 + context 卸載 |

核心流程（5 步）

Step 1: 識別子任務單位

確定每個子任務的處理單位和分析標準。

問自己：
1. 這個任務可以拆成幾個「對 X 做同一件事」的子任務？
2. 每個子任務的輸入是什麼？（一個檔案？一個模組？一個報告？）
3. 每個子任務的產出寫在哪？（Ticket 的哪個欄位？）
4. 分析標準是什麼？（參考文件？檢查清單？評估維度？）

Step 2: 建立 Ticket 結構

/ticket create → 父 Ticket（匯總任務，type: ANA）
  |-- /ticket create --parent → 子 Ticket 1（單位 A 的分析）
  |-- /ticket create --parent → 子 Ticket 2（單位 B 的分析）
  └── ...

每個子 Ticket 的驗收條件統一為:

• [ ] 已讀取目標內容
• [ ] 已對照分析標準完成檢查
• [ ] 結論已寫入本 Ticket
• [ ] 具體發現已列出（如有）

Step 3: 派發策略（單一職責原則）

預設: 1 個子任務 = 1 個 Agent

59 個評估目標 → 59 個獨立 Agent
每個 Agent 只負責 1 個目標

為什麼不批次處理:

| 維度 | 批次處理 | 1:1 派發 | |------|---------|---------| | 認知負擔 | Agent 需同時理解多個目標 | 只專注一個目標 | | 判斷品質 | 目標間資訊互相干擾 | 零干擾，判斷最精準 | | 失敗隔離 | 一批失敗影響多個子任務 | 單點失敗不擴散 |

這就是 context 卸載的核心目的：讓每個 process 的任務目標清晰明確，避免額外資訊干擾判斷。

例外：僅當平台限制無法派發足夠 Agent 時，才參考 references/context-budget-formula.md 計算合理批次大小。

Step 4: 並行派發

每個 Agent 的 prompt 包含：

• 分析標準（參考文件路徑）
• 負責的 1 個子 Ticket（ID + 對應的輸入內容路徑）
• 產出要求（結論直接寫入子 Ticket）

Agent 不需要知道：其他目標的存在、總共有幾個子任務、其他 Agent 的結論。

Agent 類型選擇:

| 需要寫入 Ticket | 推薦 Agent | |----------------|-----------| | 是 | general-purpose | | 否（只讀分析） | Explore / Plan |

Step 5: 彙整統計

所有 Agent 完成後，主線程只做統計（不讀取子 Ticket 全文）：

## 批量評估結果

**父 Ticket**: {ID}  **子任務總數**: {N}  **完成**: {M}/{N}

| 結論類別 | 數量 | 佔比 |
|---------|------|------|
| [類別 A] | X | X% |
| [類別 B] | X | X% |

### 需關注的子任務
| # | 子 Ticket | 結論 | 簡要 |
|---|----------|------|------|

更新父 Ticket 狀態，流程結束。

執行範例

範例: 59 個 Agent/Skill 合規掃描

Step 1: 子任務單位 = 每個 agent/skill 定義檔案
        分析標準 = design-guide (~25KB)
Step 2: 父 Ticket + 59 個子 Ticket
Step 3: 預設 1:1 → 59 個獨立 Agent
Step 4: 並行派發 59 個 general-purpose Agent，各處理 1 個子 Ticket
        每個 Agent 只讀取: design-guide + 自己負責的 1 個定義檔案
Step 5: 統計 59 個子 Ticket 結論 → 更新父 Ticket

主線程 context 消耗: 只有 Step 2（建 Ticket）和 Step 5（統計），不讀取 59 個定義檔案。 每個 Agent context 消耗: ~25KB 標準 + ~17KB 目標 = ~42KB，遠低於 context 上限。

相關文件

• references/context-budget-formula.md - 例外情況的批次計算公式
• .claude/skills/parallel-evaluation/SKILL.md - 多視角並行評估（正交工具）
• .claude/rules/guides/parallel-dispatch.md - 並行派發指南
• .claude/rules/guides/task-splitting.md - 任務拆分指南

---

Last Updated: 2026-03-02 Version: 1.0.0