edit | blame | history | raw

项目规范

创建人员:MB-X
文件职责:记录本项目边界、项目配置入口、项目总览入口和项目本地补充规则。
管理规范/模板:../全局规范.md;../common/project-doc/项目规范.md;../common/project-doc/项目规范模版.md。
引用文件:项目总览.md;项目配置清单.md;项目事项总纲.md;项目事项计划.md;项目执行日志.md;项目事项审计报告.md;项目问题记录.md;项目变更记录.md。
记录方式:项目级规范文档;项目长期目标、边界或本地稳定规则变化时更新,不复制全局规范和 common 体系规范正文;动态配置写入项目配置清单.md。

本文件实例化后是项目根目录的本地项目规范,不是 common/project-doc/项目规范.md 的副本。本地项目规范默认引用全局项目规范,只记录本项目特化内容和例外。

1. 项目总览入口

本项目稳定基础信息、目标、周期、背景和关键入口,以 项目总览.md 为准。

2. 项目边界

本项目做:

  1. 承接 wuji 项目的案例分析事项。
  2. 维护项目级治理文档、案例分析文档和必要的开发根账本。
  3. 保存案例分析过程中的正式数据、图片和结果包入口。

本项目不做:

  1. 本次初始化不生成真实案例分析结论。
  2. 未分配角色前,不启动案例分析员或审核员工作流。
  3. 未启用目标开发工作区前,不在 dev/ 根目录直接堆放代码。

3. 项目配置入口

本项目当前启用体系、目录映射、AI 角色、权限边界、工作空间和核心文档入口,以 项目配置清单.md 为准。

本文件不维护动态配置清单,避免项目规范频繁变更。

4. 项目本地补充规则

本项目启用案例分析、实验和目标开发角色,ai-laoanai-xiaoshen 会长期复用可见 Codex 窗口。为降低角色会话上下文耗尽风险,项目内角色必须执行 ../全局规范.md 的 Codex 会话上下文保护规范:

  1. 案例、实验、开发和审核的主体内容必须落到 ana-doc/ana-data/exp-doc/exp-data/dev-doc/dev/tmp/、证据包或正式账本中。
  2. 角色窗口、MB-X 消息和审核交接只展示摘要、关键行、证据入口、结论和期望动作,不复制大段正文。
  3. 检索、日志、目录扫描和图片证据如有全量结果,必须先写入文件或证据入口,再在窗口展示摘要和路径。
  4. 处理 context window full 时,先通知管理端并按备份、摘要、裁剪、审计记录和原 thread 恢复流程处理;不得擅自创建新 thread 替代原角色会话。

如果后续新增项目特化规则,只能补充全局规范和 common 体系规范,不能冲突或削弱。

5. 例外规则

例外项 原因 生效范围 到期 / 复审条件
暂无

6. 冲突处理

如果本文件与 ../全局规范.md 或 common 体系规范冲突:

  1. 先按全局规范和 common 体系规范执行。
  2. 将冲突记录到 项目问题记录.md
  3. 修正本文件或对应本地规范。
  4. 冲突未解决前,不得把相关项目事项标记为完成。