Agent Step Sequencer

核心定位

Agent Step Sequencer 是一款专为复杂多步骤任务设计的智能调度框架，通过将用户请求分解为可执行的步骤序列，实现跨会话的工作流持久化与自动恢复。

核心用法

当检测到用户请求涉及3个以上动作、存在步骤依赖关系或高范围/风险操作时，智能体（Agent）会：
1. 生成结构化的步骤计划（含标题、指令和可选的输出文件要求）
2. 持久化保存至 state.json
3. 立即触发检查脚本启动执行
4. 通过心跳机制（如每5分钟）保持任务同步，即使网关重置也能从断点恢复

步骤执行采用 Runner 模式，支持可配置的步骤间隔延迟（0或2分钟），内置自动重试机制：失败后会重置状态并附带故障诊断提示重新执行，最多重试3次后转入阻塞列表。

显著优点

• 断点续传能力：state.json 持久化设计确保网关中断后可无缝恢复
• 故障自愈：自动重试+备选方案策略，减少人工介入
• 安全管控：STEP_AGENT_CMD 严格限制为可信代理二进制文件，禁止 shell 解释器注入
• 透明可控：每个步骤的执行状态和输出文件都有明确校验

潜在局限

• 环境依赖：需要预配置 Python 3 和 STEP_AGENT_CMD 环境变量
• 单点执行：当前设计为单 Runner 模式，未原生支持并行步骤
• 心跳耦合：长期任务依赖外部心跳调度，若心跳服务中断需手动触发检查脚本
• 重试上限固定：max_retries=3 为硬编码或环境变量配置，动态调整能力有限

适合人群

• 需要执行跨会话长周期任务的自动化开发者
• 涉及多 API 调用、文件生成链路的复杂工作流场景（如研究报告生成、数据迁移）
• 对任务可观测性和故障恢复有高要求的企业级用户

常规风险

• 状态文件损坏：state.json 若被手动修改可能导致调度异常
• 代理命令注入：虽 Runner 会拒绝 shell 解释器，但仍需确保 STEP_AGENT_CMD 指向可信路径
• 资源泄漏：步骤失败未清理的临时文件可能累积，需配合 artifacts 字段跟踪
• 无限阻塞：网络/API 持续不可用且备选方案耗尽时，步骤会转入 blockers 需人工清理

核心定位

Agent Step Sequencer 是一款专为复杂代理任务设计的多步骤调度框架，通过持久化状态机和心跳机制，确保长时间运行的任务能够在中断后自动恢复。其核心价值在于将「一次性的长对话」转化为「可中断、可追踪、可重试的流水线作业」。

显著优势

1. 断点续行能力：通过 state.json 持久化状态，网关重置或会话中断后，下次心跳自动恢复执行，无需用户重复指令。
2. 智能故障恢复：内置三级容错机制——瞬时错误自动重试、同源故障切换备用源、完全失败时标记BLOCKER并主动通知用户，而非静默停止。
3. 严格的命令注入防护：STEP_AGENT_CMD 配置经过 _validate_agent_cmd 多重校验，禁止 shell 解释器及 -c/-e 参数，消除注入风险。
4. 零依赖设计：纯 Python 标准库实现，无第三方包依赖，杜绝供应链攻击面。
5. 灵活的节奏控制：支持 0 分钟或 2 分钟步骤间隔，适配 API 限流场景。

潜在局限

• 配置门槛：需正确设置 STEP_AGENT_CMD 环境变量，误配可能导致调度失败或安全风险。
• 状态文件管理：state.json 需妥善保管，权限不当可能导致执行计划泄露或篡改。
• 调试可见性：stdout/error 仅截存前 500 字符，复杂任务故障排查信息可能不足。
• T3 来源信任：个人开发者维护，虽代码质量优秀，但缺乏企业级背书。

适用场景

• 需 3+ 步骤的复杂研究/写作工作流
• 存在步骤间数据依赖的串联任务
• 高风险的批量操作（迁移、重构、多文件编辑）
• 可能触发 API 限流的外部数据获取任务
• 需要「提交后离线运行」的异步作业

常规风险

| 风险类型 | 说明 | 缓解措施 |

|---------|------|---------|

| 命令注入 | 通过 `STEP_AGENT_CMD` 执行外部命令 | 严格校验禁止 shell 解释器 |

| 状态篡改 | `state.json` 被恶意修改 | 建议设置 600 文件权限 |

| 配置漂移 | 环境变量被意外更改 | 定期审查配置 |

| 无限重试 | 故障步骤循环重试 | 默认 3 次上限，超限时转 BLOCKER |

综合评价

该 skill 填补了「对话式 AI」与「可靠批处理」之间的鸿沟，其 S 级安全评分和完善的故障恢复机制，使其成为构建生产级代理工作流的基础设施组件。建议对复杂任务有可靠性要求的用户优先采用。