核心用法
async-programming 是一种并行化代码开发工作流技能，通过调用子 Agent（sessions_spawn）将具体编程任务（功能开发、Bug 修复、重构、脚本编写等）异步执行，主会话立即向用户确认任务已接收并允许继续交互，子 Agent 完成后自动汇报结果。
关键操作：
1. 调用子 Agent 时指定 task（任务描述）、label（项目-任务标识）、model（推荐 bailian/qwen3-coder-plus）及 runTimeoutSeconds（默认 900 秒）
2. 立即向用户发送确认消息，说明项目名、任务简述、预计耗时，并提示可继续聊天
3. 子 Agent 完成后自动转发结果，包括改动摘要与文件变更列表
4. 使用 subagents(action="list") 查询任务进度（已完成/进行中/失败）
5. 支持最多 8 个子 Agent 并发（maxConcurrent: 8），适用于批量项目处理
显著优点
- 零等待体验：用户无需阻塞等待代码生成，可并行发起多个任务或进行其他咨询
- 高并发能力：最多 8 任务并行，适合同时维护多个项目或批量生成代码
- 专业模型隔离：编程任务使用专属 Coder 模型（Qwen3-Coder-Plus），与主对话模型解耦，提升代码质量
- 自动进度管理：内置任务追踪与超时机制（15 分钟），降低人工跟进成本
- 规范化输出：统一的确认模板与完成汇报格式，降低沟通摩擦
潜在缺点与局限性
- 上下文割裂：子 Agent 独立运行，无法实时感知主会话的后续上下文调整，需通过任务描述一次性明确需求
- 调试间接性：代码错误需等待子 Agent 完成后才能反馈，实时 pair programming 体验弱于同步模式
- 资源竞争：8 并发上限在大型项目批量重构时可能成为瓶颈
- 深度嵌套限制：
maxSpawnDepth: 2限制子 Agent 再派生子 Agent，复杂多阶段流水线需手动拆分 - 超时刚性：15 分钟固定超时对大型代码库重构可能不足，需手动延长或分批处理
适合人群
- 多项目并行维护的独立开发者或技术负责人
- 需要快速批量生成脚本、配置或文档的 DevOps/SRE 工程师
- 希望将编码任务异步化、专注于需求沟通与架构设计的技术管理者
- 教育场景中需同时指导多个学生项目的编程导师
常规风险
- 任务描述歧义：子 Agent 依赖明确的
task字段，模糊需求导致代码偏离预期，需用户二次迭代 - 并发过载：高频发起任务可能触达 8 上限，后续任务排队延迟
- 子 Agent 失败未感知：若未及时查询进度，用户可能 unaware 任务失败（如依赖安装冲突、权限不足）
- 文件冲突：多子 Agent 同时写入同一项目文件时缺乏内置锁机制，可能产生合并冲突
- 敏感信息泄露：任务描述若包含 API 密钥、数据库密码等，将明文传递至子 Agent，需前置脱敏
最佳实践建议
1. 任务描述采用"项目路径 + 具体功能 + 技术约束"三段式，减少歧义
2. 对大型任务手动拆分为≤15 分钟的子任务，规避超时
3. 关键项目启用 Git 版本控制，便于冲突回滚
4. 定期执行 subagents list 主动巡检，避免失败任务悬停
5. 敏感配置通过环境变量或 vault 注入，避免硬编码于任务描述