如何在有限的執行中實作複雜功能

大型或複雜的功能通常能順利通過 /speckit.specify、/speckit.plan 與 /speckit.tasks,卻在實作階段逐漸失控。在漫長的 /speckit.implement 執行過程中,代理可能開始遺失計畫脈絡、忽略任務或產生幻覺——通常就發生在上下文壓縮被觸發之前或之後。

根本原因是上下文視窗耗盡。當單次實作試圖將整個功能都納入上下文時,模型會隨著視窗填滿而退化。解法是為每次執行劃定範圍,讓它始終遠低於上下文上限。

/speckit.implement 命令接受自由格式的使用者輸入,代理在繼續之前必須加以考量。這表示你無需變更任何工具,就能為每次執行劃定範圍。

選項 1:限制每次呼叫執行的任務數量

不要讓 /speckit.implement 一次跑完所有任務,而是讓它提早停止:

/speckit.implement only execute tasks T001-T010, then stop and report progress

或依階段劃定範圍:

/speckit.implement only execute the Setup phase, then stop

由於已完成的任務會在 tasks.md 中標記為 [X],下一次 /speckit.implement 呼叫會從你中斷的位置接續。這能讓每次執行都遠低於上下文上限。

選項 2:指示代理使用子代理

如果你的程式代理支援子代理(例如 GitHub Copilot CLI 或 VS Code 的 GitHub Copilot 擴充功能),你可以指示 /speckit.implement 將個別任務委派出去:

/speckit.implement delegate each parallel [P] task to a sub-agent

每個子代理會取得聚焦的上下文——一項任務加上相關的計畫摘錄——而非完整的功能上下文,因此主工作階段永遠不會觸發壓縮。

選項 3:兩者並用

對於非常大型的功能,可同時結合範圍劃定與委派:

/speckit.implement execute only the Core phase, delegate [P] tasks to sub-agents

選項 4:將功能拆解為較小的規格

當單一階段就足以壓垮上下文時,請將功能拆解為可獨立規格化的子功能。每個子功能都有自己的 spec.md、plan.md 與 tasks.md,並走完各自的 specify/plan/tasks/implement 循環。

這就是「規格的規格」作法:第一輪先將龐大的功能拆解為較小、自成一體的規格,每份規格都能在不壓垮模型的前提下實作。此作法的額外成本最高,因此只應保留給以其他方式都難以處理的功能。

完整程序請參閱規格的規格——如何執行路線圖階段、如何組織路線圖成品、如何將子規格連結回路線圖,以及一個實際範例。

該選擇哪種作法

作法 最適用於
限制為 N 項任務或一個階段 任何代理;最簡單;無需子代理支援
子代理委派 支援子代理的代理;最大化平行處理
結合範圍劃定與委派 在支援子代理的代理上處理大型功能;兼顧兩者
拆解為較小的規格 當單一階段就足以壓垮上下文時

在大多數情況下,限制每次執行的任務範圍是最簡單的解法。當你的代理支援子代理且你想要平行處理時,採用子代理委派;只有當單一階段仍然過大、無法在一次執行中處理時,才拆解為較小的規格。