Project Management

---
name: project-management
description: 项目看板管理，支持多类型事务（代码、学习、工作、生活等）。Use when user needs to: (1) 注册新项目到看板并指定创建人，(2) 变更项目状态或版本，(3) 管理项目分类，(4) 查看项目总览、变更历史或按创建人/更新人筛选。
---

# 项目看板管理

管理 workspace 项目看板 (`projects/PROJECTS.md`)，支持多类型事务管理。

---

## 核心能力

### 项目注册
- 新增项目到看板，指定类型、状态、版本、创建人
- 自动分配序号，记录变更日志
- 支持有路径的代码项目或无路径的事务项目
- **人员追踪**: 创建人 + 最后更新人

### 状态管理
- 变更项目状态（迭代中/暂停中/已结束）
- 记录状态变更原因、时间和更新人

### 版本发布
- 更新项目版本号
- 记录版本变更说明和更新人

### 类型管理
- 查看内置项目类型
- 创建自定义项目类型

### 人员管理
- **创建人**: 项目创建者（不可变）
- **最后更新人**: 最后一次修改项目的人（自动更新）
- 默认值：当前 agent 或用户
- 支持按创建人/更新人筛选项目

### 变更日志分离
- **PROJECTS.md**: 项目总览、类型图例、状态图例、快速链接
- **CHANGELOG.md**: 完整变更历史记录（独立文件）

---

## 内置项目类型

| 类型 | 标识 | 说明 |
|------|------|------|
| 代码项目 | 💻 | 软件开发、应用、工具 |
| 学习计划 | 📚 | 课程、考证、技能学习 |
| 个人事务 | 🏠 | 生活事项、家庭计划 |
| 工作目标 | 💼 | 工作任务、OKR、绩效 |
| 创意项目 | 🎨 | 写作、设计、艺术创作 |
| 健康管理 | 💪 | 健身、饮食、医疗 |
| 财务规划 | 💰 | 投资、理财、预算 |
| 旅行计划 | ✈️ | 出游、行程规划 |

详见 [references/types.md](references/types.md) 完整类型说明。

---

## 状态标识

| 状态 | 标识 | 说明 |
|------|------|------|
| 迭代中 | 🟢 | 活跃进行中 |
| 暂停中 | 🟡 | 暂时搁置，可能恢复 |
| 已结束 | 🔴 | 已归档/废弃/完成 |

---

## 文件结构

```
workspace/
└── projects/
    └── PROJECTS.md    # 项目看板主文件
```

---

## 使用示例

### 新增项目
```
用户：我新建了一个客服系统项目，放在 ./cs-training/
→ PROJECTS.md: | 1 | 客服话术对练系统 | 💻 代码项目 | yoyo | yoyo | 🟢 迭代中 | `./cs-training/` | v0.1 | 2026-02-20 | 新项目 |
→ CHANGELOG.md: | 2026-02-20 | 新增项目 | 客服话术对练系统 | yoyo | 初始化 |

用户：我要准备 PMP 考试
→ PROJECTS.md: | 2 | PMP 备考 | 📚 学习计划 | yoyo | yoyo | 🟢 迭代中 | - | v1.0 | 2026-02-22 | 目标 3 个月通过 |
→ CHANGELOG.md: | 2026-02-22 | 新增项目 | PMP 备考 | yoyo | 学习计划启动 |
```

### 更新项目（自动更新最后更新人）
```
用户：客服话术系统发布 v1.4 了
→ PROJECTS.md: 版本 v1.3→v1.4, 最后改动 2026-02-20→2026-02-22, 最后更新人：yoyo
→ CHANGELOG.md: | 2026-02-22 | 版本发布 | 客服话术对练系统 | yoyo | 发布 v1.4，新增语音功能 |
```

### 按人筛选
```
用户：看看我创建了哪些项目
→ list_projects(creator="yoyo")

用户：看看小明负责的项目
→ list_projects(creator="小明")

用户：我最近改了哪些项目
→ list_projects(modified_by="kyo")
```

### 发布版本
```
用户：客服话术系统发布 v1.4 了
→ 更新版本列 v1.3 → v1.4，更新最后改动时间，记录变更日志
```

### 状态变更
```
用户：Gemini Agent 项目先暂停
→ 更新状态列 🟢 迭代中 → 🟡 暂停中，记录原因
```

### 新增类型
```
用户：我想管理养猫相关的事情，加个宠物类型
→ 在类型图例添加：| 宠物养护 | 🐱 | 养宠相关事项 |
```

---

## 操作规则

1. **序号连续**: 新序号 = 当前最大序号 + 1，删除后不重新编号
2. **变更日志**: 所有操作必须记录到变更日志
3. **日期格式**: YYYY-MM-DD
4. **路径规范**: 相对路径 `./项目/` 或 `-`（无实体路径）
5. **版本号**: 语义化版本 v1.0, v1.1, v2.0

详见 [references/rules.md](references/rules.md) 完整规则说明。

---

## 文件结构

```
projects/
├── PROJECTS.md       # 项目总览、类型图例、状态图例
└── CHANGELOG.md      # 变更日志（独立文件）
```

## PROJECTS.md 格式

```markdown
# 📊 项目看板 (Project Dashboard)

> **最后更新**: YYYY-MM-DD  
> **维护人**: [你的名字]

---

## 📋 项目总览

| 序号 | 项目名称 | 类型 | 创建人 | 最后更新人 | 状态 | 位置 | 最新版本 | 最后改动 | 备注 |
|------|---------|------|--------|-----------|------|------|---------|---------|------|
| 1 | 项目名称 | 💻 代码项目 | yoyo | kyo | 🟢 迭代中 | `./目录/` | v1.0 | YYYY-MM-DD | 备注 |

---

## 📊 类型图例
（类型列表）

## 📊 状态图例
（状态列表）

## 📝 变更日志
| 日期 | 操作 | 项目 | 说明 |

## 🔗 快速链接
- [项目名称](./项目目录/README.md)

---

## CHANGELOG.md 格式

```markdown
# 📝 项目变更日志 (Project Changelog)

> 独立记录所有项目变更历史

---

## 变更历史

| 日期 | 操作 | 项目 | 更新人 | 说明 |
|------|------|------|--------|------|
| YYYY-MM-DD | 操作类型 | 项目名称 | 更新人 | 详细说明 |

---

## 操作类型

- 新增项目
- 状态变更
- 版本发布
- 移除项目
- 创建看板
- 新增类型
```

---

## 维护责任

- **维护人**: AI 助手
- **更新频率**: 实时（项目变更时立即更新）

---

**版本**: v1.2  
**创建日期**: 2026-02-20  
**最后更新**: 2026-02-22  
**更新说明**: 新增最后更新人字段，变更日志分离到独立文件