Project Management Docs main README.md

项目管理统一规范库

本仓库用于沉淀可被多个项目直接复用的项目管理规范,覆盖需求管理、backlog 管理、实施推进、交接续做、验证验收与归档收口。

这里的目标不是保存某个单一项目的内部做法,而是提供一套可以长期复用、直接引用、稳定扩展的组织级工作方法。

适用范围

适用:

  • 需要在仓库内长期维护 feature backlog 的项目
  • 需要让 AI Agent、工程师、测试和项目负责人共用同一套文档真源的项目
  • 需要明确区分“需求真源、实施真源、验收真源、决策记录、交接文档”的项目

不适用:

  • 只有零散待办、不维护 feature 生命周期的小型脚本仓库
  • 完全依赖外部工单系统、仓库内不维护项目文档真源的团队
  • 只想保留简短任务列表、不要求状态迁移与验收门槛的场景

推荐采用顺序

  1. 先读 standards/01-术语与状态约定.md,统一术语、状态和对象边界。
  2. 再读 standards/02-需求与Backlog管理规范.md,建立目录树、编号规则和需求真源。
  3. 然后读 standards/03-实施与交接管理规范.md,确定执行计划、会话续做和范围控制规则。
  4. 最后读 standards/04-验证与验收管理规范.md,落实验收面板、验证证据和迁移门槛。
  5. 规范读完后,再从 templates/ 复制模板,用 samples/README.md 中的正式样例文档对照写法。

文档导航

规范正文

模板与样例

  • templates/
    • 通用模板,面向未来项目直接复制使用
  • samples/README.md
    • 通用样例文档索引,包含 feature 生命周期、planning tree 和完整 feature 文档组

案例目录

最小目录契约

未来项目应采用如下固定结构:

planning/
  README.md
  glossary.md
  notes/
    roadmap.md
  backlog/
    README.md
    active/
      README.md
      feat-{seq}-{slug}/
        PRD.md
        execution-plan.md
        acceptance-checklist.md
        decision-<topic>.md
        handoff-<topic>.md
    accepted/
      README.md
      feat-{seq}-{slug}/
        PRD.md
        execution-plan.md
        acceptance-checklist.md
        decision-<topic>.md
        handoff-<topic>.md
    archive/
      README.md
      feat-{seq}-{slug}/
        PRD.md

核心原则

  • PRD.md 是唯一需求真源。
  • execution-plan.md 是唯一实施拆解与推进真源。
  • acceptance-checklist.md 是唯一验收面板,不承担任务分解职责。
  • decision-<topic>.md 只记录局部决策、补充边界、被否决方案和历史判断。
  • handoff-<topic>.md 只承接窄范围续做与交接,不扩展产品边界。
  • 各级 README.md 只做索引、摘要和口径同步,不承担真源职责。

使用建议

  • 新项目第一次接入时,优先按规范建立目录树和模板,不要边做边补命名。
  • 真实项目允许出现“实现先于文档”的情况,但必须通过 Implemented 状态显式表达,而不是让索引失真。
  • 局部纠偏优先写成 decision-<topic>.md,只有真正拥有独立生命周期的主题才新开 backlog 编号。