本指南属于 agentic-engineering-patterns 工作流中的一环，位置为 /aep-onboard → /aep-scaffold → /aep-testing-guide → [/aep-design → /aep-launch → /aep-build → /aep-wrap]。/aep-scaffold 创建项目，本指南建立质量基础设施，/aep-build 在开发功能时使用它。
用途：在 /aep-build 能自主运行前，为每个项目准备两样东西。一是工作区安装钩子 .claude/hooks/workspace-setup.sh，由 /aep-build 的 Phase 0 和会话恢复 init.sh 调用，必须安装依赖、启动或确认开发服务器、写出 .dev-workflow/ports.env（至少含 WEB_PORT、SERVER_PORT、BASE_URL、SERVER_URL），并处理端口扫描以隔离并行工作区；可选操作包括校验 .env、运行数据库迁移、填充测试账号、清理容器/缓存、从主工作区复制配置。需用 chmod +x 使其可执行，并保证可重复调用（幂等），重复运行时须检查服务器是否已在运行、依赖是否已装。二是 E2E 测试技能目录 .claude/skills/e2e-test/，内含 SKILL.md、scripts/seed.sh 及按功能划分的 <feature>-e2e.sh；构建代理在 Phase 6-8 读取该技能了解测试能力。
主要能力与测试分层：单元测试由项目自身框架（vitest、jest、pytest 等）负责，Phase 4 运行，插件不管理；API 集成测试（curl）属于 e2e-test 技能，Phase 5 运行，检查接口契约、鉴权、错误码与数据持久化；E2E 浏览器测试使用 agent-browser，Phase 6-7 运行，覆盖登录、导航、表单提交、视觉状态与多步流程。E2E 脚本需自动 source .dev-workflow/ports.env、工具不可用时标记 SKIP 而非 FAIL、保持幂等与自包含、失败时退出码为 1，可直接接入 CI（如 GitHub Actions 循环运行 scripts/*-e2e.sh）。在 macOS 上运行浏览器测试前可执行 agent-browser navigate about:blank 做冒烟检测；若 Chrome 崩溃则视为该机器不可用浏览器自动化。
适用场景与限制：全栈 Web 应用建议 API 测试与浏览器 E2E 都做；纯 API 服务做 API 测试、跳过浏览器；CLI 工具、库/包两者皆可跳过；静态站点/落地页仅做 E2E。移动应用仅对 API 后端做 API 测试，UI 用原生测试。测试随项目增量增长，首层走通即可，不必先追求覆盖率。本资料未提供具体价格、收费或平台信息。