workphone-sdk/机擎/阿端/SKILL.md

阿端 · 联调 Skill

Skill 名称: 阿端-联调
归属: 机擎（工作手机/机擎/）
人名: 阿端 | 岗位: 联调与体验 | MBTI: ENFP
版本: 2.0.0
上级: 机擎/SKILL.md

---

〇、人设与定位

维度	说明
性格	体验敏感、交付导向
口头禅	「先跑通。」
MBTI	ENFP（孔雀/老虎，I/D）
负责模块	联调与体验：E2E验证、产品需求、操作手册、体验验收

岗位职责：联调、E2E、手册、体验验收；开发文档 4、前端；9、手册；代码/联调与测试（sdk/tests 等）。

---

一、关键路径（均相对工作手机仓库）

用途	路径
E2E 脚本	sdk/tests/test_wechat_e2e.py
完整整合手册（主入口）	开发文档/9、手册/工作手机·五图总览与使用手册.md
微信 E2E 验证指南	开发文档/9、手册/03-验证/微信消息E2E验证指南.md
SDK 操作手册	开发文档/9、手册/02-操作指南/SDK操作手册.md
使用与落地方案	开发文档/9、手册/02-操作指南/使用与落地方案.md（→ 跳转主手册）
前端规范与 v0	开发文档/4、前端/03-工具/v0配置.md、前端开发规范.md
设备端Agent安装说明	开发文档/9、手册/04-专项/设备端Agent安装与公司设备说明.md
安装前配置检查	开发文档/9、手册/04-专项/安装前配置检查规范.md

---

二、技能点（合并去重）

技能点	来源	可执行动作
E2E 脚本	sdk/tests/test_wechat_e2e.py；E2E验证指南	cd sdk/tests && python3 test_wechat_e2e.py；前置：SDK+Agent+模拟器微信
curl 验证	手册	POST localhost:8899/api/v3/message/send 等所有 unified 接口
联调顺序	机擎 §五、阿桥业务 §二	中间层 → 服务端 → 设备端；每层验证通过再下一层
手册与落地方案	SDK操作手册、使用与落地方案	更新快速启动、状态检查、路径约定、访问地址
前端联调	v0配置、前端开发规范	联调存客宝/触客宝前端与 WorkPhoneSDK 调用
设备端安装验证	Agent安装说明	验证Agent安装、配置、连接是否正常
环境预检	安装前配置检查规范	联调前检查环境是否就绪

---

三、学习材料与能力增强

3.1 从卡若AI学习

来源	学习内容	应用场景
卡若AI 木果/项目生成	React + Shadcn UI + Tailwind CSS 前端规范	前端联调标准
卡若AI 火炬/浏览器自动操作	浏览器自动化与E2E测试	Web端联调自动化
卡若AI 阿端-联调经验	联调过程中的踩坑与解决方案	避免重复踩坑

3.2 外部资源

项目/资源	用途
pytest + httpx	Python E2E测试框架，测试 unified API
Postman/Hoppscotch	API 手动测试工具
DroidRun (github.com/droidrun/droidrun)	设备端自动化E2E参考
SkillsMP 测试类 Skill（3,464个）	自动化测试最佳实践

3.3 E2E 验证清单

# 1. 健康检查
curl http://localhost:8899/health

# 2. 设备在线
curl http://localhost:8899/api/v3/devices

# 3. 发消息测试
curl -X POST http://localhost:8899/api/v3/message/send \
  -H "Content-Type: application/json" \
  -d '{"device_id":"xxx","platform":"wechat","to_id":"xxx","content":"test","msg_type":"text"}'

# 4. 完整 E2E
cd sdk/tests && python3 test_wechat_e2e.py

---

四、触发词

联调、E2E、手册、先跑通、体验验收、test_wechat_e2e、curl验证、
前端联调、设备安装验证、@阿端

完整五人分工与机擎规则：见上级 机擎/SKILL.md。