edit | blame | history | raw

project-doc 目录导读

创建人员:Codex
文件职责:说明 common/project-doc 目录下项目规范、项目创建指南和项目管理模板的用途。
管理规范/模板:../../全局规范.md;../../体系说明.md;项目规范.md。
引用文件:项目规范.md;项目环境创建指南.md;本目录下全部 *模版.md 文件。
记录方式:目录入口文档;新增或删除本目录正式文档时同步更新。

1. 目录定位

本目录保存通用项目规范和项目体系模板。

项目体系负责管理“一个项目本身”,包括项目目标、项目配置清单、启用体系、角色权限、目录结构、项目事项计划、项目执行日志、项目事项审计和项目级问题闭环。

项目体系不是需求体系、开发体系、实验体系的替代品。它负责把这些体系装进项目,并维护项目层面的治理入口。

2. 文件清单

文件 类型 作用
项目规范.md 全局项目规范 说明项目体系的定位、核心流程、文档职责、业务子项目目录和 Git 管理边界
项目环境创建指南.md 创建指南 指导项目管理员创建新项目和初始化项目体系
项目总览范本.md 模板 创建项目根目录 项目总览.md,记录项目稳定基础信息、目标、周期、背景和关键入口
项目规范模版.md 模板 创建项目根目录本地 项目规范.md
项目配置清单模版.md 模板 创建项目根目录 项目配置清单.md,记录启用体系、AI、角色、权限、工作空间和目录映射
项目事项总纲模版.md 模板 创建项目事项总纲滚动账本,记录项目背景、目标、范围和状态
项目事项计划模版.md 模板 创建项目事项计划滚动账本,记录阶段、里程碑、启用体系和任务
项目执行日志模版.md 模板 创建项目管理执行日志,记录项目创建、体系启用、角色调整和关键管理动作
项目审计规范.md 审核规范 定义项目创建、体系启用、权限、目录和项目级流程审计规则
项目事项审计报告模版.md 模板 创建项目事项审计报告滚动账本
项目问题记录模版.md 模板 创建非审计来源项目级问题闭环滚动账本;审计问题只做索引
项目变更记录模版.md 模板 创建项目级变更记录,记录体系启用、目录调整、角色调整和关键口径变化

3. 推荐使用顺序

创建新项目时:

  1. 先读 ../../全局规范.md
  2. 再读 项目规范.md
  3. 项目环境创建指南.md 创建项目根目录和基础文档。
  4. 项目总览范本.md 创建项目根目录 项目总览.md
  5. 项目规范模版.md 创建项目根目录 项目规范.md
  6. 项目配置清单模版.md 创建项目根目录 项目配置清单.md
  7. 按项目需要启用需求、编码、实验、案例分析、数据等体系。
  8. 每启用一个体系,同步创建对应目录和本地规范。
  9. 用项目事项总纲、项目事项计划、项目执行日志、项目事项审计报告、项目问题记录维护项目级证据链。

所有项目级文档默认采用 append-only 方式维护:最新项目事项计划、执行、审计、问题和变更记录追加到对应文件末尾。