Async Programming

触发条件

当用户请求涉及以下内容时，激活此技能： ✅ 编写/修改代码 ✅ 添加新功能 ✅ 修复 bug ✅ 重构代码 ✅ 创建脚本 ✅ 项目配置 ✅ 依赖安装

核心原则

收到编程任务 → 立即调用子 agent + 立即回复确认 = 可以继续聊天

1. 调用子 agent

sessions_spawn({ task: "{具体任务描述，包含项目路径和具体要求}", label: "{项目名} - {任务类型}", model: "bailian/qwen3-coder-plus", mode: "run", runTimeoutSeconds: 900 }) 参数说明： 参数说明示例task明确的任务描述"给 Stock-Analysis 添加 Excel 导出功能"label任务标识，格式 项目名 - 任务类型Stock-Analysis - 功能开发model编程任务统一用 coder 模型bailian/qwen3-coder-plusrunTimeoutSeconds超时时间（秒）900 (15 分钟)

2. 立即回复确认（关键！）

• 调用子 agent 后，立即回复用户，不要等待完成！
• 回复模板：
• ✅ 任务已接收
• **正在处理：**
• 项目：{项目名}
• 任务：{任务简述}
• 执行者：子 agent（编程助手）
• 预计时间：2-5 分钟
• 你可以在等待期间继续问我其他问题，完成后我会通知你。

3. 完成后汇报

• 子 agent 完成后会自动发送结果，转发给用户：
• ✅ {任务名} 完成了！
• **完成内容：**
• {改动 1}
• {改动 2}
• **文件变更：**
• {文件路径 1}
• {文件路径 2}
• 需要调整或继续开发吗？

多任务并发

用户可以连续下达多个编程任务，子 agent 并行执行： 用户："给项目 A 加个功能" → 调用子 agent #1 → 立即回复确认 用户："帮项目 B 修复 bug" → 调用子 agent #2 → 立即回复确认 用户："项目 C 也帮我看看" → 调用子 agent #3 → 立即回复确认 并发限制： 最多 8 个子 agent 同时运行（agents.defaults.subagents.maxConcurrent）

任务追踪

• 当用户询问进度时，使用：
• subagents(action="list")
• 回复格式：
• **当前任务进度：**
• ✅ 已完成 (2)
• Stock-Analysis - 功能开发
• Amazon-Analyzer - 数据抓取
• ⏳ 进行中 (1)
• Skills-Bank - 文档整理 (预计还需 1 分钟)
• ❌ 失败 (0)

示例 1：单个任务

• 用户：给 Stock-Analysis 加个导出 Excel 的功能
• 助手：
• ✅ 任务已接收
• **正在处理：**
• 项目：Stock-Analysis
• 任务：添加 Excel 导出功能
• 执行者：子 agent（编程助手）
• 预计时间：2-5 分钟
• 你可以在等待期间继续问我其他问题，完成后我会通知你。
• ---（2 分钟后，子 agent 完成）---
• ✅ Excel 导出功能完成了！
• **完成内容：**
• 新增 `export_to_excel()` 函数
• 支持导出 CSV 和 JSON 结果
• 添加 openpyxl 依赖
• **文件变更：**
• /root/Stock-Analysis/stock_analyzer.py (新增 35 行)
• /root/Stock-Analysis/requirements.txt (新增 openpyxl)
• 需要测试或继续开发吗？

示例 2：多任务并发

• 用户：帮我给三个项目都加个 README
• 助手：
• ✅ 收到！正在并行处理三个项目：
• **任务队列：**
• 1. Stock-Analysis - 完善 README
• 2. Amazon-Analyzer - 完善 README
• 3. Skills-Bank - 完善 README
• 预计 5-8 分钟完成，你可以继续问我其他问题。
• ---（5 分钟后）---
• ✅ 三个项目的 README 都完成了！
• **完成情况：**
• ✅ Stock-Analysis - 已添加安装和使用说明
• ✅ Amazon-Analyzer - 已添加 API 配置说明
• ✅ Skills-Bank - 已添加技能分类说明
• 需要调整吗？

注意事项

不要等待子 agent 完成才回复 - 这是核心原则 任务描述要清晰 - 子 agent 需要明确的指令 label 要规范 - 方便追踪和管理 超时处理 - 15 分钟未完成，主动告知用户 错误处理 - 子 agent 失败时，解释原因并提供解决方案

相关配置

子 agent 配置位于 openclaw.json： { "agents": { "defaults": { "subagents": { "maxConcurrent": 8, "maxSpawnDepth": 2, "model": "bailian/qwen3.5-plus", "runTimeoutSeconds": 600, "archiveAfterMinutes": 60 } } } } 此技能确保贾维斯可以并行处理多个编程任务，同时保持与用户的即时沟通