项目看板管理
管理 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
更新说明: 新增最后更新人字段,变更日志分离到独立文件
Scan to join WeChat group