Community生產力與協作github.com

iosware/skill.state

適用於 Claude、Codex 等工具的長時序執行技能。

skill.state 是什麼?

此技能專為需要跨多個步驟、回合或依賴持久狀態的任務而設計。它透過明確的結構化執行狀態來運作,將「當前結構化狀態」作為後續行動的唯一事實來源,而非依賴於完整的對話歷史記錄。這使得 AI 代理能夠可靠地從中斷或狀態變更中恢復,同時保持提示詞的界限清晰,避免因重放完整歷史而導致的提示詞過長問題。此技能主要應用於需要工具呼叫、記憶事實、清單、檔案或推論的複雜開發工作流程。支援的平台涵蓋 Claude Code、Codex 等。運作方式為:每個回合代理會接收任務指令、當前狀態及最新觀察,然後更新狀態(僅保留未來所需的最小資訊)並輸出下一個動作,最終產出一個僅包含 `state_patch` 與 `action` 的 JSON 物件。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add iosware/skill.state

Installed? Explore more 生產力與協作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

skill.state 是做什麼的?

您正在使用明確的結構化執行狀態來執行程序性技能。

使用時機

當任務符合以下任一情況時,請自動使用此技能:

  • 跨越多個步驟或回合,
  • 依賴於已記住的事實、庫存、檔案、假設或活躍實體,
  • 需要隨時間推移進行工具呼叫,
  • 需要可靠地從中斷、雜訊或狀態變更中恢復,
  • 適合使用有界限的提示詞而非重放完整歷史。

核心原則

當前結構化狀態是未來行動的唯一事實來源。

除非所需資訊已提交至當前狀態,否則不要依賴先前的對話歷史紀錄。

每回合的輸入

您將收到:

  1. 不可變的任務指令。
  2. 當前的結構化執行狀態。
  3. 來自環境的最新觀察結果。

您不會收到除了當前狀態中已包含的資訊以外的有用歷史記錄。

您必須執行的操作

在每一個回合:

  1. 閱讀當前觀察結果與狀態。
  2. 推理發生了什麼變化以及接下來應該做什麼。
  3. 產出一個最小的狀態修補(state patch),僅包含未來執行所需的資訊。
  4. 產出下一個動作。
  5. 絕不保留無關的推理、評論或過時的觀察結果。

輸出格式

傳回一個包含以下兩個鍵的 JSON 物件:

{
  "state_patch": {},
  "action": ""
}

相關技能