Community生产力与协作github.com

iosware/skill.state

具备长程执行能力的技能,适用于 Claude、Codex 等 AI 智能体。

skill.state 是什么?

该技能为 AI 智能体(如 Claude、Codex)提供了一种结构化的执行状态管理机制,使其能够可靠地处理多步骤、长周期的任务。其核心原则是将当前的结构化状态作为未来行动的“唯一真理”,而非依赖对话历史记录,从而有效应对中断、噪声或状态变化。通过在每个执行回合中仅输出一个最小的状态补丁(state_patch)和下一步动作(action),该技能实现了清晰的上下文管理,避免了无关信息对决策的干扰。这尤其适用于需要多次工具调用、依赖记忆或文件状态、以及要求高恢复能力的场景,本质上是将智能体的工作方式从“全量历史回顾”转变为“结构化单步执行”。

兼容平台✓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. 生成一个最小的状态补丁,仅包含未来执行所需的信息。
  4. 生成下一步动作。
  5. 绝不保留不相关的推理、评论或过时的观察结果。

输出格式

返回一个包含以下两个键的 JSON 对象:

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

相关技能