用途：对 Claude Code Buddy app 进行真实端到端测试。它真实启动应用、真实发送事件、真实验证行为，而非模拟或静态断言源码。仅限用户显式调用（/buddy-e2e-test），不要自动触发，因为构建+启动+全量场景约需 5 分钟。
与 shell 验收测试分工：tests/acceptance/ 覆盖构建、hook 脚本映射、socket 协议存活、数据模型静态检查、多会话并发存活。本技能聚焦 acceptance tests 未覆盖的缺口，如 permission_request 完整流程、超 socket 读缓冲区的大 payload、label 截断保护、Color file 损坏恢复、状态转换动画的视觉正确性。
主要能力：分五阶段。Phase 1 动态发现：从 HookMessage.swift、SessionColor.swift、SocketServer.swift、SessionManager.swift、CatSprite.swift、BuddyScene.swift 及 tests/acceptance/ 实时读取事件类型、最大会话数、socket 路径、读缓冲区大小、截断阈值、color file 路径等参数，不硬编码。Phase 2 基础设施：清理残留、swift build、后台启动并捕获日志、等待 socket 就绪（超时 10s 失败），用 nc -U 发送消息。Phase 3 生成并执行场景，分四类：A 各事件类型基础通路；B 完整状态机路径（session_start 到 session_end）；C 补全 acceptance 缺口（permission_request 全流程、大 payload 跨 read 重组、label 截断边界、color file 损坏、EOF 刷新）；D 边界与异常（最大并发、eviction、字段缺失、格式错误、未知事件、重复 session_start）。
验证标准：V1 日志断言 grep 精确匹配 Decoded message；V2 用 python3 解析 color file JSON；V3 grep JSON decode error；V4 pgrep 确认进程存活；V5 目视 Dock 动画，无法目视时须标注 V5 未验证。零容忍：所有场景必须 PASS，无豁免，App 崩溃立即停止并报告。每场景执行后立即验证。
限制：执行成本高，仅显式调用；headless 环境无法完成 V5 视觉验证；日志只能证明消息被接收，不能证明动画正确，状态机行为需额外视觉确认。