197 lines
5.2 KiB
Markdown
197 lines
5.2 KiB
Markdown
# 🔌 与开发模板集成指南
|
||
|
||
> 本文档说明如何将项目管理 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 成为你的完整开发团队！
|