核心功能
Agent Step Sequencer 是一款专为复杂、多步骤 AI 任务设计的调度与状态管理工具。它通过将用户请求拆分为可执行的步骤序列，结合状态持久化和心跳机制，实现了任务执行的可靠性与连续性。
显著优点
1. 断点续执行能力：核心亮点在于网关重置后的自愈能力。通过 state.json 持久化与心跳脚本（step-sequencer-check.py）的联动，即使执行中途遭遇中断，下次心跳触发时能自动读取状态并恢复执行，避免任务丢失。
2. 清晰的职责分离：架构上将 Agent（计划构建、提示处理）、Runner（步骤执行、延迟控制、重试管理）与 Check Script（状态检查、故障恢复）三者解耦，降低了复杂度并提升了可维护性。
3. 灵活的多步检测逻辑：提供明确的 MULTI_STEP 判定标准（动作数≥3、顺序依赖语言、输出依赖、高风险操作等），Agent 需先提案再执行，赋予用户控制权，避免误启动复杂流程。
4. 自主故障恢复：步骤执行失败时，系统会自动重试一次、尝试替代数据源，仅当穷尽方案后才标记 FAILED 并触发用户通知，减少人工介入频率。
5. 可配置的执行节奏：支持 stepDelayMinutes 参数（0或2分钟），为速率敏感型 API 调用提供缓冲，平衡效率与稳定性。
潜在缺点与局限性
- 环境依赖较重：需要正确配置
STEP_AGENT_CMD、心跳集成及状态文件路径，手动部署时容易因路径或权限问题导致调度失效。 - 状态文件单一：所有计划依赖单个
state.json，并发多任务时可能需要额外隔离机制，文档未明确提及并发安全策略。 - 重试上限固定：默认 3 次重试后转入 blockers，对于需要更长恢复周期的外部服务（如间歇性 API 故障）可能不够灵活。
- 用户通知机制未详述：虽然要求失败时"主动提示用户"，但具体通知渠道（日志、邮件、消息推送）未在文档中标准化。
适合人群
- 需要执行跨会话、长时间运行的复杂工作流开发者
- 依赖外部 API 且需应对速率限制或间歇性故障的自动化场景
- 对任务可靠性要求高、不能接受网关重置导致任务丢失的生产环境
常规风险
- 状态文件损坏或丢失：若
state.json被误删或写入不完整，任务进度将无法恢复，建议配合定期备份。 - 心跳频率与步骤延迟冲突：若心跳间隔（如5分钟）远大于步骤延迟（2分钟），实际执行节奏受限于心跳，可能低于预期效率。
- Agent 指令注入风险：
instruction字段直接传递给 Agent 执行，若计划构建阶段未对用户输入做过滤，可能存在提示注入风险。