子任務拆分與 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 → 主線程只看統計

適用場景

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

與 /parallel-evaluation 的區別

核心流程（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 個目標

為什麼不批次處理:

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

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

Step 4: 並行派發

每個 Agent 的 prompt 包含：

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

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

Agent 類型選擇:

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 - 任務拆分指南