1
1
2026-06-05 b4dca74913f716db20f68472bc2917e973213292
common/project-doc/项目规范.md
@@ -199,6 +199,42 @@
项目级问题只记录项目治理问题。具体需求、代码、实验、案例分析问题,优先记录到对应体系的问题文档;如果这些问题影响项目级目录、权限、目标或体系启用,再同步登记项目级问题或变更。
### 3.6 AI 工作空间问题反馈与反复返修升级
每个 AI 工作空间中的 `项目问题反馈.md` 是该 AI 向项目管理员反馈重大协作问题的私有入口。
它服务于项目治理,不替代正式审计报告、项目问题记录、体系问题记录或执行日志。
适合写入:
1. 角色权限、工作空间、体系入口、流程边界不清,已经影响项目或体系推进。
2. 同一事项或同类问题多轮返修后仍重复出现,通常大于等于 3 次。
3. 审核员判断需要项目管理员介入协调、收口口径、调整角色、调整流程或暂停扩展。
4. AI 首次阅读工作说明、项目配置清单或体系规范后,发现职责/权限/入口存在影响执行的重大不清楚。
审核员发现被审事项存在问题时,仍必须先把正式审计结论写入对应审计报告。
如果同一问题经过多轮返修仍重复出现,审核员应额外在自己工作空间的 `项目问题反馈.md` 追加一条反复返修问题反馈。
反复返修问题反馈必须尽量记录清楚:
1. 关联事项 ID。
2. 关联计划 ID 或设计 ID。
3. 关联执行日志 ID。
4. 关联审计报告 ID。
5. 问题发生步骤。
6. 反复次数。
7. 已要求修复内容。
8. 为什么判断为反复问题。
9. 影响范围。
10. 关联证据路径。
11. 建议项目管理员介入方式。
12. 修复建议。该字段必填,至少给出下一步应怎么收敛。
13. 是否需要完整方案。如果问题复杂、反复难修或涉及多模块/多流程,应标记为“是”。
14. 完整方案路径。需要完整方案时填写,例如代码修复方案、流程整改方案或专项收敛方案路径。
15. 方案摘要。需要完整方案时,摘要说明方案核心动作、责任边界和验收方式。
`项目问题反馈.md` 的写法参考 `common/ai-workplace/项目问题反馈范本.md`,但不要求逐字复制范本。项目文件只要保留关键字段、记录边界和 append 写法即可。
## 4. 核心文档
### 4.1 项目总览.md
@@ -345,6 +381,36 @@
## 7. 项目审计边界
### 7.1 事项级整体审核原则
审核员审核事项时,必须以事项为基本单元,而不是以单个步骤、单个文件或单个输出为基本单元。
事项单元以对应体系总纲文档中的一个目标 / 事项条目为准。审核员应围绕该事项整体检查:
1. 目标是否清楚。
2. 设计 / 计划是否能支撑目标。
3. 执行日志是否覆盖关键节点。
4. 关键输入、关键输出、关键数据和关键产物是否可追踪。
5. 结论是否回写。
6. 问题是否闭环。
如果审核过程中发现关键节点、关键数据、关键产物或关键证据链缺失,应作为审计问题反馈。
审核员不得把不影响事项目标、结论、关键证据链或下游使用的边角料问题升级为阻断问题;不得通过拆分步骤审计的方式层层加码。
在不同体系中,事项单元对应如下:
| 体系 | 审核事项单元 |
|---|---|
| 项目体系 | `项目事项总纲.md` 中的一个项目事项 |
| 需求体系 | `需求总纲.md` 中的一个需求目标或需求事项 |
| 开发体系 | `开发事项总纲.md` 中的一个开发事项 |
| 实验体系 | `实验总纲.md` 中的一个实验目标或实验事项 |
| 案例分析体系 | `案例总纲.md` 中的一个案例目标或案例事项 |
| 数据体系 | 数据体系总纲或数据事项账本中的一个数据目标或数据事项 |
### 7.2 项目级审计边界
项目级审计重点看:
1. 项目是否有清晰目标和边界。