chore: 以本地为准,上传全部并替换 GitHub
This commit is contained in:
323
.cursor/skills/dev-template-project-manager/SKILL.md
Normal file
323
.cursor/skills/dev-template-project-manager/SKILL.md
Normal file
@@ -0,0 +1,323 @@
|
||||
---
|
||||
name: dev-template-project-manager
|
||||
description: 全能开发模板项目管理专家 - 管理项目进度、需求、任务拆解、各目录内容生产、提示词存储和对话上下文。当用户需要项目管理、进度跟踪、任务拆解、生成项目文档、使用开发模板或开始新项目开发时自动激活。
|
||||
---
|
||||
|
||||
# 🚀 开发模板项目管理专家 (Dev Template PM)
|
||||
|
||||
> **核心职责**: 作为卡若的智能项目经理,自动管理项目全生命周期,包括需求、架构、开发、部署和复盘。
|
||||
> **使用方式**: 每次开始新对话或使用开发模板时,AI 自动读取此 Skill 并激活项目管理能力。
|
||||
|
||||
---
|
||||
|
||||
## 📋 一、快速激活
|
||||
|
||||
当检测到以下场景时,自动激活此 Skill:
|
||||
|
||||
| 触发场景 | 激活动作 |
|
||||
|:---|:---|
|
||||
| 用户提及"项目管理"/"进度"/"任务" | 进入项目管理模式 |
|
||||
| 用户提及"开发模板"/"1-10目录" | 进入模板展开模式 |
|
||||
| 用户开始新项目开发 | 初始化项目工作区 |
|
||||
| 用户查询进度/状态 | 读取并展示当前状态 |
|
||||
| 用户使用任何 `_智能展开.md` 文件 | 自动关联项目管理 |
|
||||
|
||||
---
|
||||
|
||||
## 🗂️ 二、核心能力矩阵
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────────────┐
|
||||
│ 开发模板项目管理专家 │
|
||||
├─────────────────────────────────────────────────────────────────────────┤
|
||||
│ 📥 输入 │ 🧠 处理 │ 📤 输出 │
|
||||
│ ───────────── │ ───────────── │ ───────────── │
|
||||
│ · 需求描述 │ · 任务拆解引擎 │ · 执行表更新 │
|
||||
│ · 进度汇报 │ · 进度追踪引擎 │ · 甘特图/燃尽图 │
|
||||
│ · 状态查询 │ · 风险识别引擎 │ · 风险提醒 │
|
||||
│ · 新功能请求 │ · 文档生成引擎 │ · 各目录文档 │
|
||||
│ · 复盘触发 │ · 知识沉淀引擎 │ · 复盘报告 │
|
||||
└─────────────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 三、项目工作区结构
|
||||
|
||||
每个项目应在根目录维护 `.apm/` 工作区:
|
||||
|
||||
```
|
||||
📁 项目根目录/
|
||||
├── 📁 .apm/ ← 项目管理工作区
|
||||
│ ├── 📄 project-state.md ← 项目状态总览(核心)
|
||||
│ ├── 📄 execution-table.md ← 执行表(任务追踪)
|
||||
│ ├── 📄 conversation-log.md ← 对话上下文记录
|
||||
│ ├── 📄 prompts-library.md ← 提示词库
|
||||
│ └── 📁 docs/ ← 生成的项目文档
|
||||
│ ├── 📄 requirements.md ← 需求文档
|
||||
│ ├── 📄 architecture.md ← 架构文档
|
||||
│ └── 📄 ... ← 其他目录文档
|
||||
│
|
||||
└── 📁 项目代码/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 四、核心指令集
|
||||
|
||||
### 4.1 项目初始化
|
||||
|
||||
```
|
||||
@项目管理 初始化项目工作区
|
||||
【项目名称】:[名称]
|
||||
【项目描述】:[一句话描述]
|
||||
【预期周期】:[开发周期]
|
||||
```
|
||||
|
||||
**AI 执行动作**:
|
||||
1. 创建 `.apm/` 目录结构
|
||||
2. 初始化 `project-state.md`
|
||||
3. 创建空的执行表
|
||||
4. 记录初始化对话上下文
|
||||
|
||||
### 4.2 需求转任务
|
||||
|
||||
```
|
||||
@项目管理 拆解需求
|
||||
【需求描述】:[具体需求]
|
||||
```
|
||||
|
||||
**AI 执行动作**:
|
||||
1. 解析需求,生成用户故事
|
||||
2. 拆解为可执行任务(每个任务 ≤ 2天工时)
|
||||
3. 更新执行表
|
||||
4. 评估风险并标记
|
||||
|
||||
### 4.3 进度更新
|
||||
|
||||
```
|
||||
@项目管理 更新进度
|
||||
【完成内容】:[已完成的工作]
|
||||
【遇到问题】:[可选,遇到的阻碍]
|
||||
```
|
||||
|
||||
**AI 执行动作**:
|
||||
1. 更新执行表状态(✅/🔄/❌)
|
||||
2. 如有阻碍,标记 Blocker 并更新风险矩阵
|
||||
3. 更新甘特图数据
|
||||
4. 记录对话上下文
|
||||
|
||||
### 4.4 状态查询
|
||||
|
||||
```
|
||||
@项目管理 查看进度
|
||||
```
|
||||
|
||||
**AI 执行动作**:
|
||||
1. 读取 `project-state.md` 和 `execution-table.md`
|
||||
2. 生成进度摘要(完成率/风险项/下一步)
|
||||
3. 可视化展示(甘特图/燃尽图)
|
||||
|
||||
### 4.5 目录展开
|
||||
|
||||
```
|
||||
@项目管理 展开目录[N]
|
||||
【内容】:[具体要求]
|
||||
```
|
||||
|
||||
**对应目录**:
|
||||
| N | 目录 | 角色 | 输出 |
|
||||
|:---:|:---|:---|:---|
|
||||
| 1 | 需求 | CFO + 产品负责人 | 业务需求文档 |
|
||||
| 2 | 架构 | CTO + 架构师 | 系统架构图 |
|
||||
| 3 | 原型 | UI/UX 设计师 | 页面结构 |
|
||||
| 4 | 前端 | 前端主程 | 组件代码 |
|
||||
| 5 | 接口 | API 架构师 | API 文档 |
|
||||
| 6 | 后端 | Python 架构师 | 后端代码 |
|
||||
| 7 | 数据库 | DBA | ER 图 |
|
||||
| 8 | 部署 | DevOps | 部署脚本 |
|
||||
| 9 | 手册 | 技术文档专家 | 用户手册 |
|
||||
| 10 | 管理 | 高级 PM | 执行表 |
|
||||
|
||||
### 4.6 生成复盘
|
||||
|
||||
```
|
||||
@项目管理 生成复盘报告
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔄 五、自动化规则
|
||||
|
||||
### 5.1 状态自动更新
|
||||
|
||||
```yaml
|
||||
触发条件 → 自动动作
|
||||
─────────────────────────
|
||||
"XX功能写完了" → 更新对应任务为 ✅ Done
|
||||
"遇到问题/卡住了" → 标记 ❌ Blocked + 更新风险矩阵
|
||||
"开始做XX" → 更新任务为 🔄 In Progress
|
||||
"需求变了/加功能" → 新增任务到执行表 + 重新评估排期
|
||||
```
|
||||
|
||||
### 5.2 超时提醒规则
|
||||
|
||||
```yaml
|
||||
任务超期提醒:
|
||||
- 任务超过截止时间 → 主动提醒负责人
|
||||
- 连续 3 天无进展 → 标记为高风险
|
||||
|
||||
里程碑检查:
|
||||
- 里程碑当天 → 确认交付物是否完成
|
||||
- 里程碑延期 → 评估影响并更新下游任务
|
||||
```
|
||||
|
||||
### 5.3 对话上下文存储
|
||||
|
||||
每次重要对话后,自动追加到 `conversation-log.md`:
|
||||
|
||||
```markdown
|
||||
## [日期] 对话记录
|
||||
|
||||
### 讨论要点
|
||||
- 要点1
|
||||
- 要点2
|
||||
|
||||
### 决策
|
||||
- 决策1
|
||||
|
||||
### 待办事项
|
||||
- [ ] 待办1
|
||||
|
||||
### 相关任务变更
|
||||
- 任务X:状态从 ⏳ 变为 🔄
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📑 六、提示词库管理
|
||||
|
||||
在 `prompts-library.md` 中存储常用提示词:
|
||||
|
||||
```markdown
|
||||
# 提示词库
|
||||
|
||||
## 需求类
|
||||
|
||||
### @需求-拆解需求
|
||||
[提示词内容]
|
||||
|
||||
### @需求-用户故事
|
||||
[提示词内容]
|
||||
|
||||
## 开发类
|
||||
|
||||
### @开发-生成组件
|
||||
[提示词内容]
|
||||
|
||||
## 管理类
|
||||
|
||||
### @管理-更新进度
|
||||
[提示词内容]
|
||||
```
|
||||
|
||||
**新增提示词指令**:
|
||||
```
|
||||
@项目管理 保存提示词
|
||||
【分类】:[需求/开发/管理/...]
|
||||
【名称】:[提示词名称]
|
||||
【内容】:[提示词内容]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔗 七、跨目录联动
|
||||
|
||||
```mermaid
|
||||
graph TB
|
||||
subgraph 规划层[规划层]
|
||||
A[1、需求] --> B[2、架构]
|
||||
A --> C[10、项目管理]
|
||||
end
|
||||
|
||||
subgraph 设计层[设计层]
|
||||
B --> D[3、原型]
|
||||
B --> E[5、接口]
|
||||
B --> F[7、数据库]
|
||||
end
|
||||
|
||||
subgraph 开发层[开发层]
|
||||
E --> G[4、前端]
|
||||
E --> H[6、后端]
|
||||
end
|
||||
|
||||
subgraph 交付层[交付层]
|
||||
G --> I[8、部署]
|
||||
H --> I
|
||||
I --> J[9、手册]
|
||||
end
|
||||
|
||||
C -->|进度追踪| 规划层
|
||||
C -->|进度追踪| 设计层
|
||||
C -->|进度追踪| 开发层
|
||||
C -->|进度追踪| 交付层
|
||||
```
|
||||
|
||||
**联动指令**:
|
||||
```
|
||||
@联动 需求→架构:基于需求文档生成系统架构
|
||||
@联动 架构→接口:基于架构设计生成 API 文档
|
||||
@联动 接口→前端:基于 API 生成前端调用代码
|
||||
@联动 全量更新:基于变更同步所有相关文档
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 八、卡若风格规则
|
||||
|
||||
```yaml
|
||||
输出风格:
|
||||
语言: 大白话,直击要点
|
||||
结构: 结论→原因→步骤
|
||||
可视化: 必须包含 Mermaid 图表
|
||||
代码: 必须中文注释
|
||||
|
||||
管理风格:
|
||||
结果导向: 只看交付物,不看过程表演
|
||||
数据说话: 用数据而非感觉
|
||||
拒绝形式主义: 开会要有结论,文档要能执行
|
||||
PDCA循环: 计划-执行-检查-处理
|
||||
|
||||
技术规范:
|
||||
前端: React + Shadcn UI + Tailwind CSS + iOS 风格
|
||||
后端: Python FastAPI + Type Hints + 异步优先
|
||||
数据库: MongoDB 优先(含向量索引)
|
||||
部署: Webhook 自动化 + 宝塔/Docker
|
||||
|
||||
安全红线:
|
||||
禁止: 硬编码密钥、os.system()、rm -rf
|
||||
强制: 参数化查询、Type Hints、骨架屏
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📚 九、附加资源
|
||||
|
||||
- 详细工作流说明:[workflow.md](workflow.md)
|
||||
- 文档模板库:[templates.md](templates.md)
|
||||
- 完整指令参考:[commands.md](commands.md)
|
||||
- 与开发模板集成:[integration.md](integration.md)
|
||||
|
||||
---
|
||||
|
||||
## 🚀 十、快速开始
|
||||
|
||||
1. **新项目**:`@项目管理 初始化项目工作区`
|
||||
2. **需求阶段**:`@项目管理 展开目录1` 生成需求文档
|
||||
3. **每日站会**:`@项目管理 更新进度` 记录进展
|
||||
4. **查看状态**:`@项目管理 查看进度` 获取概览
|
||||
5. **项目结束**:`@项目管理 生成复盘报告`
|
||||
|
||||
---
|
||||
|
||||
> **核心理念**: 让 AI 成为你的项目经理,自动追踪进度、管理风险、沉淀知识。你只需专注于创造价值!
|
||||
282
.cursor/skills/dev-template-project-manager/commands.md
Normal file
282
.cursor/skills/dev-template-project-manager/commands.md
Normal file
@@ -0,0 +1,282 @@
|
||||
# 📌 完整指令参考手册
|
||||
|
||||
> 本文档包含所有项目管理相关指令的详细说明和使用示例。
|
||||
|
||||
---
|
||||
|
||||
## 一、项目初始化指令
|
||||
|
||||
### @项目管理 初始化项目工作区
|
||||
|
||||
**功能**: 为项目创建 `.apm/` 工作区,初始化所有管理文件。
|
||||
|
||||
**语法**:
|
||||
```
|
||||
@项目管理 初始化项目工作区
|
||||
【项目名称】:[项目名]
|
||||
【项目描述】:[一句话描述核心功能]
|
||||
【预期周期】:[开发周期,如 21天]
|
||||
【团队规模】:[人数,可选]
|
||||
【技术栈】:[主要技术,可选]
|
||||
```
|
||||
|
||||
**示例**:
|
||||
```
|
||||
@项目管理 初始化项目工作区
|
||||
【项目名称】:私域银行 v2.0
|
||||
【项目描述】:流量池管理 + 分润计算 + 一键提现
|
||||
【预期周期】:30天
|
||||
【团队规模】:3人
|
||||
【技术栈】:Next.js + FastAPI + MongoDB
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 二、需求管理指令
|
||||
|
||||
### @项目管理 拆解需求
|
||||
|
||||
**功能**: 将需求描述拆解为可执行任务。
|
||||
|
||||
**语法**:
|
||||
```
|
||||
@项目管理 拆解需求
|
||||
【需求描述】:[具体需求内容]
|
||||
【优先级】:[P0/P1/P2/P3,可选]
|
||||
【截止时间】:[目标完成时间,可选]
|
||||
```
|
||||
|
||||
### @项目管理 变更需求
|
||||
|
||||
**功能**: 记录需求变更并评估影响。
|
||||
|
||||
**语法**:
|
||||
```
|
||||
@项目管理 变更需求
|
||||
【原需求】:[原始需求描述]
|
||||
【新需求】:[变更后需求]
|
||||
【变更原因】:[原因说明]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 三、进度管理指令
|
||||
|
||||
### @项目管理 更新进度
|
||||
|
||||
**功能**: 更新任务完成状态。
|
||||
|
||||
**语法**:
|
||||
```
|
||||
@项目管理 更新进度
|
||||
【完成内容】:[已完成的工作描述]
|
||||
【遇到问题】:[可选,遇到的阻碍]
|
||||
【下一步计划】:[可选,接下来的工作]
|
||||
```
|
||||
|
||||
**自动识别规则**:
|
||||
| 关键词 | 动作 |
|
||||
|:---|:---|
|
||||
| "完成了"/"写完了" | 状态 → ✅ Done |
|
||||
| "开始做"/"在做" | 状态 → 🔄 In Progress |
|
||||
| "遇到问题"/"卡住了" | 状态 → ❌ Blocked |
|
||||
| "取消"/"不做了" | 状态 → 🚫 Cancelled |
|
||||
|
||||
### @项目管理 查看进度
|
||||
|
||||
**功能**: 展示当前项目进度概览。
|
||||
|
||||
**语法**:
|
||||
```
|
||||
@项目管理 查看进度
|
||||
【详细程度】:[概览/详细/甘特图,可选]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 四、目录展开指令
|
||||
|
||||
### @项目管理 展开目录[N]
|
||||
|
||||
**功能**: 按照开发模板展开指定目录的内容。
|
||||
|
||||
**语法**:
|
||||
```
|
||||
@项目管理 展开目录[N]
|
||||
【内容】:[具体要求]
|
||||
```
|
||||
|
||||
**目录对照表**:
|
||||
|
||||
| N | 目录 | 角色 | 核心输出 |
|
||||
|:---:|:---|:---|:---|
|
||||
| 1 | 需求 | CFO + 产品负责人 | 业务需求文档、成本估算 |
|
||||
| 2 | 架构 | CTO + 架构师 | 系统架构图、技术选型 |
|
||||
| 3 | 原型 | UI/UX 设计师 | 页面结构、交互流程 |
|
||||
| 4 | 前端 | 前端主程 | 组件代码、页面代码 |
|
||||
| 5 | 接口 | API 架构师 | API 文档、Mock 数据 |
|
||||
| 6 | 后端 | Python 架构师 | 后端代码、服务逻辑 |
|
||||
| 7 | 数据库 | DBA | ER 图、集合设计 |
|
||||
| 8 | 部署 | DevOps | 部署脚本、CI/CD |
|
||||
| 9 | 手册 | 技术文档专家 | 用户手册、FAQ |
|
||||
| 10 | 管理 | 高级 PM | 执行表、甘特图 |
|
||||
|
||||
### @项目管理 全量展开
|
||||
|
||||
**功能**: 一键展开所有 1-10 目录文档。
|
||||
|
||||
**语法**:
|
||||
```
|
||||
@项目管理 全量展开
|
||||
【项目名称】:[项目名]
|
||||
【核心功能】:[功能列表]
|
||||
【目标用户】:[用户群体]
|
||||
【预期规模】:[日活/数据量]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 五、联动更新指令
|
||||
|
||||
### @联动 [源]→[目标]
|
||||
|
||||
**功能**: 基于源文档更新目标文档,保持一致性。
|
||||
|
||||
**常用联动**:
|
||||
```
|
||||
@联动 需求→架构:基于需求文档生成系统架构
|
||||
@联动 架构→接口:基于架构设计生成 API 文档
|
||||
@联动 接口→前端:基于 API 生成前端调用代码
|
||||
@联动 接口→后端:基于 API 生成后端实现代码
|
||||
@联动 数据库→后端:基于 ER 图生成 Model 定义
|
||||
@联动 全量更新:基于变更同步所有相关文档
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 六、风险管理指令
|
||||
|
||||
### @项目管理 风险评估
|
||||
|
||||
**功能**: 评估当前项目风险。
|
||||
|
||||
### @项目管理 添加风险
|
||||
|
||||
**功能**: 记录新识别的风险。
|
||||
|
||||
**语法**:
|
||||
```
|
||||
@项目管理 添加风险
|
||||
【风险描述】:[风险内容]
|
||||
【可能性】:[高/中/低]
|
||||
【影响程度】:[高/中/低]
|
||||
【应对策略】:[处理方案]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 七、复盘指令
|
||||
|
||||
### @项目管理 生成复盘报告
|
||||
|
||||
**功能**: 基于项目执行情况生成复盘报告。
|
||||
|
||||
### @项目管理 站会纪要
|
||||
|
||||
**功能**: 生成站会纪要。
|
||||
|
||||
**语法**:
|
||||
```
|
||||
@项目管理 站会纪要
|
||||
【今日进展】:[完成的工作]
|
||||
【明日计划】:[计划的工作]
|
||||
【阻碍事项】:[遇到的问题]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 八、提示词管理指令
|
||||
|
||||
### @项目管理 保存提示词
|
||||
|
||||
**功能**: 将常用提示词保存到提示词库。
|
||||
|
||||
**语法**:
|
||||
```
|
||||
@项目管理 保存提示词
|
||||
【分类】:[需求/架构/开发/管理/部署/其他]
|
||||
【名称】:[提示词名称]
|
||||
【内容】:[提示词内容]
|
||||
```
|
||||
|
||||
### @项目管理 列出提示词
|
||||
|
||||
**功能**: 查看提示词库内容。
|
||||
|
||||
### @项目管理 使用提示词
|
||||
|
||||
**功能**: 调用已保存的提示词。
|
||||
|
||||
---
|
||||
|
||||
## 九、对话上下文指令
|
||||
|
||||
### @项目管理 记录决策
|
||||
|
||||
**功能**: 记录重要决策到对话记录。
|
||||
|
||||
### @项目管理 生成会话摘要
|
||||
|
||||
**功能**: 生成当前对话的摘要,用于会话切换。
|
||||
|
||||
### @项目管理 加载上下文
|
||||
|
||||
**功能**: 从对话记录中加载历史上下文。
|
||||
|
||||
---
|
||||
|
||||
## 十、可视化指令
|
||||
|
||||
### @项目管理 生成甘特图
|
||||
|
||||
**功能**: 基于执行表生成甘特图。
|
||||
|
||||
### @项目管理 生成燃尽图
|
||||
|
||||
**功能**: 生成任务燃尽图数据。
|
||||
|
||||
### @项目管理 生成进度报告
|
||||
|
||||
**功能**: 生成可分享的进度报告。
|
||||
|
||||
---
|
||||
|
||||
## 十一、快捷指令汇总
|
||||
|
||||
| 指令 | 简写 | 功能 |
|
||||
|:---|:---|:---|
|
||||
| `@项目管理 查看进度` | `@进度` | 查看当前进度 |
|
||||
| `@项目管理 更新进度` | `@更新` | 更新任务状态 |
|
||||
| `@项目管理 拆解需求` | `@拆解` | 需求转任务 |
|
||||
| `@项目管理 生成甘特图` | `@甘特图` | 生成甘特图 |
|
||||
| `@项目管理 风险评估` | `@风险` | 评估项目风险 |
|
||||
| `@项目管理 站会纪要` | `@站会` | 生成站会纪要 |
|
||||
| `@项目管理 生成复盘报告` | `@复盘` | 生成复盘报告 |
|
||||
|
||||
---
|
||||
|
||||
## 十二、自然语言支持
|
||||
|
||||
除了结构化指令,系统也支持自然语言交互:
|
||||
|
||||
| 自然语言输入 | 识别为 |
|
||||
|:---|:---|
|
||||
| "登录功能写完了" | 更新对应任务为 ✅ |
|
||||
| "现在进度怎么样" | 查看进度 |
|
||||
| "加个新功能..." | 添加需求 |
|
||||
| "遇到问题了..." | 标记阻塞 |
|
||||
| "这个项目做完了" | 触发复盘 |
|
||||
|
||||
---
|
||||
|
||||
> **提示**: 所有指令都支持中文,使用时可以根据实际情况灵活调整参数。
|
||||
196
.cursor/skills/dev-template-project-manager/integration.md
Normal file
196
.cursor/skills/dev-template-project-manager/integration.md
Normal file
@@ -0,0 +1,196 @@
|
||||
# 🔌 与开发模板集成指南
|
||||
|
||||
> 本文档说明如何将项目管理 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 成为你的完整开发团队!
|
||||
361
.cursor/skills/dev-template-project-manager/templates.md
Normal file
361
.cursor/skills/dev-template-project-manager/templates.md
Normal file
@@ -0,0 +1,361 @@
|
||||
# 📄 项目管理文档模板库
|
||||
|
||||
> 本文档包含项目管理所需的所有核心模板,可直接复制使用。
|
||||
|
||||
---
|
||||
|
||||
## 一、项目状态文档 (project-state.md)
|
||||
|
||||
```markdown
|
||||
# [项目名称] 项目状态总览
|
||||
|
||||
> 最后更新:YYYY-MM-DD HH:MM
|
||||
> 项目阶段:启动/规划/执行/交付/复盘
|
||||
> 健康状态:🟢 正常 / 🟡 有风险 / 🔴 严重延期
|
||||
|
||||
---
|
||||
|
||||
## 📊 项目概览
|
||||
|
||||
| 项目 | 信息 |
|
||||
|:---|:---|
|
||||
| 项目名称 | [名称] |
|
||||
| 项目描述 | [一句话描述] |
|
||||
| 开始日期 | YYYY-MM-DD |
|
||||
| 目标日期 | YYYY-MM-DD |
|
||||
| 当前阶段 | P1/P2/P3/P4/P5 |
|
||||
| 负责人 | [姓名] |
|
||||
|
||||
---
|
||||
|
||||
## 📈 进度摘要
|
||||
|
||||
| 指标 | 数值 |
|
||||
|:---|:---|
|
||||
| 总任务数 | X |
|
||||
| 已完成 | Y (Z%) |
|
||||
| 进行中 | A |
|
||||
| 待开始 | B |
|
||||
| 阻塞中 | C |
|
||||
|
||||
### 进度条
|
||||
`[████████░░░░░░░░░░░░] 40%`
|
||||
|
||||
---
|
||||
|
||||
## 🎯 当前里程碑
|
||||
|
||||
| 里程碑 | 目标日期 | 状态 | 交付物 |
|
||||
|:---|:---|:---:|:---|
|
||||
| M1 需求冻结 | MM-DD | ✅ | 需求文档 |
|
||||
| M2 技术方案 | MM-DD | 🔄 | 架构文档 |
|
||||
| M3 开发完成 | MM-DD | ⏳ | 代码合并 |
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 当前风险/阻碍
|
||||
|
||||
| 问题 | 严重度 | 状态 | 处理方案 |
|
||||
|:---|:---:|:---:|:---|
|
||||
| [问题描述] | 🔴 | 处理中 | [解决方案] |
|
||||
|
||||
---
|
||||
|
||||
## 📝 最近更新
|
||||
|
||||
- [日期] [更新内容]
|
||||
- [日期] [更新内容]
|
||||
|
||||
---
|
||||
|
||||
## 🔗 相关文档
|
||||
|
||||
- [执行表](execution-table.md)
|
||||
- [对话记录](conversation-log.md)
|
||||
- [提示词库](prompts-library.md)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 二、执行表模板 (execution-table.md)
|
||||
|
||||
```markdown
|
||||
# [项目名称] 执行表
|
||||
|
||||
> 最后更新:YYYY-MM-DD HH:MM
|
||||
|
||||
---
|
||||
|
||||
## 状态说明
|
||||
|
||||
| 状态 | 含义 |
|
||||
|:---:|:---|
|
||||
| ✅ | Done - 已完成 |
|
||||
| 🔄 | In Progress - 进行中 |
|
||||
| ⏳ | Pending - 待开始 |
|
||||
| ❌ | Blocked - 阻塞中 |
|
||||
| 🚫 | Cancelled - 已取消 |
|
||||
|
||||
---
|
||||
|
||||
## P1 启动阶段
|
||||
|
||||
| 任务ID | 任务模块 | 具体行动 | 负责人 | 截止 | 状态 | 交付物 | 备注 |
|
||||
|:---|:---|:---|:---|:---|:---:|:---|:---|
|
||||
| T001 | 需求分析 | 确定 MVP 功能边界 | PM | T+3 | ✅ | 需求文档 | - |
|
||||
| T002 | 技术选型 | 确定技术栈 | Tech Lead | T+3 | ✅ | 架构文档 | - |
|
||||
|
||||
---
|
||||
|
||||
## P2 开发阶段
|
||||
|
||||
| 任务ID | 任务模块 | 具体行动 | 负责人 | 截止 | 状态 | 交付物 | 备注 |
|
||||
|:---|:---|:---|:---|:---|:---:|:---|:---|
|
||||
| T003 | 数据库 | 设计集合结构 | 后端 | T+5 | 🔄 | ER 图 | - |
|
||||
| T004 | 后端 | 实现用户 API | 后端 | T+10 | ⏳ | API 代码 | 依赖 T003 |
|
||||
| T005 | 前端 | 实现登录页面 | 前端 | T+10 | ⏳ | 页面代码 | 依赖 T004 |
|
||||
|
||||
---
|
||||
|
||||
## P3 联调阶段
|
||||
|
||||
| 任务ID | 任务模块 | 具体行动 | 负责人 | 截止 | 状态 | 交付物 | 备注 |
|
||||
|:---|:---|:---|:---|:---|:---:|:---|:---|
|
||||
|
||||
---
|
||||
|
||||
## P4 测试阶段
|
||||
|
||||
| 任务ID | 任务模块 | 具体行动 | 负责人 | 截止 | 状态 | 交付物 | 备注 |
|
||||
|:---|:---|:---|:---|:---|:---:|:---|:---|
|
||||
|
||||
---
|
||||
|
||||
## P5 上线阶段
|
||||
|
||||
| 任务ID | 任务模块 | 具体行动 | 负责人 | 截止 | 状态 | 交付物 | 备注 |
|
||||
|:---|:---|:---|:---|:---|:---:|:---|:---|
|
||||
|
||||
---
|
||||
|
||||
## 任务统计
|
||||
|
||||
总计: X 个任务
|
||||
✅ Done: Y 个 (Z%)
|
||||
🔄 In Progress: A 个
|
||||
⏳ Pending: B 个
|
||||
❌ Blocked: C 个
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 三、对话记录模板 (conversation-log.md)
|
||||
|
||||
```markdown
|
||||
# [项目名称] 对话记录
|
||||
|
||||
> 用于记录重要对话上下文,便于新对话继承
|
||||
|
||||
---
|
||||
|
||||
## [YYYY-MM-DD] 会话记录
|
||||
|
||||
### 📌 讨论要点
|
||||
- 讨论了 [主题1]
|
||||
- 确认了 [事项2]
|
||||
- 发现了 [问题3]
|
||||
|
||||
### ✅ 决策结论
|
||||
- 决定采用 [方案A] 而非 [方案B],原因是 [理由]
|
||||
- 确定 [功能X] 的优先级为 P1
|
||||
|
||||
### 📋 行动事项
|
||||
- [ ] @[负责人] 完成 [任务描述] by [截止日期]
|
||||
- [ ] @[负责人] 跟进 [事项描述]
|
||||
|
||||
### 🔄 任务状态变更
|
||||
| 任务 | 变更前 | 变更后 | 原因 |
|
||||
|:---|:---:|:---:|:---|
|
||||
| T003 | ⏳ | 🔄 | 开始执行 |
|
||||
| T001 | 🔄 | ✅ | 完成交付 |
|
||||
|
||||
### 📎 关键信息摘要
|
||||
[记录重要的技术决策、业务逻辑、配置信息等]
|
||||
|
||||
---
|
||||
|
||||
## 🔄 会话切换清单
|
||||
|
||||
当需要开始新对话时,复制以下内容:
|
||||
|
||||
## 项目上下文
|
||||
|
||||
**项目名称**: [名称]
|
||||
**当前阶段**: [阶段]
|
||||
**进度概览**: 已完成 X/Y 任务
|
||||
|
||||
### 进行中任务
|
||||
- T003: [任务描述] - 进度 50%
|
||||
- T004: [任务描述] - 待前置完成
|
||||
|
||||
### 未解决问题
|
||||
- [问题1]: [状态]
|
||||
|
||||
### 下一步计划
|
||||
- [计划1]
|
||||
- [计划2]
|
||||
|
||||
### 关键背景
|
||||
- [重要决策或背景信息]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 四、甘特图模板
|
||||
|
||||
```mermaid
|
||||
gantt
|
||||
title [项目名称] 开发进度
|
||||
dateFormat YYYY-MM-DD
|
||||
|
||||
section P1 启动
|
||||
需求分析 :done, a1, 2024-01-01, 3d
|
||||
技术选型 :done, a2, after a1, 2d
|
||||
|
||||
section P2 开发
|
||||
数据库设计 :active, b1, after a2, 3d
|
||||
后端开发 : b2, after b1, 10d
|
||||
前端开发 : b3, after b1, 10d
|
||||
|
||||
section P3 联调
|
||||
前后端联调 : c1, after b2, 3d
|
||||
|
||||
section P4 测试
|
||||
功能测试 : d1, after c1, 3d
|
||||
Bug 修复 : d2, after d1, 2d
|
||||
|
||||
section P5 上线
|
||||
部署发布 : e1, after d2, 1d
|
||||
用户手册 : e2, after e1, 2d
|
||||
里程碑: 正式上线 :milestone, m1, after e2, 0d
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 五、风险矩阵模板
|
||||
|
||||
| 风险ID | 风险描述 | 可能性 | 影响 | 等级 | 触发条件 | 应对策略 | 负责人 | 状态 |
|
||||
|:---|:---|:---:|:---:|:---:|:---|:---|:---|:---:|
|
||||
| R001 | 需求频繁变更 | 高 | 中 | 🟡 | 客户提出新需求 | 冻结版本,变更走审批 | PM | 监控中 |
|
||||
| R002 | 技术方案不可行 | 中 | 高 | 🟡 | POC 验证失败 | 提前预研,准备 Plan B | Tech Lead | 已缓解 |
|
||||
| R003 | 核心人员离职 | 低 | 高 | 🟢 | 人员变动通知 | 文档沉淀 + 备份人员 | PM | 监控中 |
|
||||
|
||||
### 风险等级说明
|
||||
|
||||
| 等级 | 定义 | 处理方式 |
|
||||
|:---:|:---|:---|
|
||||
| 🔴 高危 | 可能性高 + 影响高 | 立即处理,每日跟踪 |
|
||||
| 🟡 中等 | 可能性/影响中高 | 密切关注,每周检查 |
|
||||
| 🟢 低风险 | 可能性/影响低 | 记录观察,定期评估 |
|
||||
|
||||
---
|
||||
|
||||
## 六、复盘报告模板
|
||||
|
||||
```markdown
|
||||
# [项目名称] 项目复盘报告
|
||||
|
||||
> 复盘时间:YYYY-MM-DD
|
||||
> 复盘人:[姓名]
|
||||
|
||||
---
|
||||
|
||||
## 一、项目概述
|
||||
|
||||
| 项目 | 信息 |
|
||||
|:---|:---|
|
||||
| 项目名称 | [名称] |
|
||||
| 项目周期 | YYYY-MM-DD ~ YYYY-MM-DD |
|
||||
| 最终状态 | ✅ 成功 / ⚠️ 部分完成 / ❌ 失败 |
|
||||
|
||||
---
|
||||
|
||||
## 二、目标与结果对比
|
||||
|
||||
| 目标项 | 预期值 | 实际值 | 完成率 |
|
||||
|:---|:---|:---|:---:|
|
||||
| 功能上线 | X 个 | Y 个 | Z% |
|
||||
| 开发周期 | A 天 | B 天 | C% |
|
||||
|
||||
---
|
||||
|
||||
## 三、经验总结
|
||||
|
||||
### 做得好的地方 👍
|
||||
1. [亮点1]
|
||||
2. [亮点2]
|
||||
|
||||
### 做得不好的地方 👎
|
||||
1. [问题1]
|
||||
2. [问题2]
|
||||
|
||||
---
|
||||
|
||||
## 四、改进行动
|
||||
|
||||
| 序号 | 改进点 | 具体行动 | 负责人 | 截止时间 |
|
||||
|:---:|:---|:---|:---|:---|
|
||||
| 1 | [改进点1] | [具体行动] | [负责人] | [时间] |
|
||||
|
||||
---
|
||||
|
||||
> **复盘不是为了追责,而是为了下次做得更好!**
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 七、站会纪要模板
|
||||
|
||||
```markdown
|
||||
# 站会纪要 - YYYY-MM-DD
|
||||
|
||||
> 参与人员:[人员列表]
|
||||
> 时长:[X] 分钟
|
||||
|
||||
---
|
||||
|
||||
## 🟢 昨日完成
|
||||
|
||||
| 成员 | 完成内容 | 对应任务 |
|
||||
|:---|:---|:---|
|
||||
| [姓名] | [完成内容] | T00X |
|
||||
|
||||
---
|
||||
|
||||
## 🔵 今日计划
|
||||
|
||||
| 成员 | 计划内容 | 对应任务 |
|
||||
|:---|:---|:---|
|
||||
| [姓名] | [计划内容] | T00X |
|
||||
|
||||
---
|
||||
|
||||
## 🔴 阻碍事项
|
||||
|
||||
| 问题描述 | 影响任务 | 需要支持 |
|
||||
|:---|:---|:---|
|
||||
| [问题] | T00X | [支持内容] |
|
||||
|
||||
---
|
||||
|
||||
## 📊 进度快照
|
||||
|
||||
总任务: X 个
|
||||
✅ 已完成: Y 个 (Z%)
|
||||
🔄 进行中: A 个
|
||||
⏳ 待开始: B 个
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
> **提示**: 所有模板都可根据实际项目需求进行调整,核心是保持信息完整、可追踪。
|
||||
327
.cursor/skills/dev-template-project-manager/workflow.md
Normal file
327
.cursor/skills/dev-template-project-manager/workflow.md
Normal file
@@ -0,0 +1,327 @@
|
||||
# 📋 项目管理工作流详解
|
||||
|
||||
> 本文档详细说明项目管理的完整工作流程,包括多智能体协作机制和上下文管理策略。
|
||||
|
||||
---
|
||||
|
||||
## 一、项目生命周期
|
||||
|
||||
```mermaid
|
||||
graph LR
|
||||
subgraph 启动[P1 启动]
|
||||
A1[需求收集] --> A2[需求分析]
|
||||
A2 --> A3[可行性评估]
|
||||
end
|
||||
|
||||
subgraph 规划[P2 规划]
|
||||
B1[架构设计] --> B2[任务拆解]
|
||||
B2 --> B3[排期制定]
|
||||
end
|
||||
|
||||
subgraph 执行[P3 执行]
|
||||
C1[开发实现] --> C2[进度追踪]
|
||||
C2 --> C3[风险控制]
|
||||
C3 --> C1
|
||||
end
|
||||
|
||||
subgraph 交付[P4 交付]
|
||||
D1[测试验收] --> D2[部署上线]
|
||||
D2 --> D3[用户手册]
|
||||
end
|
||||
|
||||
subgraph 复盘[P5 复盘]
|
||||
E1[数据收集] --> E2[问题分析]
|
||||
E2 --> E3[经验沉淀]
|
||||
end
|
||||
|
||||
启动 --> 规划 --> 执行 --> 交付 --> 复盘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 二、多智能体协作架构
|
||||
|
||||
基于 DocAgent 模式,本系统采用多智能体协作:
|
||||
|
||||
```mermaid
|
||||
graph TB
|
||||
subgraph Orchestrator[🎯 编排器 - 项目管理专家]
|
||||
O[任务分发与协调]
|
||||
end
|
||||
|
||||
subgraph Agents[🤖 智能体矩阵]
|
||||
A1[📖 Reader<br/>需求理解]
|
||||
A2[🔍 Searcher<br/>上下文检索]
|
||||
A3[✍️ Writer<br/>内容生成]
|
||||
A4[✅ Verifier<br/>质量校验]
|
||||
A5[📊 Tracker<br/>进度追踪]
|
||||
end
|
||||
|
||||
subgraph Memory[💾 记忆层]
|
||||
M1[project-state.md]
|
||||
M2[execution-table.md]
|
||||
M3[conversation-log.md]
|
||||
M4[prompts-library.md]
|
||||
end
|
||||
|
||||
O --> A1
|
||||
A1 --> A2
|
||||
A2 --> A3
|
||||
A3 --> A4
|
||||
A4 --> A5
|
||||
A5 --> Memory
|
||||
|
||||
A4 -->|不通过| A3
|
||||
Memory -->|上下文| A2
|
||||
```
|
||||
|
||||
### 智能体职责
|
||||
|
||||
| 智能体 | 角色 | 职责 | 触发场景 |
|
||||
|:---:|:---|:---|:---|
|
||||
| 📖 Reader | 需求分析师 | 理解用户输入,提取关键信息 | 新需求/变更请求 |
|
||||
| 🔍 Searcher | 上下文检索 | 检索历史对话和项目状态 | 所有交互 |
|
||||
| ✍️ Writer | 内容生成 | 生成文档、代码、报告 | 展开目录/生成内容 |
|
||||
| ✅ Verifier | 质量校验 | 校验一致性、完整性 | 重要变更后 |
|
||||
| 📊 Tracker | 进度追踪 | 更新状态、识别风险 | 进度变更 |
|
||||
|
||||
---
|
||||
|
||||
## 三、上下文管理策略
|
||||
|
||||
### 3.1 上下文窗口优化
|
||||
|
||||
由于 LLM 上下文窗口有限,采用以下策略:
|
||||
|
||||
```yaml
|
||||
分层存储:
|
||||
即时层: 当前对话内容(保留完整)
|
||||
工作层: project-state.md 摘要(每次加载)
|
||||
归档层: conversation-log.md 历史(按需检索)
|
||||
|
||||
摘要策略:
|
||||
每次对话结束: 提取关键信息写入 conversation-log.md
|
||||
每个里程碑: 更新 project-state.md 总览
|
||||
每周: 归档过期任务,压缩执行表
|
||||
|
||||
检索策略:
|
||||
优先: project-state.md(当前状态)
|
||||
次之: 最近 5 次对话记录
|
||||
按需: 历史对话全文检索
|
||||
```
|
||||
|
||||
### 3.2 会话切换无损转移
|
||||
|
||||
当需要开始新对话时:
|
||||
|
||||
```markdown
|
||||
## 会话转移清单
|
||||
|
||||
1. 当前项目状态摘要
|
||||
2. 进行中的任务列表
|
||||
3. 未解决的阻碍/风险
|
||||
4. 下一步待办事项
|
||||
5. 关键决策和背景
|
||||
|
||||
---
|
||||
|
||||
复制以上内容到新对话,即可无缝继续工作。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 四、任务拆解标准
|
||||
|
||||
### 4.1 拆解原则
|
||||
|
||||
```yaml
|
||||
粒度标准:
|
||||
- 每个任务 ≤ 2 天工时
|
||||
- 每个任务有明确交付物
|
||||
- 每个任务可独立验收
|
||||
|
||||
依赖管理:
|
||||
- 明确前置依赖
|
||||
- 避免循环依赖
|
||||
- 并行任务分组
|
||||
|
||||
优先级定义:
|
||||
P0: 阻塞性任务,必须最先完成
|
||||
P1: 核心功能,影响上线
|
||||
P2: 重要功能,影响体验
|
||||
P3: 锦上添花,时间允许再做
|
||||
```
|
||||
|
||||
### 4.2 用户故事模板
|
||||
|
||||
```markdown
|
||||
**US-[编号]: [功能名称]**
|
||||
|
||||
- **As a** [用户角色]
|
||||
- **I want** [具体功能]
|
||||
- **So that** [业务价值]
|
||||
|
||||
**验收标准 (AC)**:
|
||||
- [ ] AC1: [具体可验证的条件]
|
||||
- [ ] AC2: [具体可验证的条件]
|
||||
|
||||
**技术备注**:
|
||||
- 依赖: [前置任务]
|
||||
- 估时: [工时估算]
|
||||
- 负责: [开发人员]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 五、进度追踪机制
|
||||
|
||||
### 5.1 每日站会模式
|
||||
|
||||
```markdown
|
||||
## 站会纪要 - [日期]
|
||||
|
||||
### 🟢 昨日完成
|
||||
- [任务1]: 完成情况
|
||||
- [任务2]: 完成情况
|
||||
|
||||
### 🔵 今日计划
|
||||
- [任务3]: 计划内容
|
||||
- [任务4]: 计划内容
|
||||
|
||||
### 🔴 阻碍事项
|
||||
- [阻碍1]: 问题描述 + 需要的支持
|
||||
|
||||
### 📊 进度概览
|
||||
- 总任务: X 个
|
||||
- 已完成: Y 个 (Z%)
|
||||
- 进行中: A 个
|
||||
- 待开始: B 个
|
||||
```
|
||||
|
||||
### 5.2 状态流转
|
||||
|
||||
```mermaid
|
||||
stateDiagram-v2
|
||||
[*] --> Pending: 任务创建
|
||||
Pending --> InProgress: 开始执行
|
||||
InProgress --> Done: 完成
|
||||
InProgress --> Blocked: 遇到阻碍
|
||||
Blocked --> InProgress: 阻碍解决
|
||||
Blocked --> Cancelled: 需求取消
|
||||
Done --> [*]
|
||||
Cancelled --> [*]
|
||||
```
|
||||
|
||||
### 5.3 风险识别矩阵
|
||||
|
||||
| 风险等级 | 可能性 | 影响 | 处理方式 |
|
||||
|:---:|:---:|:---:|:---|
|
||||
| 🔴 高危 | 高 | 高 | 立即处理,上报并制定应急方案 |
|
||||
| 🟡 中等 | 中 | 高/中高 | 密切关注,准备预案 |
|
||||
| 🟢 低风险 | 低/中 | 低/中 | 记录观察,定期检查 |
|
||||
|
||||
---
|
||||
|
||||
## 六、文档联动规则
|
||||
|
||||
### 6.1 变更传播链
|
||||
|
||||
```yaml
|
||||
需求变更:
|
||||
触发更新:
|
||||
- 架构文档 (如影响技术方案)
|
||||
- 接口文档 (如影响 API 设计)
|
||||
- 执行表 (新增/调整任务)
|
||||
- 排期 (重新评估时间)
|
||||
|
||||
接口变更:
|
||||
触发更新:
|
||||
- 前端代码 (调用方式)
|
||||
- 后端代码 (实现方式)
|
||||
- API 文档 (接口定义)
|
||||
- 测试用例 (验证逻辑)
|
||||
|
||||
数据库变更:
|
||||
触发更新:
|
||||
- ER 图
|
||||
- 后端 Model
|
||||
- 接口文档 (数据结构)
|
||||
```
|
||||
|
||||
### 6.2 一致性检查
|
||||
|
||||
每次重大变更后,执行一致性检查:
|
||||
|
||||
```markdown
|
||||
## 一致性检查清单
|
||||
|
||||
- [ ] 需求文档与执行表任务一致
|
||||
- [ ] 架构设计与技术选型一致
|
||||
- [ ] 接口定义与前后端实现一致
|
||||
- [ ] 数据库设计与 Model 定义一致
|
||||
- [ ] 部署配置与环境变量一致
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 七、复盘流程
|
||||
|
||||
### 7.1 数据收集
|
||||
|
||||
```yaml
|
||||
收集指标:
|
||||
进度:
|
||||
- 计划工时 vs 实际工时
|
||||
- 计划周期 vs 实际周期
|
||||
- 任务完成率
|
||||
|
||||
质量:
|
||||
- Bug 数量及分布
|
||||
- 返工次数
|
||||
- 代码审查通过率
|
||||
|
||||
过程:
|
||||
- 需求变更次数
|
||||
- 阻碍事项数量
|
||||
- 风险应对效果
|
||||
```
|
||||
|
||||
### 7.2 复盘模板
|
||||
|
||||
详见 [templates.md](templates.md) 中的复盘报告模板。
|
||||
|
||||
---
|
||||
|
||||
## 八、最佳实践
|
||||
|
||||
### 8.1 高效使用技巧
|
||||
|
||||
```yaml
|
||||
每日习惯:
|
||||
- 早: 快速查看进度概览
|
||||
- 中: 遇到问题及时记录
|
||||
- 晚: 更新当日进度
|
||||
|
||||
每周习惯:
|
||||
- 周一: 确认本周目标
|
||||
- 周五: 检查进度偏差
|
||||
|
||||
每个里程碑:
|
||||
- 更新项目状态总览
|
||||
- 压缩归档已完成任务
|
||||
- 调整后续计划
|
||||
```
|
||||
|
||||
### 8.2 常见问题处理
|
||||
|
||||
| 问题 | 解决方案 |
|
||||
|:---|:---|
|
||||
| 任务拆分太粗 | 按 2 天原则继续细分 |
|
||||
| 进度不透明 | 强制每日更新执行表 |
|
||||
| 风险后知后觉 | 每个任务标记潜在风险 |
|
||||
| 复盘流于形式 | 必须有具体改进行动 |
|
||||
| 上下文丢失 | 及时记录到 conversation-log.md |
|
||||
|
||||
---
|
||||
|
||||
> **记住**: 项目管理的核心是让事情可见、可追踪、可预测。AI 是你的助手,但决策权在你手中!
|
||||
Reference in New Issue
Block a user