| 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 完整类型说明。
状态标识
| 状态 | 标识 | 说明 |
|---|
| 迭代中 | 🟢 | 活跃进行中 |
| 暂停中 | 🟡 | 暂时搁置，可能恢复 |
| 已结束 | 🔴 | 已归档/废弃/完成 |
文件结构
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，删除后不重新编号
- 变更日志: 所有操作必须记录到变更日志
- 日期格式: YYYY-MM-DD
- 路径规范: 相对路径
./项目/ 或 -（无实体路径）
- 版本号: 语义化版本 v1.0, v1.1, v2.0
详见 references/rules.md 完整规则说明。
文件结构
projects/
├── PROJECTS.md # 项目总览、类型图例、状态图例
└── CHANGELOG.md # 变更日志（独立文件）
PROJECTS.md 格式
# 📊 项目看板 (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
更新说明: 新增最后更新人字段，变更日志分离到独立文件
