创建人员：Codex
文件职责：提供 ai-<name>/项目问题反馈.md 的参考写法，帮助 AI 记录重大协作问题、权限/流程问题和反复返修问题。
管理规范/模板：../../全局规范.md；../project-doc/项目规范.md；AI工作空间创建指南.md。
引用文件：../project-doc/项目规范.md；AI工作空间创建指南.md。
记录方式：范本/样例；不是强制模板，不要求项目文件逐字复制；项目文件应参考本范本保留关键字段和 append 记录方式。
项目问题反馈.md 是 AI 工作空间内的私有反馈入口，用于把影响项目推进的问题反馈给项目管理员。
它不替代：
审核员发现问题时，正式审计结论仍写对应审计报告。只有反复返修、流程阻塞、权限边界不清等需要项目管理员介入的问题，才额外写入本文件。
每条反馈建议至少包含：
| 字段 | 说明 |
|---|---|
| 反馈 ID | 稳定编号，例如 FEEDBACK-YYYYMMDD-001 |
| 反馈时间 | 记录时间 |
| 反馈 AI | 写入反馈的 AI |
| 所属项目 | 项目名称或项目 ID |
| AI 角色 | 该 AI 当前执行/审核角色 |
| 关联事项 ID | 对应项目事项、需求事项、开发事项、实验事项或案例事项 ID |
| 关联计划 ID | 对应计划/设计 ID，没有则写 N/A |
| 关联执行日志 ID | 对应执行日志 ID 或路径 |
| 关联审计报告 ID | 对应审计报告条目 ID 或路径 |
| 问题类型 | 权限问题 / 流程问题 / 角色配置问题 / 体系入口问题 / 反复返修问题 / 其他 |
| 反复次数 | 同类问题已返修或复审失败次数 |
| 最近一次返修/复审时间 | 最近一次出现同类问题的时间 |
| 问题发生步骤 | 具体卡在哪个步骤、阶段或模块 |
| 问题描述 | 具体问题，不写泛泛结论 |
| 已要求修复内容 | 审核员已经要求怎么修 |
| 为什么判断为反复问题 | 说明同类问题如何重复出现 |
| 影响范围 | 影响项目级 / 体系级 / 单事项 / 下游交付 |
| 建议项目管理员介入方式 | 建议协调、改权限、改流程、换审核方式等 |
| 关联证据路径 | 相关审计报告、日志、结果包、截图、文档路径 |
| 修复建议 | 必填，说明下一步应怎么修或怎么收敛 |
| 是否需要完整方案 | 是 / 否；复杂、反复难修、跨模块或跨流程问题建议填“是” |
| 完整方案路径 | 需要完整方案时填写，例如代码修复方案、流程整改方案或专项收敛方案路径 |
| 方案摘要 | 需要完整方案时填写，摘要说明核心动作、责任边界和验收方式 |
# 项目问题反馈
创建人员：<创建人员>
文件职责：记录 <AI_DISPLAY_NAME> 在 <PROJECT_NAME> 中遇到的重大项目协作问题、权限/流程问题和反复返修问题。
管理规范/模板：../项目规范.md；../项目配置清单.md；../../common/ai-workplace/AI工作空间创建指南.md；../../common/ai-workplace/项目问题反馈范本.md。
引用文件：../项目执行日志.md；../项目变更记录.md；../项目问题记录.md；相关体系审计报告。
记录方式：append；只追加重要反馈，不覆盖历史。
## 记录边界
1. 本文件只做 AI 私有反馈入口。
2. 正式审计结论写对应审计报告。
3. 需要项目级闭环的问题写 `项目问题记录.md`，本文件只记录已反馈线索。
4. 普通小问题、一次性笔误和临时草稿问题不写入本文件。
## 反馈日志
### FEEDBACK-YYYYMMDD-001
| 字段 | 内容 |
|---|---|
| 反馈时间 | <YYYY-MM-DD HH:mm:ss> |
| 反馈 AI | <AI_DISPLAY_NAME> |
| 所属项目 | <PROJECT_NAME / PROJECT_ID> |
| AI 角色 | <当前角色> |
| 关联事项 ID | <事项 ID> |
| 关联计划 ID | <计划 / 设计 ID 或 N/A> |
| 关联执行日志 ID | <执行日志 ID 或路径> |
| 关联审计报告 ID | <审计报告条目 ID 或路径> |
| 问题类型 | 反复返修问题 |
| 反复次数 | <次数，通常 >= 3> |
| 最近一次返修/复审时间 | <YYYY-MM-DD HH:mm:ss> |
| 问题发生步骤 | <具体步骤> |
| 影响范围 | <项目级 / 体系级 / 单事项 / 下游交付> |
| 是否已同步项目管理员 | 是 / 否 |
| 关联证据路径 | <路径列表> |
| 修复建议 | <下一步应怎么修，必须填写> |
| 是否需要完整方案 | 是 / 否 |
| 完整方案路径 | <需要完整方案时填写；不需要写 N/A> |
| 方案摘要 | <需要完整方案时填写；不需要写 N/A> |
问题描述：
<具体说明问题是什么，避免只写“又错了”。>
已要求修复内容：
<列出之前审计要求的修复点。>
为什么判断为反复问题：
<说明同类问题在哪几轮重复出现。>
建议项目管理员介入方式：
<例如要求统一口径、调整角色、暂停扩展、组织专项修复、改流程等。>
修复建议：
<给出可执行的下一步修复建议，不只写“继续修”。>
完整方案：
<如果问题复杂或反复难修，写方案路径和摘要；例如“见 dev-doc/代码问题闭环修复方案.md，本次应统一公共入口，不再散点修”。>