# 🔌 与开发模板集成指南

> 本文档说明如何将项目管理 Skill 与开发模板（1-10 目录）深度集成。

---

## 一、开发模板目录结构

```
📁 开发模板/
│
├── 📄 AI开发引擎.md          ← 🧠 总控：一键展开全部
├── 📄 代码核心提取器.md       ← 🔬 分析项目、提取核心
├── 📄 模板使用说明书.md       ← 📖 使用指南
│
├── 📁 .cursor/skills/        ← 🎯 Skill 存放位置
│   └── dev-template-project-manager/
│
├── 📁 1、需求/               ← 💰 CFO + 产品负责人
├── 📁 2、架构/               ← 🏗️ CTO + 架构师
├── 📁 3、原型/               ← 🎨 UI/UX 设计师
├── 📁 4、前端/               ← ⚛️ 前端技术专家
├── 📁 5、接口/               ← 🔌 API 架构师
├── 📁 6、后端/               ← 🐍 Python 架构师
├── 📁 7、数据库/             ← 💾 DBA
├── 📁 8、部署/               ← 🚀 DevOps 运维
├── 📁 9、手册/               ← 📚 技术文档专家
└── 📁 10、项目管理/          ← 📊 高级 PM
```

---

## 二、集成工作流

### 2.1 项目启动流程

```mermaid
graph TB
    A[1. 初始化项目工作区] --> B[2. 展开目录1 需求]
    B --> C[3. 展开目录2 架构]
    C --> D[4. 任务拆解到执行表]
    D --> E[5. 开始开发循环]
    
    subgraph 开发循环
        E --> F[展开目录3-8]
        F --> G[更新进度]
        G --> H{完成?}
        H -->|否| F
        H -->|是| I[展开目录9 手册]
    end
    
    I --> J[10. 生成复盘报告]
```

### 2.2 目录展开与任务关联

每次展开目录时，自动关联到执行表任务：

```yaml
目录展开 → 任务关联:
  展开目录1 需求:
    - 创建任务: T001 需求分析
    - 输出: .apm/docs/requirements.md
    
  展开目录2 架构:
    - 创建任务: T002 架构设计
    - 输出: .apm/docs/architecture.md
    
  展开目录3-9:
    - 创建对应任务
    - 输出对应文档/代码
```

---

## 三、文档自动同步

### 3.1 变更传播规则

```yaml
需求变更 (目录1):
  自动更新:
    - 目录2 架构 (如影响技术方案)
    - 目录5 接口 (如影响 API 设计)
    - 目录10 执行表 (新增/调整任务)

接口变更 (目录5):
  自动更新:
    - 目录4 前端 (调用方式)
    - 目录6 后端 (实现代码)
    - 目录9 手册 (API 文档)

数据库变更 (目录7):
  自动更新:
    - 目录6 后端 (Model 定义)
    - 目录5 接口 (数据结构)
```

---

## 四、集成指令

### 4.1 模板联动指令

```
# 从开发模板展开到项目管理
@模板联动 目录1→项目管理
  - 读取 1、需求/_智能展开.md
  - 生成需求文档
  - 拆解任务到执行表

# 从项目管理同步到开发模板
@模板联动 项目管理→全量
  - 基于执行表进度
  - 更新各目录文档状态
```

### 4.2 批量展开指令

```
# 按阶段批量展开
@批量展开 规划阶段   → 展开目录1、2
@批量展开 设计阶段   → 展开目录3、5、7
@批量展开 开发阶段   → 展开目录4、6
@批量展开 交付阶段   → 展开目录8、9
```

---

## 五、项目目录结构

使用本 Skill 后，项目目录应该如下：

```
📁 项目根目录/
│
├── 📁 .apm/                          ← 项目管理工作区
│   ├── 📄 project-state.md           ← 项目状态总览
│   ├── 📄 execution-table.md         ← 执行表
│   ├── 📄 conversation-log.md        ← 对话记录
│   ├── 📄 prompts-library.md         ← 提示词库
│   └── 📁 docs/                      ← 生成的项目文档
│
├── 📁 app/                           ← 前端代码 (目录4)
├── 📁 backend/                       ← 后端代码 (目录6)
├── 📁 scripts/                       ← 部署脚本 (目录8)
└── 📄 README.md                      ← 项目说明
```

---

## 六、最佳实践

### 6.1 项目启动清单

```markdown
## 新项目启动清单

- [ ] 初始化项目工作区 (`@项目管理 初始化项目工作区`)
- [ ] 展开目录1 生成需求文档
- [ ] 展开目录2 确定架构设计
- [ ] 拆解任务到执行表
- [ ] 设定里程碑
- [ ] 开始开发循环
```

### 6.2 每日工作流

```markdown
## 每日工作流

1. **早间** - 查看进度 (`@项目管理 查看进度`)
2. **开发中** - 遇到问题及时记录
3. **完成任务** - 更新进度 (`@项目管理 更新进度`)
4. **下班前** - 生成站会纪要 (`@项目管理 站会纪要`)
```

---

## 七、常见问题

### Q: 如何同时使用开发模板和项目管理 Skill？

A: 两者是互补关系：
- 开发模板提供各角色的专业指导
- 项目管理 Skill 提供统一的进度追踪和上下文管理

使用时用 `@项目管理 展开目录[N]` 调用开发模板的智能展开，同时自动更新执行表和项目状态。

### Q: 生成的文档存放在哪里？

A: 统一存放在 `.apm/docs/` 目录，方便管理和版本控制。

---

> **记住**: 开发模板是"专家团队"，项目管理 Skill 是"项目经理"。两者配合，让 AI 成为你的完整开发团队！