# cc4pm 仓库理解地图（v2 — 深度探索版）

## 基本信息

| 字段 | 内容 |
|------|------|
| 名称 | cc4pm |
| 用途 | AI 驱动的产品全生命周期系统——从想法到上线发布的完整工具链 |
| 目标用户 | 产品主理人 |
| 核心方法论 | BMM（业务建模）+ CIS（创意智能）+ WDS（设计系统）+ AI First Engineering |
| 版本 | v6.1.0 |
| 数据 | 50K+ Stars、6K+ Forks、30+ 贡献者、7 种语言规则支持 |
| 荣誉 | 基于 Anthropic 黑客马拉松获奖项目 cc4pm |

## 目录结构

```
cc4pm/
├── _bmad/                 ★ 核心：四大方法论模块
│   ├── bmm/              业务建模方法（33个工作流、8个角色代理）
│   ├── cis/              创意智能战略（5个工作流、5个创意代理）
│   ├── wds/              Web设计系统（8阶段设计方法、2个设计代理）
│   ├── core/             核心工作流（头脑风暴、评审、文档工具）
│   └── _config/          清单和配置（workflow/agent/skill-manifest.csv）
├── agents/               18个工程代理（planner, code-reviewer, tdd-guide 等）
├── commands/             48个斜杠命令（/plan, /tdd, /e2e, /orchestrate 等）
├── skills/               96个技能（编码标准、架构模式、领域知识等）
├── hooks/                事件驱动自动化（PreToolUse, PostToolUse, Stop 等）
├── rules/                编码准则（通用 + 7种语言特定规则）
├── mcp-configs/          20+ MCP 服务器配置（GitHub, Supabase, Playwright 等）
├── scripts/              107个脚本（安装、钩子、会话管理、CI 验证）
├── tests/                38个测试文件
├── examples/             项目模板（Next.js SaaS, Django API, Go 微服务, Rust API）
├── docs/                 多语言文档（EN, ZH, JP, KR）
└── design-artifacts/     WDS 设计产物输出目录
```

## 四大核心模块

### 模块 1：BMM（Business Modeling Method）— 业务建模方法 ⭐⭐⭐⭐⭐

**定位**：端到端的产品开发工作流，从分析到交付

**8个角色代理**：
| 代理 | 角色 | 核心能力 |
|------|------|---------|
| 分析师（Analyst） | 📊 研究专家 | 市场分析、竞争分析、技术可行性 |
| PM（John） | 📋 产品主理人 | PRD 创建/编辑/验证 |
| 架构师（Winston） | 🏗️ 技术方案 | 系统设计、技术决策、ADR |
| 开发者（Amelia） | 💻 故事实现 | TDD、代码质量、PR |
| QA（Emma） | 🧪 测试自动化 | E2E 测试、覆盖率 |
| 敏捷大师（Bob） | 🏃 冲刺管理 | 冲刺规划、进度追踪 |
| UX设计师 | 🎨 用户体验 | 交互设计、UX规范 |
| 快速开发者 | 🚀 简单变更 | 小功能、快速修复 |

**33个工作流（按阶段）**：

| 阶段 | 关键工作流 | 代码 | 必需 | PM价值 |
|------|-----------|------|------|--------|
| **1-分析** | 头脑风暴 | BP | 否 | ⭐⭐⭐⭐⭐ |
| | 市场研究 | MR | 否 | ⭐⭐⭐⭐⭐ |
| | 领域研究 | DR | 否 | ⭐⭐⭐⭐ |
| | 技术研究 | TR | 否 | ⭐⭐⭐ |
| | 创建产品简报 | CB | 否 | ⭐⭐⭐⭐⭐ |
| **2-规划** | 创建PRD | CP | **是** | ⭐⭐⭐⭐⭐ |
| | 验证PRD | VP | 否 | ⭐⭐⭐⭐ |
| | 编辑PRD | EP | 否 | ⭐⭐⭐⭐ |
| | 创建UX设计 | CU | 否 | ⭐⭐⭐⭐ |
| **3-方案设计** | 创建架构 | CA | **是** | ⭐⭐⭐⭐ |
| | 创建Epics和Stories | CE | **是** | ⭐⭐⭐⭐⭐ |
| | 实现就绪检查 | IR | **是** | ⭐⭐⭐⭐ |
| **4-实现** | 冲刺规划 | SP | **是** | ⭐⭐⭐⭐⭐ |
| | 冲刺状态 | SS | 否 | ⭐⭐⭐⭐ |
| | 创建故事 | CS | 否 | ⭐⭐⭐ |
| | 代码审查 | CR | 否 | ⭐⭐⭐ |
| | 回顾总结 | ER | 否 | ⭐⭐⭐⭐ |
| **随时** | 快速规范 | QS | 否 | ⭐⭐⭐⭐ |
| | 路线纠正 | CC | 否 | ⭐⭐⭐⭐⭐ |

### 模块 2：CIS（Creative Intelligence Strategy）— 创意智能战略 ⭐⭐⭐⭐⭐

**定位**：创意思维和战略规划工具箱

**5个创意代理**：
| 代理 | 风格 | 核心能力 |
|------|------|---------|
| 头脑风暴教练 | "YES AND" 建设者 | 36种创意技巧，生成100+想法 |
| 创新战略家（维克托） | 棋手，简单问题 | 30种创新框架，战略路线图 |
| 设计思维教练（玛雅） | 感官隐喻 | 5阶段人本设计，同理心洞察 |
| 问题解决专家（Quinn） | 好奇、系统 | TRIZ、约束理论、根本原因分析 |
| 故事讲述大师（索菲亚） | 异想天开 | 25种故事框架，叙事和内容 |

**5个工作流**：
| 工作流 | 输入 | 输出 | PM价值 |
|--------|------|------|--------|
| 头脑风暴 | 主题/挑战 | 100+想法（分7大类36种技巧） | ⭐⭐⭐⭐⭐ |
| 设计思维 | 用户问题 | 同理心洞察、用户画像、原型 | ⭐⭐⭐⭐⭐ |
| 创新策略 | 商业模式/市场 | 战略路线图、蓝海机会 | ⭐⭐⭐⭐⭐ |
| 问题解决 | 复杂问题 | 根本原因、系统解决方案 | ⭐⭐⭐⭐ |
| 故事讲述 | 产品/品牌 | 故事线、演示文稿、叙事 | ⭐⭐⭐⭐⭐ |

**创意技巧库**（36种，分7大类）：
- Collaborative (6): Yes And, 圆桌写作, 随机刺激...
- Creative (11): What If, 类比思维, 第一性原理...
- Deep (8): 五问法, 形态分析, 假设反转...
- Introspective (6): 内在小孩, 价值考古...
- Structured (8): SCAMPER, 六顶思考帽, 思维导图...
- Theatrical (5): 时空谈话秀, 外星人人类学家...
- Wild (5): 混沌工程, 海盗代码...

### 模块 3：WDS（Web Design System）— Web设计系统方法 ⭐⭐⭐⭐

**定位**：战略性产品设计——从用户心理到设计规范

**2个设计代理**：
| 代理 | 阶段 | 核心能力 |
|------|------|---------|
| Saga（故事女神） | 阶段1-2 | 产品简报、Trigger Map（用户心理映射） |
| Freya（UX设计师） | 阶段3-8 | UX场景、规范、原型、设计系统 |

**8阶段设计方法**：
| 阶段 | 工作流 | 必需 | 输出 | PM价值 |
|------|--------|------|------|--------|
| 0 | 利益相关方对齐 | 否 | 项目协议 | ⭐⭐⭐⭐ |
| 1 | 项目简报 | **是** | 愿景、定位、成功标准 | ⭐⭐⭐⭐⭐ |
| 2 | Trigger Map | **是** | 用户心理→功能映射 | ⭐⭐⭐⭐⭐ |
| 3 | UX场景 | **是** | 用户旅程定义 | ⭐⭐⭐⭐⭐ |
| 4 | UX设计 | **是** | 概念规范、原型 | ⭐⭐⭐⭐ |
| 5 | 代理开发 | 否 | AI辅助实现 | ⭐⭐⭐ |
| 6 | 资产生成 | 否 | 图片、视频、内容 | ⭐⭐⭐ |
| 7 | 设计系统 | 否 | 组件库、设计tokens | ⭐⭐⭐ |
| 8 | 产品演进 | 否 | 持续改进 | ⭐⭐⭐⭐ |

### 模块 4：工程工具链 ⭐⭐⭐⭐

**定位**：代码质量保障和开发效率提升

**18个工程代理**（按层级）：
- **Opus 层**（复杂推理）：planner, architect, chief-of-staff
- **Sonnet 层**（代码工作）：code-reviewer, security-reviewer, e2e-runner, tdd-guide, 各语言reviewer等
- **Haiku 层**（快速任务）：doc-updater

**48个命令**（按使用频率）：
- **高频**：/plan, /tdd, /e2e, /code-review, /build-fix
- **编排**：/orchestrate, /multi-plan, /multi-execute
- **会话**：/save-session, /resume-session, /sessions
- **学习**：/learn, /skill-create, /evolve, /promote

**钩子系统**（6类自动化）：
- PreToolUse：安全检查、参数验证
- PostToolUse：自动格式化、类型检查、质量门控
- Stop：模式提取、成本跟踪
- SessionStart/End：上下文加载/持久化

**规则引擎**（7种语言）：
- 通用：安全、编码风格、测试、Git工作流、性能
- 语言特定：TypeScript, Python, Go, Swift, Kotlin, Perl, PHP

## 使用场景

### 场景 1：新产品从0到1（PM主导）
**涉及模块**：CIS → BMM → WDS
**流程**：
1. CIS 头脑风暴 → 生成100+想法
2. CIS 创新策略 → 蓝海分析、商业模式
3. BMM 市场研究 → 竞争分析、用户需求
4. WDS 项目简报 → 愿景、定位、成功标准
5. WDS Trigger Map → 用户心理映射
6. BMM 创建PRD → 完整需求文档
7. BMM 创建架构 → 技术方案
8. WDS UX场景 → 用户旅程
9. BMM 冲刺规划 → 开发计划
10. 工程工具链 → 开发、测试、审查

### 场景 2：已有产品优化（PM+工程协作）
**涉及模块**：CIS → BMM
**流程**：
1. CIS 设计思维 → 用户同理心分析
2. CIS 问题解决 → 根本原因定位
3. BMM 编辑PRD → 更新需求
4. BMM 冲刺规划 → 优化迭代
5. 工程工具链 → 实现和验证

### 场景 3：产品发布前验证（PM主导）
**涉及模块**：BMM + 工程工具
**流程**：
1. BMM 实现就绪检查 → 确认所有阶段完成
2. /e2e → 端到端用户流测试
3. /code-review → 质量和安全审查
4. BMM 回顾总结 → 经验沉淀

### 场景 4：产品演示和汇报（PM主导）
**涉及模块**：CIS
**流程**：
1. CIS 故事讲述 → 产品叙事
2. CIS 创新策略 → 价值定位
3. WDS 产品简报 → 项目概览

## 学习路径建议

### 产品主理人（核心路径）

**第一优先级：从想法到验证**
1. CIS 头脑风暴 + 创意技巧 → 产品灵感
2. BMM 市场研究 → 市场验证
3. WDS Trigger Map → 用户心理分析
4. BMM 创建PRD → 需求文档

**第二优先级：从设计到开发**
5. WDS UX场景 → 用户旅程
6. BMM 创建架构 → 技术方案
7. BMM 冲刺规划 → 开发迭代

**第三优先级：上线与发布**
8. /e2e 和 /code-review → 质量保障
9. CIS 故事讲述 → 产品叙事
10. /orchestrate → 工作流自动化

### 独立开发者

1. 工程工具链全景 → /plan, /tdd, /code-review
2. BMM 市场研究 + 领域研究 → 产品方向
3. CIS 设计思维 → 用户洞察
4. /learn → 沉淀开发经验

### 技术合伙人

1. 工程工具链全景 → 理解架构
2. BMM 完整工作流 → 端到端管理
3. hooks + rules → 团队标准化
4. /orchestrate + /multi-plan → 高效编排

## 方法论与最佳实践

### 核心设计哲学

1. **以用户心理为驱动**（WDS Trigger Map）：功能设计从"为什么"开始
2. **AI First Product Development**：AI 代理作为团队成员参与全流程
3. **质量内建**：从 PRD 到代码，每个阶段都有验证
4. **持续学习**：从每次会话中提取知识，演进为技能
5. **微文件架构**：每个工作流步骤自包含，按需加载

### 关键设计决策

| 决策 | 选择 | 原因 |
|------|------|------|
| 产品方法论 | BMM 4阶段 | 覆盖从分析到交付的完整生命周期 |
| 创意工具 | CIS 5个工作流 | 多维度激发创意和战略思维 |
| 设计方法 | WDS 8阶段 | 从心理驱动力到规范的完整链路 |
| 代理架构 | 专业化子代理 | 每个角色专注特定领域 |
| 模型选择 | Opus/Sonnet/Haiku 三层 | 按任务复杂度分配成本 |
| 配置 | 中文通信 + 微文件 | 适配国内PM + 高效加载 |

---

*本理解地图由 courseware-generator 深度探索后重新生成*
*生成日期：2026-03-22*
*探索范围：_bmad/(BMM/CIS/WDS/Core) + agents/ + commands/ + skills/ + hooks/ + rules/ + scripts/ + examples/*
*目标人群：产品主理人*