核心用法
Agent Step Sequencer 是一个专为复杂agent请求设计的多步骤调度系统。当用户请求涉及3个以上动作、存在顺序依赖或输出依赖时，agent会先构建步骤计划，经用户确认后持久化为state.json，然后由独立的runner脚本逐步执行。
执行流程：
1. Agent检测到多步骤需求 → 2. 向用户提议计划并询问是否添加2分钟延迟 → 3. 用户确认后持久化状态 → 4. 立即调用check脚本启动第一步 → 5. 心跳定时触发check脚本保持同步
关键特性：
- 网关重置恢复：若执行中途网关重置，下次心跳读取state.json自动恢复
- 失败自动重试：步骤失败时runner标记状态，check脚本重置为PENDING并附带故障排查提示重新调用
- 输出验证：通过
requiredOutputs字段确保步骤产出的文件存在才标记完成
显著优点
- 可靠性设计：状态持久化+心跳机制确保长时任务不因中断而丢失进度
- 用户可控：执行前必须确认计划，可选择步骤间延迟（对限频API友好）
- 故障透明：强制要求agent在无法完成时主动通知用户，禁止静默失败
- 安全执行：STEP_AGENT_CMD拒绝shell解释器，防止命令注入
潜在局限
- 依赖外部心跳：需自行配置cron或定时任务触发check脚本
- 单线程执行：步骤串行，无法并行处理独立子任务
- 重试上限：默认3次失败后进入blockers，需人工介入
- 环境配置要求：需正确设置STEP_AGENT_CMD等环境变量
适合人群
- 需要执行研究→撰写→复核等多阶段工作的知识工作者
- 处理API限频、需要节奏控制的自动化场景
- 运行可能中断的长耗时任务（如批量迁移、大规模文件处理）
常规风险
- 状态文件管理：state.json若被手动修改可能导致执行异常
- 资源竞争：多实例同时读写state需文件锁保护（文档未明确提及）
- 无限循环风险：若agent持续非零退出且错误未修复，会消耗重试配额