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

🗂️ 结构化任务规划与分步执行

结构化任务规划工具,支持文件加载与自然语言生成计划书,分步骤执行并全程跟踪状态,适合复杂任务拆解与自动化执行。

收藏
9.6k
安装
2.3k
版本
1.0.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

STP 提供两种任务启动模式:

文件模式:用户预编写 Markdown 任务文档,通过 /stp /path/to/task.md 直接加载执行,适合标准化、可复用的任务流程。

自然语言模式:用户用日常语言描述需求(如“查腾讯、茅台、Meta 股价”),系统自动生成结构化计划书,经用户确认后转为文件模式执行。计划书包含任务描述、技术方案、分步清单与成功标准,支持修改-确认循环。

执行层面,STP 为每个任务创建独立目录(task-{ID}),内含步骤文档、执行日志与临时资源。主 Agent 按序执行步骤,状态标记从 [ ] 变为 (成功)或 (失败),所有 exec 命令与 AI 执行过程完整记录。

显著优点

1. 双模启动:既尊重专业用户的预规划习惯,又降低新手使用门槛,自然语言转结构化计划的能力显著缩短任务启动时间。
2. 执行可追溯:强制记录关键命令、输出与退出码,便于事后审计与故障定位。

3. 原子化失败控制:采用快速失败策略,单步失败立即终止整个任务链,避免无效重试或隐蔽降级,符合工程化 best practice。

4. 标准化产出:任务目录结构统一,日志格式规范,利于集成到更大规模的自动化 pipeline。

潜在局限

  • 刚性执行:"原方案优先"原则禁止 Agent 灵活调整实现方式,面对 API 变更或环境限制时可能过早失败,需人工介入修正计划书。
  • 无并行能力:步骤串行执行,未内建并发或依赖调度机制,复杂 DAG 任务支持有限。
  • 状态标记依赖文本替换[ ]// 为 Markdown 文本标记,非数据库级状态管理,极端并发场景可能出现 race condition。

适合人群

  • 需要可重复、可审计执行流程的自动化工程师与数据分析师
  • 希望将自然语言需求快速转为可执行计划的非技术用户
  • 追求明确失败边界、拒绝隐性降级的严谨生产环境

常规风险

| 风险点 | 说明 |
|--------|------|
| 计划书理解偏差 | 自然语言模式依赖 LLM 生成计划,若意图解析错误且用户未细读确认,可能导致执行方向偏离 |
| 环境依赖隐性失败 | 脚本依赖特定工具(如 AkShare)版本,若环境未预装或版本不兼容,快速失败策略会立即终止任务 |
| 日志敏感信息泄露 | 执行日志记录完整命令与输出,若命令含 API Key、密码等,需额外脱敏机制 |
| 任务目录累积 | 自增 ID 无自动清理策略,长期运行可能产生大量历史任务目录,需定期归档或清理 |

结构化任务规划与分步执行 V2(异步子代理架构) 内容

scripts文件夹
手动下载zip · 9.2 kB
execute_task.pytext/plain
请选择文件