第 01 篇 · 总览
一、EP Code AI 是什么
EP Code AI 是把 AI 能力系统性地嵌入企业研发全流程的一套方案。它由两部分组成：
- 桌面应用（
app/）— 一个稳定可控的 Claude Code 客户端，承载会话、环境、供应商管理 - 方法论框架（
docs/,templates/,workflows/）— 覆盖业务、开发、测试、运维四大场景的落地规范
定位：不是替代现有研发工具，而是把 AI 能力缝合到现有工作流的关键节点上。
二、四场景的定位与边界
┌───────────────────────────────────────────────────────────┐
│ 业务场景 │
│ 需求收集 → 用户故事 → 验收标准 → 业务规则 │
│ ↓ │
├───────────────────────────────────────────────────────────┤
│ 开发场景 │
│ 设计 → API 契约 → 编码 → 代码评审 → 合并 │
│ ↓ │
├───────────────────────────────────────────────────────────┤
│ 测试场景 │
│ 策略 → 用例 → 提测 → 执行 → 回归 → 准出 │
│ ↓ │
├───────────────────────────────────────────────────────────┤
│ 运维场景 │
│ 发布 → 监控 → 告警 → 故障 → 复盘 │
└───────────────────────────────────────────────────────────┘
四场景各自的输入/输出
| 场景 | 输入 | 核心产出 | 下一场景输入 |
|---|---|---|---|
| 业务 | 市场、客户、战略 | PRD、用户故事、验收标准 | 开发需求包 |
| 开发 | 需求包 | 设计文档、API 契约、代码 | 可测版本 |
| 测试 | 可测版本 | 测试报告、准出意见 | 可上线版本 |
| 运维 | 可上线版本 | 运行指标、故障报告 | 业务反馈 |
场景衔接的"契约"
相邻场景之间必须有明确交付契约：
| 契约 | 详细 |
|---|---|
| 业务 → 开发 | 业务篇 · 需求交付 |
| 开发 → 测试 | 开发篇 · 提测达标 + 测试篇 · 入门门禁 |
| 测试 → 运维 | 测试篇 · 准出评审 + 运维篇 · 上线接收 |
| 运维 → 业务 | 运维篇 · 运行反馈 |
三、架构三层抽象
┌─────────────────────────────────────────────────┐
│ Layer 1: 能力层（What） │
│ 定义场景需要什么能力，不绑定具体工具 │
├─────────────────────────────────────────────────┤
│ Layer 2: 工具适配层（With What） │
│ 每种能力提供 2-3 个主流工具的适配方案 │
├─────────────────────────────────────────────────┤
│ Layer 3: 平台兼容层（Where） │
│ 路径、命令、脚本支持 macOS/Linux/Windows │
└─────────────────────────────────────────────────┘
能力总清单（15 项）
| ID | 能力 | 涉及场景 | 必备 |
|---|---|---|---|
| C1 | 需求文档协作 | 业务 / 开发 / 测试 | ✅ |
| C2 | 用户故事与验收标准管理 | 业务 | ✅ |
| C3 | 代码仓库与变更追踪 | 开发 / 测试 | ✅ |
| C4 | API 契约定义 | 开发 / 测试 | ✅ |
| C5 | 代码评审 | 开发 | ✅ |
| C6 | Bug/Issue 追踪 | 测试 / 开发 | ✅ |
| C7 | 测试用例管理 | 测试 | ✅ |
| C8 | 测试报告与知识沉淀 | 测试 | ✅ |
| C9 | CI/CD 流水线 | 开发 / 测试 / 运维 | ✅ |
| C10 | 部署与发布 | 运维 | ✅ |
| C11 | 监控与告警 | 运维 | ✅ |
| C12 | 日志与追踪 | 运维 | ✅ |
| C13 | 故障响应 | 运维 | ✅ |
| C14 | 即时通讯与通知 | 全场景 | 可选 |
| C15 | AI 辅助 | 全场景 | 可选 |
工具适配层示例
| 能力 | 推荐 | 备选 |
|---|---|---|
| C1 文档协作 | Markdown（通用） | Confluence / Wiki / Notion |
| C3 代码仓库 | GitLab / GitHub | Gitea / Bitbucket |
| C4 API 契约 | Markdown 接口文档（见测试篇） | Postman / YApi |
| C6 Bug 追踪 | GitLab/GitHub Issues | Jira / 禅道 / TAPD |
| C9 CI/CD | GitLab CI | Jenkins / GitHub Actions |
| C11 监控 | Prometheus + Grafana | Zabbix / Datadog |
核心思想：无论上层用什么工具，最终都落到 Markdown + Git 作为中间层。
四、平台兼容策略
| 平台 | 优先级 | 状态 | 说明 |
|---|---|---|---|
| macOS | Phase 1 | 🚧 | 当前优先，包含应用与文档 |
| Linux | Phase 2 | 📋 | 路径/命令适配 |
| Windows | Phase 3 | 📋 | PowerShell 脚本 + 路径处理 |
详见 platforms/
五、AI 在四场景中的嵌入点
| 场景 | AI 嵌入点 | 价值 |
|---|---|---|
| 业务 | 需求文本可测性分析、用户故事拆解、竞品分析总结 | 减少模糊需求 |
| 开发 | 代码评审辅助、API 契约生成、文档补全 | 降低评审负担 |
| 测试 | 用例生成、Bug 分析、报告汇总 | 提升覆盖与效率 |
| 运维 | 日志分析、告警归因、故障复盘 | 缩短 MTTR |
具体实施见各篇章的"AI 嵌入"小节。
六、如何阅读本框架
| 读者身份 | 推荐路径 |
|---|---|
| 全面了解 | 本总览 → 各篇章首页 → 按需深入 |
| 产品/业务 | 02 业务篇 |
| 架构/开发 | 03 开发篇 |
| 测试/QA | 04 测试篇 |
| 运维/SRE | 05 运维篇 |
| 项目经理 | 本总览 → 角色契约 |
七、下一步
- 继续阅读对应场景篇章
- 到
templates/挑选立即能用的模板 - 到
workflows/查看研发平台配置 - 到
platforms/macos/setup.md搭建本地环境