Agent Step Sequencer

核心用法

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持续非零退出且错误未修复，会消耗重试配额

核心功能

Agent Step Sequencer 是一款专为复杂多步骤任务设计的智能调度器，能够自动识别需要分解执行的用户请求，生成结构化执行计划，并在网关中断后通过心跳机制无缝恢复。

显著优点

1. 智能步骤识别：自动检测多步骤场景（3+动作、顺序依赖、输出依赖、高复杂度），主动提议计划并等待用户确认，避免盲目执行
2. 状态持久化与故障恢复：通过 state.json 持久化执行状态，支持网关重置后的自动续接，配合心跳机制（如每5分钟）确保长期任务可靠完成
3. 企业级安全防护：实现完整的命令注入防护（_BLOCKED_BASES 拦截 shell 解释器，_BLOCKED_ARGS 拦截 -c/-e 危险参数），所有子进程调用采用 shell=False，路径遍历防护验证 requiredOutputs 位于工作区内
4. 零依赖架构：仅使用 Python 标准库（json/os/subprocess/sys/time），彻底消除供应链攻击面
5. 灵活调度配置：支持可配置的步骤延迟（0或2分钟），适应 API 速率限制场景；失败自动重试（最多3次）并附带故障排查提示

潜在局限

• 学习曲线：需要理解状态文件结构和心跳集成方式，对初次使用者有一定认知成本
• 环境依赖：需正确配置 STEP_AGENT_CMD 环境变量指向可信 Agent 二进制文件，配置错误会导致执行失败
• 超时固定：当前 runner 使用固定 3600 秒超时，暂不支持用户自定义（建议后续版本改进）

适合人群

• 自动化工作流开发者：需要编排多步骤、有依赖关系的复杂任务
• DevOps/SRE 工程师：构建可靠的长期运行任务，要求故障自愈和状态可观测
• AI Agent 构建者：为 Agent 添加可靠的步骤执行基础设施，支持人机协同确认机制

常规风险

风险极低。该 Skill 已通过 CLS-Certify 六维安全认证（静态分析、动态行为、依赖审计、网络流量、隐私合规、威胁情报），评分 100/100，获评 S+ 顶级安全等级。主要安全考量：

• 务必设置 STEP_AGENT_CMD 指向可信 Agent 二进制，勿使用 shell 解释器
• 状态文件路径需可控，避免指向不受信任的目录

技术亮点

采用 "Check-Runner" 分离架构：Check 脚本负责状态机流转（PENDING→IN_PROGRESS→DONE/FAILED），Runner 负责任务执行与 Agent 调用，职责清晰易于审计。失败流程设计完善，自动重试时注入故障上下文，提升修复成功率。