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

核心用法

STP V2 是一套面向复杂任务的异步执行框架，用户通过自然语言描述需求后，系统自动生成结构化计划书，经用户确认后逐步执行。核心流程包括：

1. 计划生成：AI 根据需求动态拆解为带检验标准的步骤清单
2. 子代理执行：每个步骤通过 session_spawn 创建独立子代理运行，主会话保持响应
3. LLM 检验：执行完成后必须由检验子代理（独立 LLM 会话）验证结果，禁止主会话直接判断
4. 心跳监控：每 10 分钟自动检查子代理状态，识别挂死/超时情况
5. 任务中断：用户可随时终止任务，系统自动清理子代理及残留进程

所有状态持久化存储于 ~/.openclay/workspace/tasks/task-{ID}/ 目录，支持断点恢复与审计追踪。

显著优点

• 非阻塞架构：V2 彻底解决了 V1 长任务卡死主会话的问题，用户可在任务执行期间继续交互
• 严格验证机制：强制检验子代理复核结果，避免执行幻觉导致的错误传播
• 自动化运维：内置 cron 心跳、超时重试、进程清理，降低人工干预成本
• 状态可视化：task_steps.md 实时追踪步骤状态、子代理 ID、超时计数

潜在局限

• 串行执行：必须等前一步检验通过才能启动下一步，无法利用并行加速
• 检验成本：每个步骤需额外创建检验子代理，增加 Token 消耗与延迟
• 调试复杂度：子代理异步运行，问题定位需跨会话追踪 announce 链
• 无并行扩展：当前架构不支持多步骤同时执行，大规模任务效率受限

适合人群

• 需要执行 30 分钟以上长耗时任务（如批量数据处理、代码仓库克隆编译）
• 对 结果正确性要求高、需要自动验证的场景（如金融数据查询、配置部署）
• 希望 后台异步运行、不阻塞当前会话的多任务用户

常规风险

• 检验标准设计不当：模糊的检验条件可能导致误通过或无限重试
• 残留进程泄漏：极端情况下子代理进程未被正确清理，需依赖心跳超时机制兜底
• 计划书质量依赖：AI 生成的步骤拆解质量直接影响执行成功率，复杂任务建议人工审核计划
• Token 消耗累积：长链条任务（多步骤 × 执行+检验双会话）成本显著高于单次对话模式

核心功能与用法

STP（Structured Task Planning）V2 是一款面向复杂任务的结构化规划与分步执行工具，采用异步子代理架构彻底解决了长任务阻塞主会话的问题。用户通过自然语言触发（如"帮我查三支股票价格"），AI 自动生成包含执行步骤、检验标准的计划书，经用户确认后启动任务。

关键工作流程：
1. 计划生成：AI 根据需求动态生成任务计划书，明确每步的执行 Prompt 和检验标准
2. 子代理执行：每个步骤通过 session_spawn 创建独立执行子代理，主会话保持非阻塞
3. LLM 自动检验：执行完成后必须通过检验子代理验证结果，禁止主会话 LLM 直接判断
4. Heartbeat 监控：每 10 分钟自动检查子代理状态，识别挂死或超时情况
5. 任务中断：支持通过中断 task-{ID}命令终止任务并清理残留进程

显著优点

• 非阻塞架构：主会话始终可用，可同时处理多个任务或交互
• 可靠执行：强制检验步骤 + 超时重试机制（2次机会），避免任务半途而废
• 状态透明：任务状态持久化到本地文件，支持随时查看进度
• 安全可控：文件操作限制在工作目录，子进程调用仅限于本地 CLI，无外部网络依赖
• 隐私合规：数据本地存储，符合 GDPR/CCPA 要求

局限性与风险

• T3 来源风险：个人开发者/社区项目，需关注后续更新安全性
• 串行执行限制：必须严格按顺序执行并检验通过后才能下一步，无法并行优化
• 磁盘占用：每个任务创建独立目录，长期运行需定期清理
• 权限依赖：依赖 openclaw cron 命令创建定时任务，需要相应系统权限

适合人群

适合需要执行复杂多步骤任务且对可靠性有要求的用户，如数据批量处理、多阶段代码生成、自动化运维脚本等场景。尤其适合需要长时间运行、中间可能中断或需要人工介入决策的任务。

常规风险

• 检验子代理判断可能存在误差，复杂场景建议人工复核
• 子代理执行环境权限需提前验证，避免越权操作
• 任务中断后残留进程清理依赖 PID 解析，极端情况下可能清理不彻底