Autowonder Claude Executor — Development skill for Claude Code

autowonder-claude-executor (awce)

AutoWonder 社区版的首个第三方开源执行器 —— 用 Claude Code（或任意 MCP 兼容 CLI agent）作为执行引擎。 The first open-source third-party executor for the AutoWonder community edition — with Claude Code as the engine.

[English](#english) | 中文

这是什么

[AutoWonder](https://github.com/aliyun/alibabacloud-landing-zone/tree/main/ai-sdlc/auto-wonder) 是阿里云的多 Agent 软件交付平台（AI Native SDLC Platform）。它的调度器通过 WebSocket 协议把工单派发给"执行器"（executor daemon），执行器拉起本地 CLI agent 完成工作。

社区版的限制：

• 官方执行器 runtime（autowonder npm 包内的 Go daemon）闭源；
• 平台新建执行器只开放 QODER_CLI / QODER_CN_CLI 两种类型。

本项目实现与官方调度器完全兼容的开源执行器，把引擎换成 **Claude Code**（无头模式），并向上以 MCP 协议（`awdispatch_` dispatch token）与平台通信：

AutoWonder 调度器 (WebSocket /ws/executor?executorId&token)
        │  TASK_DISPATCH {downloadUrl, md5, signature?, dispatchMcpToken, artifactUploadPath, ...}
        ▼
awce daemon（本项目，Node/TypeScript，零运行时依赖）
        │  ① 下载任务包 zip → md5 + sha256 + Ed25519 验签 → 解压 capsule
        │  ② 组装上下文（workitem/identity/sdlc/roster/memory/teammates + 恢复检查点）
        │  ③ 渲染 mcp-config（注入 dispatchMcpToken → 平台 /api/mcp）
        │  ④ 拉起 claude 无头执行当前 SDLC 步（心跳上报库存，检查点续传）
        ▼
Claude Code ──MCP──▶ AutoWonder（112 个平台工具：记忆/技能/工单…）
        │
        ▼ 产物：deliverables/ + handoff-proposal.json（FAILURE 文件=失败信号）
awce daemon ──▶ TASK_ACK / TASK_PROGRESS / TASK_RESULT(V2) / TASK_HANDOFF
             ──▶ HTTP 上传产物 + 检查点（帧内签名路径）

状态

✅ **协议面全功能已实现并在真实部署上端到端验证**（社区版 1.0.0，2026-10 立项）。实现规格与协议发现见 [docs/SPEC.md](docs/SPEC.md)。

• 协议精读与实现规格（docs/SPEC.md，含 8 批源码级协议发现）
• MCP 链路验证：Claude Code ↔ AutoWonder /api/mcp 端到端打通（112 工具）
• 最小 daemon：WS 接入 + TASK_DISPATCH/ACK/PROGRESS/RESULT 主环（平台显示 ONLINE）
• capsule：任务包下载/校验/解压（整包 md5 + 逐文件 sha256 + UTF-8 安全解压）
• runner：Claude Code 无头执行 + 事件上报 + artifacts/FAILURE 失败信号
• 产物上传 + handoff 上报（multipart 中继通道，逐文件回执）
• 端到端验证：本地 AutoWonder 真实派发一轮（dispatch 10002 → SUCCEEDED，39s）
• 多 Agent 接力：TASK_HANDOFF 双变体验证（AGENT_DISPATCHED 跨角