project_management

Skill - 项目管理

本技能提供了一套通用的项目管理规范和工作流程，旨在确保项目高效、规范地进行，涵盖从项目初始化、需求管理、开发、测试到部署的全过程。

关键词: project management, 任务, 需求, 文档, TODO, backlog, workshops

1.1. 何时使用本技能

如果项目章程（AGENTS.md）或用户指令中要求，则应随时使用本 Skill。具体情形包括但不限于：

• 当用户在项目中进行需求、任务或缺陷管理时；
• 当需要进行代码开发、测试、分支管理和部署操作时；
• 当用户要求整理项目结构或创建新文档时； 等等。

1.2. 如何覆盖本 Skill 的缺省描述

本 Skill 的描述可以根据具体项目需求进行调整和覆盖：

• 如果在项目章程（AGENTS.md）中提及如 覆盖 project_management 的 ... 部分，则应在对应部分，优先采用项目特定的描述和规范。
• 若用户要求覆盖本 Skill 的描述，请确认用户意图，并按 覆盖 project_management 的 ... 部分 的明确描述写入项目章程。

2. 目录结构与特殊目录使用方式

为了确保项目的一致性和可维护性，推荐在仓库中采用以下标准化的 Monorepo 目录结构。

2.1. 目录结构

/                              # 仓库根目录
├── .git/
├── workshops/                   # 所有仓库包含的开发项目所在地
│   └── <project-name>/            # 单个项目目录
│       ├── AGENTS.md              # 单个项目的章程
│       ├── TODO.md                # 单个项目特定的任务列表
│       ├── docs/                  # 单个项目特定的文档
│       │   ├── requirements/        # 单个项目的需求文档列表
│       │   └── specs/               # 单个项目的整体设计文档
│       └── src/                   # 项目源代码
├── skills/                      # 仓库特定 Skill
│   └── ...
├── local-inbox/                 # 「收件箱」目录，用于用户提供文件
├── AGENTS.md                    # 仓库的章程
├── GEMINI.md                    # AGENTS.md 的符号链接（别名）
├── README.md                    # AGENTS.md 的符号链接（别名）
├── TODO.md                      # 全局的、跨项目的任务列表
├── .gitignore
└── ...

部分仓库可能只包含一个项目。此时目录结构可能简化，由 AGENTS.md 确定。

2.2. 「收件箱」使用方法

如果用户需要传递非文本文件、图片、多个文件给助手，用户会将文件放置在一个约定的「收件箱」目录（默认 local-inbox/）。

助手需要定期检查此目录是否有新文件，根据文件内容和用户指令和文档对文件进行重命名，并移动到合适的归档位置（例如 docs/specs/ 或 docs/requirements/）。

3. 需求与任务管理

3.1. 文档管理

在创建任何需求、设计或其他类型的文档时，必须遵循以下规范：

1. 确定位置: 根据本 Skill 和项目章程文件确定目标文档位置；
2. 获取时间戳: 必须先运行 date +'%Y-%m-%d-%H-%M' 命令获取当前时间；
3. 命名文件: 文件名必须是 YYYY-MM-DD-HH-mm-{文档名称}.md 的格式，方便按时间排序和检索；
4. 更新 TODO: 在创建文档后，应在相应的 TODO.md 任务中添加对该文档的引用链接。

在可能时，文档应链接到其「下属」文档，以形成清晰的文档层级结构。例如，主规格文档应链接到各个功能规格文档，需求文档应链接到相关的设计文档，TODO 项目应链接到对应的需求或缺陷文档。

你可以从其他 Skill 获取文档模板，以确保一致性和质量。