结构化任务规划与分步执行 V2（异步子代理架构）

核心功能

STP V2 是一款面向复杂任务的结构化规划与执行框架，采用异步子代理架构彻底解决了长任务阻塞主会话的核心痛点。每个执行步骤通过 session_spawn 创建独立子代理运行，主会话保持非阻塞状态，用户可同时进行其他操作。

显著优点

1. 非阻塞执行：V2 架构让每个步骤在独立子代理中运行，主会话无需等待，大幅提升交互体验
2. 严格的检验机制：强制使用检验子代理（LLM）验证执行结果，禁止主会话直接判断，确保质量可控
3. 完善的状态管理：基于 task_steps.md 的持久化状态机，涵盖"待执行→执行中→待检验→检验中→已完成"完整生命周期
4. 自动化监控：Heartbeat 机制每 10 分钟检查子代理状态，自动识别 pending/running/completed/stuck 四种状态
5. 可靠的任务中断：支持 中断 task-{ID} 指令，自动杀掉子代理并清理残留进程（通过解析 PID）
6. 智能 Cron 管理：任务启动自动创建 heartbeat job，完成或中断后自动清理，无需手动配置

潜在局限

1. 串行执行约束：步骤必须严格串行，检验通过才能执行下一步，无法并行处理独立子任务
2. 检验开销：每个步骤需启动检验子代理，增加额外 LLM 调用成本和时间
3. 状态依赖文件系统：任务状态依赖本地文件系统，分布式部署需额外适配
4. 超时判定阈值固定：30 分钟 stuck 判定、2 次重试机会为硬编码，缺乏动态调整机制

适合人群

• 需要执行多步骤复杂任务（代码生成、数据分析、批量操作）的开发者
• 对任务可追溯性、可检验性有要求的团队协作场景
• 希望"提交任务后离开"、异步获取结果的高效工作模式用户

常规风险

• 子代理异常退出可能导致状态不一致，依赖 heartbeat 兜底
• 残留进程清理依赖 sessions_history 解析，极端情况下可能失败
• 检验子代理的判断标准若设计不当，可能误判有效结果
• 大量并发任务可能产生过多 cron job 和子代理，需关注资源上限

核心功能

STP（Structured Task Planning）V2 是一款面向复杂任务的结构化规划与分步执行工具，其核心创新在于采用异步子代理架构——每个任务步骤通过 session_spawn 创建独立子代理执行，主会话始终保持非阻塞状态，彻底解决了 V1 版本中长任务阻塞会话的痛点。

显著优点

架构先进性：V2 的子代理异步设计是最大亮点。主会话仅负责任务编排与状态监控，具体执行交给隔离的子代理，用户可在任务执行期间继续与主会话交互，大幅提升用户体验。每个步骤配备独立的「执行子代理」和「检验子代理（LLM）」，形成"执行-检验"双保险机制，确保任务质量。

功能完整性：覆盖任务全生命周期管理——计划生成与确认、步骤分解与串行执行、LLM 自动检验、Heartbeat 状态监控（每 10 分钟）、超时检测（30 分钟阈值，2 次重试机会）、任务中断与残留进程清理。Cron Job 自动化管理，无需手动配置。

安全可靠性：仅依赖 Python 标准库，零第三方依赖；无外部网络请求；文件操作严格限制在 ~/.openclaw/workspace/tasks/ 目录；代码通过 CLS 六维安全检测，评分 85/A 级。

潜在局限

使用门槛：需要用户理解"计划书-确认-执行"的流程，首次使用可能因跳过确认步骤而触发保护机制。检验标准的编写质量直接影响任务成功率，对用户的 Prompt 工程能力有一定要求。

效率权衡：严格的"执行-检验"串行机制保证了可靠性，但也意味着无法并行执行多个步骤。对于追求极致速度的简单任务，STP 的 overhead 可能显得冗余。

生态依赖：深度绑定 OpenClaw 平台，子代理创建、状态同步、Cron 管理均依赖 openclaw CLI，迁移成本较高。

适合人群

• 需要执行 3 步以上复杂任务的技术用户
• 追求任务可审计、可回溯的严谨型用户
• 需要长时间运行任务但不愿会话被阻塞的场景
• 对 AI 执行结果质量有要求、愿意接受检验开销的用户

常规风险

• 子代理异常挂起（已内置 Heartbeat 检测与 2 次重试机制）
• 检验标准设计不当导致反复失败（需用户介入调整）
• T3 来源等级要求使用者保持安全意识，建议在隔离环境先行测试

> 来源：GitHub 开源项目（github.com/scotthuang/openclawSkills），由个人开发者维护，代码公开可审计。