GitPM：面向AI时代的Git原生项目管理范式

GitPM 是一个将项目管理数据（路线图、PRD、史诗、问题）以结构化文件形式存储在代码仓库中的工具，支持双向 GitHub 同步和本地 UI，专为 AI 智能体工作流设计。

传统的项目管理工具（如 Jira、Asana、Monday.com）虽然功能强大，但存在根本性缺陷：

• 数据孤岛：项目数据与代码分离，开发人员需要在多个系统间切换
• 版本不一致：需求文档的修改历史与代码变更历史不在同一时间线上
• AI不可访问：外部系统的数据格式对 AI 智能体不透明，难以实现深度集成
• 供应商锁定：项目数据存储在专有平台，迁移成本高昂

随着 AI 编程助手和智能体的兴起，对项目管理提出了新的要求：

• 可遍历性：AI 需要能够像遍历代码文件一样遍历项目上下文
• 可版本化：项目变更需要与代码变更在同一版本控制体系下管理
• 可协作：人类开发者与 AI 智能体需要共享同一套项目视图

GitPM 的核心理念很简单：如果代码应该版本化，那么项目管理数据也应该版本化；如果代码应该存储在 Git 中，那么项目数据也应该存储在 Git 中。

GitPM 将项目管理实体（路线图、PRD、史诗、问题）表示为仓库中的结构化文件，通常采用 Markdown 或 YAML 格式。这种设计带来多重优势：

• 版本控制：天然继承 Git 的版本管理能力，每次变更都有完整历史
• 代码审查：项目变更可以通过 Pull Request 进行审查和讨论
• 分支管理：不同功能分支可以拥有不同的项目视图
• 文本友好：纯文本格式便于 diff、搜索和自动化处理

通过将项目数据纳入代码仓库，GitPM 创建了一个统一的文件树，其中：

project-root/
├── src/                    # 源代码
├── docs/                   # 文档
├── .gitpm/                 # GitPM 项目数据
│   ├── roadmap.md          # 产品路线图
│   ├── prd/                # 需求文档目录
│   │   ├── auth-system.md
│   │   └── payment-flow.md
│   ├── epics/              # 史诗任务目录
│   │   ├── epic-001-user-auth.yml
│   │   └── epic-002-checkout.yml
│   └── issues/             # 问题追踪目录
│       ├── issue-042.yml
│       └── issue-043.yml
└── README.md

这种结构让 AI 智能体可以通过标准的文件系统 API 访问完整的项目上下文。

GitPM 支持与 GitHub 的双向数据同步：

• GitHub → GitPM：将 GitHub Issues、Projects、Milestones 同步到本地文件
• GitPM → GitHub：将本地文件变更推送回 GitHub

这种同步是增量和双向的，确保两个系统的数据保持一致。

虽然数据以文件形式存储，GitPM 仍提供友好的本地 Web UI 用于：

• 可视化项目看板
• 编辑问题详情
• 管理史诗和里程碑
• 查看路线图时间线

UI 是可选的，纯命令行用户可以直接编辑文件。