项目管理统一规范库
本仓库用于沉淀可被多个项目直接复用的项目管理规范,覆盖需求管理、backlog 管理、实施推进、交接续做、验证验收与归档收口。
这里的目标不是保存某个单一项目的内部做法,而是提供一套可以长期复用、直接引用、稳定扩展的组织级工作方法。
适用范围
适用:
- 需要在仓库内长期维护 feature backlog 的项目
- 需要让 AI Agent、工程师、测试和项目负责人共用同一套文档真源的项目
- 需要明确区分“需求真源、实施真源、验收真源、决策记录、交接文档”的项目
不适用:
- 只有零散待办、不维护 feature 生命周期的小型脚本仓库
- 完全依赖外部工单系统、仓库内不维护项目文档真源的团队
- 只想保留简短任务列表、不要求状态迁移与验收门槛的场景
推荐采用顺序
- 先读
standards/01-术语与状态约定.md,统一术语、状态和对象边界。 - 再读
standards/02-需求与Backlog管理规范.md,建立目录树、编号规则和需求真源。 - 然后读
standards/03-实施与交接管理规范.md,确定执行计划、会话续做和范围控制规则。 - 最后读
standards/04-验证与验收管理规范.md,落实验收面板、验证证据和迁移门槛。 - 规范读完后,再从
templates/复制模板,用samples/README.md中的正式样例文档对照写法。
文档导航
规范正文
standards/01-术语与状态约定.md- 定义组织级术语、文档角色、状态枚举和迁移语义
standards/02-需求与Backlog管理规范.md- 定义目录结构、需求真源、backlog 索引和编号管理
standards/03-实施与交接管理规范.md- 定义执行计划、推进节奏、交接文档和收尾边界
standards/04-验证与验收管理规范.md- 定义验收清单、验证证据、关闭条件和归档迁移
模板与样例
templates/- 通用模板,面向未来项目直接复制使用
samples/README.md- 通用样例文档索引,包含 feature 生命周期、planning tree 和完整 feature 文档组
案例目录
jqkai/README.mdjqkai案例说明与历史沉淀入口
最小目录契约
未来项目应采用如下固定结构:
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 编号。