Community寫作與編輯github.com

dudashuai616/project-task-router

根據任務複雜度進行路由、階段規劃,以及為 Codex 和 AI 代理提供精簡的交接資訊。

project-task-router 是什麼?

專案任務路由器(Project Task Router)是一項 AI 代理技能,專為 Claude Code、Cursor 或 Codex 等程式碼代理設計,能夠根據任務複雜度智慧地規劃與路由工作。它透過避免在大型輸出之前進行不必要的結構,並使用基於檔案的交接而非冗長的對話記錄來維持連續性。該技能定義了四種任務複雜度等級(簡單、專注多步驟、多階段、長期運行),並提供具體引導,決定何時應在同一對話中繼續、何時應開始新對話、以及如何呈現路由卡。它強調建立真實來源鏈(source-of-truth chain),將每個持久性決策儲存在專案檔案中,並在對話之間建立精簡的交接資訊,以最小化背景負擔。此技能在需要時自動套用,並在不必要時避免過度複雜性,適合需要跨階段或跨對話管理複雜工作流程的開發人員。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add dudashuai616/project-task-router

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Project Task Router

在產生大型輸出前,將工作路由到最小可靠結構。透過專案檔案和精簡的交接資訊來維持連續性,而非使用舊的對話記錄。

執行複雜度門檻

以最不繁瑣的方式分類任務:

  • 簡單: 一個明確的結果,幾乎沒有依賴風險,且不需要持久的交接。直接執行,無須顯示計畫。
  • 專注多步驟: 一個主要交付項目,包含幾個相關步驟。給出一個簡短的 2-5 步計畫,並在同一對話中繼續。
  • 多階段: 多個不同的交付項目、不同的參考集,或明確的上游/下游依賴關係。在產生完整工作成果之前,提出階段和對話邊界。
  • 長期運行: 工作可能跨越多次對話、累積許多決策,或超出可靠的對話背景。在執行之前,建立真實來源、階段狀態和交接方法。

使用可觀察的證據,而不是假裝知道確切的剩餘背景百分比。警告信號包括:反覆修改、許多檔案或產出物、難以檢查早期約束、摘要顯示較早的輪次,以及階段轉換改變了所需參考集。

決定對話邊界

當工作高度耦合、迭代於同一個產出物,或可以在同一個小背景集下可靠完成時,請在同一個對話中繼續。

當至少滿足以下條件之一時,建議開始新對話:

  • 當前階段產生了一個穩定的產出物,將由另一個階段使用;
  • 下一個階段需要截然不同的檔案或專業知識;
  • 對某個交付項目進行獨立審查是有價值的;
  • 繼續下去會攜帶大量廢棄的探索、日誌或拒絕的草稿;
  • 一個精簡的基於檔案的交接可以安全地取代對話記錄。

不要機械地拆分。只有當新對話能減少背景負擔、重做工作或模糊性時,才有正當理由建議新對話。建議分開的對話並提供起始提示,但除非使用者明確要求,否則不要建立或分叉使用者擁有的任務。

呈現路由卡

對於多階段或長期運行的工作,暫停大量執行並呈現一個簡潔的路由卡,包含:

  1. 總體目標 — 一句話。
  2. 建議的階段 — 按依賴關係排序。
  3. 對話邊界 — 每個階段是相同還是新對話,附帶一行理由。
  4. 輸入 — 要讀取的上游檔案或已確認的決策;避免廣泛的專案掃描。
  5. 輸出 — 命名交付項目及其正確的專案位置。
  6. 完成條件 — 可觀察的完成標準。
  7. 交接更新 — 必須更新哪個狀態、決策或真實來源檔案。

如果分解在實質上改變了範圍或順序,請在執行後續階段之前獲得使用者的同意。當第一個階段已明確獲得授權時,在呈現架構後僅開始該階段。

維護真實來源鏈

將對話視為工作空間,而非權威檔案庫。

  • 遵循適用的 AGENTS.md 和現有的專案組織。
  • 僅讀取當前階段所需的確切檔案。
  • 將接受的結果儲存在內容實際專案內命名清晰的檔案中。
  • 將每個持久性事實放在一個權威位置;在其他地方引用它,而不是複製。
  • 僅記錄會影響後續工作的決策。不要保留隱藏的理由、廢棄的草稿或冗長的對話記錄摘要。
  • 當上游決策發生變化時,識別需要審查的下游交付項目,並在專案狀態中清楚標記它們。

優先使用現有的專案狀態或決策檔案。如果不存在且有意義的跨對話工作需要一個,請提出最小有用檔案集,而不是為每個專案建立索引。

建立精簡的交接資訊

在更換對話、暫停未完成的工作,或在背景可靠性下降後繼續工作之前,先更新正式產出物,然後準備一份精簡的交接資訊,包含:

  • 任務和當前階段;
  • 已完成和已接受的工作;
  • 已鎖定的決策;
  • 權威檔案路徑和版本;
  • 未完成的工作和阻礙因素;
  • 立即的下一個行動;
  • 下一個對話應讀取的確切檔案;
  • 為下一個對話準備好的即用起始提示。

保持交接資訊足夠簡短以便快速掃描。下一個對話應從正式檔案和交接資訊恢復,而不是重建舊的對話記錄。

起始提示模式

當建議新對話時,使用此結構:

繼續 [專案],階段:[階段名稱]。

閱讀並遵循:
1. [適用的 AGENTS.md]
2. [專案真實來源]
3. [當前狀態或交接資訊]
4. [確切的上游產出物或相關章節]

不要閱讀:[不相關的對話、資料夾或草稿]。

目標:[單一階段目標]。
輸出:[命名交付項目和位置]。
完成條件:[可觀察標準]。
完成後:[狀態/決策/交接更新]。

保持開銷相稱

  • 不要為簡單請求宣布複雜的工作流程。
  • 不要建立沒有未來消費者會使用的計畫檔案。
  • 當已知確切來源時,不要重新讀取整個專案。
  • 在所需的上游決策穩定之前,不要繼續產生後期階段的產出物。
  • 除非使用者明確要求委派或適用指令要求,否則不要使用子代理或平行代理。

當此技能實質上改變了執行方式時,簡短地告訴使用者任務正在被拆分或交接,以及原因。

相關技能