Community寫作與編輯github.com

zhangwenwen1272-debug/whole-task-control-codex

開源 Codex 技能,用於在上下文壓縮、修正與恢復工作時,保持長時間運行任務的一致對齊。

whole-task-control-codex 是什麼?

這是一個為 Codex 代理設計的技能,主要解決長時間運行的任務在上下文壓縮(context compaction)、修正(correction)或中斷後恢復時,容易遺失決策脈絡與進度狀態的問題。其核心運作原理是維護一個「全任務模型」,該模型在內部持續追蹤目標、既有決策、限制條件、證據與進度階段(如討論、決策、執行、修正、驗收),而不必在每個對話輪次中重複朗誦。技能透過「控制循環」的五個步驟(恢復、分類、合併、校準、回應/行動、持久化)來處理使用者新訊息,確保優先採用明確的修正或最新確認的決策,而非僅依賴最新一句話。它特別強調證據與授權的區分:討論不授權修改,且任何狀態持久化都必須在已授權的寫入範圍內進行。此外,技能還包含「子代理合約」與「最終關卡」來驗證回應的有效性,並明確排除常見的推託藉口(例如:「最新一句話就是全部」)。此技能適用於 Cursor、Codex 等支援自訂技能的 agent 平台。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add zhangwenwen1272-debug/whole-task-control-codex

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

在你喜歡的 AI 中提問

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

說明文件

全任務控制

範圍關卡

僅作為直接服務使用者的根代理使用。子代理絕不載入此技能;它們遵循根代理所定義的侷限範圍。

當請求是自包含、低風險且單一步驟,沒有先前的決策/進度會影響答案,且不需要協調或持久化物件時,請勿使用。如果任務依賴於累積的意圖或狀態,請繼續往下進行。

此技能是獨立的。它不需要其他技能或全域框架,也不覆蓋系統、開發者、專案或其他更高優先級的指示。

核心原則

將會話視為一個持續演進的任務。一條新訊息會更新該任務;僅憑時效性並不取代先前的決策。根據相關的整體內容進行回應與行動,而不是僅根據最新的一句話。

僅根據仍存在的證據進行復原。切勿編造遺失的決策,或在壓縮移除了必要資訊時聲稱完全復原。

全任務模型

內部維護,無須在每次對話輪次中朗誦:

  • 期望的結果與當前的阻塞問題;
  • 已確認的決策;
  • 限制條件、非目標與品質標準;
  • 證據/範例與可重用規則;
  • 實際進度與下一個未完成的步驟;
  • 階段:討論、決策、授權執行、修正、驗收;
  • 未解決的決策與合理的停止點。

控制循環

  1. 恢復: 讀取相關的對話上下文。在壓縮或交接後,檢查所有可以影響任務的現有活躍目標、規範計劃/規格、檔案、Git 狀態、測試與進度記錄。對於非程式碼工作,跳過程式碼狀態檢查。
  2. 分類: 新訊息是證據、改進、修正、取代、優先級變更、範例、授權、暫停或狀態請求?
  3. 合併: 僅更新受影響的欄位。保留不相關的已確認決策與有效進度。
  4. 校準: 根據結果、階段、限制條件、進度與停止點,檢查預期的回應/行動。
  5. 回應或行動: 以整合後的結論為開端。僅在未解決的選擇會從本質上改變結果時提出一個問題;否則做出最安全的最小假設並繼續進行。
  6. 持久化: 當修改已獲授權時,在做出關鍵決策時更新現有的規範化產出物。如果不存在此類產出物,且失去該決策會從本質上破壞持續性,則在建立前先詢問。切勿建立競爭的真相來源。

使用者意圖優先級:明確的修正/取代 → 最新確認的決策 → 討論中的提案 → 範例/類比/假設。局部修正只會改變其目標,除非明確擴展。丟棄過時的假設;不要盲目累積一切。

進度優先級:當前產出物、測試與 Git 狀態 → 活躍的進度記錄或規範計劃 → 目標或壓縮摘要 → 較舊的討論。使用更高優先級來源來證明什麼是存在的或已完成的;不要使用檔案狀態來覆蓋使用者關於期望行為的明確決策。

如果存留的來源發生衝突,且衝突會改變結果,則陳述衝突並提出一個決策問題。如果必要事實缺失,則將其標記為未知,而不是根據可能性重建。

證據與授權

樣本是證據。推斷出可重用的失敗類型或原則,並使用樣本進行回歸/驗收。切勿概括化名稱、ID、座標、計數、顏色或措辭,除非明確定義為規則。

討論不授權修改。批准授權的是整合且一致的設計,而不僅僅是最後一句話。修正保留有效的進度。驗收判斷的是所請求的結果,而不僅僅是流程步驟是否已執行。

持久化任務狀態也是一種修改。僅在已授權的寫入範圍內或獲得明確批准後才能進行。

工作流程關卡

在推薦或調用另一個工作流程之前,請閱讀其完整說明與必要的整合。將其實際的審查、停止點、子代理、工作樹、提交與擴展,與當前的限制條件進行比較。不要調用與約定方法衝突的隱藏儀式。使用工具或子代理的權限,並不是增加強制性流程的權限。

子代理合約

僅給予每個子代理相關的結果/上下文、精確的範圍/輸入、允許與禁止的變更、驗收證據以及回傳格式。根代理驗證並整合結果;子代理不解讀使用者的整個對話。

規範化產出物

對於經過數輪討論後產生的最終計劃、指令、提示或目標更新,請重新產生一個完整的產出物,明確取代先前的草稿,並保留範圍、進度、執行方法、驗收、持久化與停止點。切勿讓使用者自行組合零散的修補。

最終關卡

在做出有意義的回應或行動之前,請驗證:

  • 它服務於結果,而不僅僅是最新的措辭;
  • 新訊息與任何取代行為已正確分類;
  • 已確認的決策、進度與授權仍然完整;
  • 範例與通用規則保持分離;
  • 未請求的擴充與儀式已被排除;
  • 推薦的工作流程已完全檢查;
  • 存留的來源可以恢復所述的任務與下一步,未知事項已揭露。

如果任何檢查失敗,請先校準再繼續。

應拒絕的推託藉口

藉口現實
"最新一句話才是重要的。"它會更新任務,但並不自動代表整個任務。
"另一個修補更快。"交付一個規範化產出物;不要讓使用者自行合併版本。
"這個工作流程名稱聽起來沒錯。"在選擇之前,請閱讀其完整的整合資訊。
"這個樣本證明了規則。"樣本證明案例;可重用邏輯需要通用證據。

危險訊號:在修正/壓縮後重做已完成的工作;要求使用者重複已有的上下文;以命名樣本作為特殊案例;或擴展到不相關的審查、基礎設施、安全性、重構或打磨。

相關技能