common/ai-workplace/项目问题反馈范本.md
New file @@ -0,0 +1,121 @@ # 项目问题反馈范本 创建人员：Codex 文件职责：提供 `ai-<name>/项目问题反馈.md` 的参考写法，帮助 AI 记录重大协作问题、权限/流程问题和反复返修问题。 管理规范/模板：../../全局规范.md；../project-doc/项目规范.md；AI工作空间创建指南.md。 引用文件：../project-doc/项目规范.md；AI工作空间创建指南.md。 记录方式：范本/样例；不是强制模板，不要求项目文件逐字复制；项目文件应参考本范本保留关键字段和 append 记录方式。 ## 1. 使用边界 `项目问题反馈.md` 是 AI 工作空间内的私有反馈入口，用于把影响项目推进的问题反馈给项目管理员。 它不替代： 1. 正式审计报告。 2. 项目问题记录。 3. 各体系问题记录。 4. 项目执行日志或体系执行日志。 审核员发现问题时，正式审计结论仍写对应审计报告。只有反复返修、流程阻塞、权限边界不清等需要项目管理员介入的问题，才额外写入本文件。 ## 2. 建议字段 每条反馈建议至少包含： | 字段 | 说明 | |---|---| | 反馈 ID | 稳定编号，例如 `FEEDBACK-YYYYMMDD-001` | | 反馈时间 | 记录时间 | | 反馈 AI | 写入反馈的 AI | | 所属项目 | 项目名称或项目 ID | | AI 角色 | 该 AI 当前执行/审核角色 | | 关联事项 ID | 对应项目事项、需求事项、开发事项、实验事项或案例事项 ID | | 关联计划 ID | 对应计划/设计 ID，没有则写 N/A | | 关联执行日志 ID | 对应执行日志 ID 或路径 | | 关联审计报告 ID | 对应审计报告条目 ID 或路径 | | 问题类型 | 权限问题 / 流程问题 / 角色配置问题 / 体系入口问题 / 反复返修问题 / 其他 | | 反复次数 | 同类问题已返修或复审失败次数 | | 最近一次返修/复审时间 | 最近一次出现同类问题的时间 | | 问题发生步骤 | 具体卡在哪个步骤、阶段或模块 | | 问题描述 | 具体问题，不写泛泛结论 | | 已要求修复内容 | 审核员已经要求怎么修 | | 为什么判断为反复问题 | 说明同类问题如何重复出现 | | 影响范围 | 影响项目级 / 体系级 / 单事项 / 下游交付 | | 建议项目管理员介入方式 | 建议协调、改权限、改流程、换审核方式等 | | 关联证据路径 | 相关审计报告、日志、结果包、截图、文档路径 | | 修复建议 | 必填，说明下一步应怎么修或怎么收敛 | | 是否需要完整方案 | 是 / 否；复杂、反复难修、跨模块或跨流程问题建议填“是” | | 完整方案路径 | 需要完整方案时填写，例如代码修复方案、流程整改方案或专项收敛方案路径 | | 方案摘要 | 需要完整方案时填写，摘要说明核心动作、责任边界和验收方式 | ## 3. 参考写法 ```markdown # 项目问题反馈 创建人员：<创建人员> 文件职责：记录 <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，本次应统一公共入口，不再散点修”。> ``` ## 4. 写入原则 1. 只写会影响项目或体系推进的重要问题。 2. 记录必须能让项目管理员追踪到具体事项 ID、问题步骤和证据路径。 3. 审计主结论仍写对应审计报告，本文件只做升级反馈。 4. 不要把普通小问题、一次性笔误、个人草稿问题写入本文件。 5. 反复返修问题必须给修复建议；复杂问题应附完整方案或方案路径。 project-ai-workspace-feedback-smoke-20260605/ai-smoke/worklog/20260605_工作说明理解反馈.md
New file @@ -0,0 +1,15 @@ # 工作说明理解反馈 创建人员：Codex 文件职责：记录 smoke 首次读取工作说明后的理解反馈。 管理规范/模板：../工作说明.md；../../common/ai-workplace/AI工作空间创建指南.md。 引用文件：../工作说明.md；../项目问题反馈.md。 记录方式：append；角色或工作说明变化后追加。 ## 2026-06-05 1. 能理解当前角色、权限和正式产物入口。 2. 能找到必须阅读的项目规范、项目配置清单和项目事项账本。 3. `项目问题反馈.md` 的边界清楚：只反馈重大协作问题，不替代审计报告、正式问题记录或执行日志。 4. 未发现不理解、冲突或不合理内容。
New file @@ -0,0 +1,58 @@ # smoke 工作说明 创建人员：Codex 文件职责：记录 smoke 在 AI 工作空间反馈 smoke 项目中的角色入口、职责边界、权限范围和体系文档路由。 管理规范/模板：../../全局规范.md；../项目规范.md；../项目配置清单.md；../../common/ai-workplace/AI工作空间创建指南.md。 引用文件：../项目配置清单.md；../项目执行日志.md；../项目变更记录.md；已启用体系规范。 记录方式：当前配置说明；角色、权限或工作入口变化时覆盖更新，并在项目变更记录中保留历史。 ## 1. 基本信息 | 字段 | 内容 | |---|---| | AI 名称 | smoke | | 显示名称 | smoke | | 工作空间 | ai-smoke/ | | 指派人 | Codex | | 指派时间 | 2026-06-05 | | 指派原因 | 测试 AI 工作空间反馈文档创建 | ## 2. 当前角色 | 角色 | 职责范围 | 默认写权限 | 关键规范 | |---|---|---|---| | 项目管理员 | 初始化和维护项目基础配置 | 项目根目录；ai-smoke/ | ../项目规范.md；../项目配置清单.md | | 项目事项审核员 | 审核项目初始化事项 | ../项目事项审计报告.md；ai-smoke/ | ../common/project-doc/项目审计规范.md | ## 3. 必读文档入口 | 场景 / 角色 | 先读文档 | 用途 | |---|---|---| | 项目基础 | ../项目配置清单.md；../项目规范.md | 确认角色、权限、已启用体系和项目规则 | | 项目事项审核 | ../项目事项总纲.md；../项目事项计划.md；../项目执行日志.md；../项目事项审计报告.md | 串起事项证据链 | ## 4. 目录入口 1. 私有草稿：`ai-smoke/draft/` 2. 私有临时文件：`ai-smoke/tmp/` 3. 私有过程记录：`ai-smoke/worklog/` 4. 私有项目问题反馈：`ai-smoke/项目问题反馈.md` 5. 正式产物：项目根目录内项目级文档 6. 审计入口：`项目事项审计报告.md` ## 5. 任务入口路由 接到任务后，先查 `项目配置清单.md`，确认角色和写权限，再按项目规范执行。 ## 6. 首次阅读反馈 首次读取本文件后，在 `ai-smoke/worklog/` 记录理解反馈；如果发现影响协作的问题，同步记录到 `ai-smoke/项目问题反馈.md`。 ## 7. 审核边界 如果执行自审，必须在 `项目事项审计报告.md` 标注自审并列出可复核证据。 ## 8. 禁止事项 不得把 `项目问题反馈.md` 当成正式审计报告、正式问题记录或正式执行日志。
New file @@ -0,0 +1,19 @@ # 项目问题反馈 创建人员：Codex 文件职责：记录 smoke 在 AI 工作空间反馈 smoke 项目中遇到的重大项目协作问题、权限/流程问题和反复返修问题。 管理规范/模板：../项目规范.md；../项目配置清单.md；../../common/ai-workplace/AI工作空间创建指南.md；../../common/ai-workplace/项目问题反馈范本.md。 引用文件：../项目执行日志.md；../项目变更记录.md；../项目问题记录.md；相关体系审计报告；../../common/ai-workplace/项目问题反馈范本.md。 记录方式：append；只追加重要反馈，不覆盖历史。 ## 记录边界 1. 本文件只做 AI 私有反馈入口。 2. 正式审计结论写对应审计报告。 3. 需要项目级闭环的问题写 `项目问题记录.md`，本文件只记录已反馈线索。 4. 普通小问题、一次性笔误和临时草稿问题不写入本文件。 5. 具体写法参考 `../../common/ai-workplace/项目问题反馈范本.md`，但不要求逐字复制范本。 ## 反馈日志 当前无反馈问题。 project-ai-workspace-feedback-smoke-20260605/dev-doc/开发事项总纲.md
New file @@ -0,0 +1,10 @@ # 开发事项总纲 创建人员：Codex 文件职责：记录开发事项背景、目标和状态。 管理规范/模板：../全局规范.md；../common/dev-doc/编码规范.md。 引用文件：开发事项计划.md；开发执行日志.md；开发审计报告.md。 记录方式：append。 当前无开发事项。
New file @@ -0,0 +1,10 @@ # 开发事项计划 创建人员：Codex 文件职责：记录开发事项计划和验收方式。 管理规范/模板：../全局规范.md；../common/dev-doc/编码规范.md。 引用文件：开发事项总纲.md；开发执行日志.md；开发审计报告.md。 记录方式：append。 当前无开发事项计划。
New file @@ -0,0 +1,10 @@ # 开发审计报告 创建人员：Codex 文件职责：记录开发审计结论。 管理规范/模板：../全局规范.md；../common/dev-doc/开发审计规范.md。 引用文件：开发事项总纲.md；开发事项计划.md；开发执行日志.md。 记录方式：append。 当前无开发审计记录。
New file @@ -0,0 +1,10 @@ # 开发审计规范 创建人员：Codex 文件职责：本项目开发审计规范入口。 管理规范/模板：../全局规范.md；../common/dev-doc/开发审计规范.md。 引用文件：编码规范.md；开发审计报告.md。 记录方式：本地规范补充。 本项目遵守 `../common/dev-doc/开发审计规范.md`，暂无本地补充。
New file @@ -0,0 +1,10 @@ # 开发执行日志 创建人员：Codex 文件职责：记录开发执行关键节点。 管理规范/模板：../全局规范.md；../common/dev-doc/编码规范.md。 引用文件：开发事项总纲.md；开发事项计划.md；开发审计报告.md。 记录方式：append。 当前无开发执行记录。
New file @@ -0,0 +1,10 @@ # 开发问题记录 创建人员：Codex 文件职责：记录非审计来源的开发问题。 管理规范/模板：../全局规范.md；../common/dev-doc/编码规范.md。 引用文件：开发审计报告.md；开发执行日志.md。 记录方式：append。 当前无开发问题。
New file @@ -0,0 +1,10 @@ # 目录导读 创建人员：Codex 文件职责：说明本项目开发文档入口。 管理规范/模板：../common/dev-doc/编码规范.md。 引用文件：编码规范.md；开发审计规范.md；开发事项总纲.md；开发事项计划.md；开发执行日志.md；开发审计报告.md；开发问题记录.md。 记录方式：目录导读。 本目录为开发体系根级文档区。
New file @@ -0,0 +1,10 @@ # 编码规范 创建人员：Codex 文件职责：本项目开发编码规范入口。 管理规范/模板：../全局规范.md；../common/dev-doc/编码规范.md。 引用文件：开发审计规范.md；开发事项总纲.md；开发事项计划.md；开发执行日志.md。 记录方式：本地规范补充。 本项目遵守 `../common/dev-doc/编码规范.md`，暂无本地补充。
New file @@ -0,0 +1,21 @@ # 项目事项审计报告 创建人员：Codex 文件职责：记录项目计划审计、执行审计和复审结论。 管理规范/模板：../全局规范.md；../common/project-doc/项目审计规范.md；../common/project-doc/项目事项审计报告模版.md。 引用文件：项目事项总纲.md；项目事项计划.md；项目执行日志.md；项目配置清单.md。 记录方式：append；审计结论追加记录。 ## AUDIT-AIWORKSPACE-SMOKE-001 审计对象：PROJECT-AIWORKSPACE-SMOKE-001 审计结论：PASS 检查结果： 1. `ai-smoke/工作说明.md` 存在。 2. `ai-smoke/项目问题反馈.md` 存在。 3. `项目配置清单.md` 已登记 `ai-smoke/`。 4. `项目执行日志.md` 和 `项目变更记录.md` 已记录创建动作。
New file @@ -0,0 +1,14 @@ # 项目事项总纲 创建人员：Codex 文件职责：记录项目级事项背景、目标、状态和结论。 管理规范/模板：../全局规范.md；../common/project-doc/项目规范.md；../common/project-doc/项目事项总纲模版.md。 引用文件：项目事项计划.md；项目执行日志.md；项目事项审计报告.md。 记录方式：append；最新事项追加到文档末尾。 ## PROJECT-AIWORKSPACE-SMOKE-001 目标：验证 AI 工作空间新增 `项目问题反馈.md` 后，项目创建流程和校验方案可落地。 状态：执行完成，待审计确认。
New file @@ -0,0 +1,22 @@ # 项目事项计划 创建人员：Codex 文件职责：记录项目级事项计划、步骤和验收方式。 管理规范/模板：../全局规范.md；../common/project-doc/项目规范.md；../common/project-doc/项目事项计划模版.md。 引用文件：项目事项总纲.md；项目执行日志.md；项目事项审计报告.md。 记录方式：append；最新计划追加到文档末尾。 ## PLAN-AIWORKSPACE-SMOKE-001 对应事项：PROJECT-AIWORKSPACE-SMOKE-001 步骤： 1. 创建项目基础目录和文档。 2. 创建 `ai-smoke/`、`tmp/`、`draft/`、`worklog/`。 3. 创建 `工作说明.md` 和 `项目问题反馈.md`。 4. 更新项目配置清单、执行日志和变更记录。 5. 按 AI 工作空间创建指南校验。 验收方式：所有登记 AI 工作空间均存在 `工作说明.md` 和 `项目问题反馈.md`，且配置清单、日志和变更记录能串起证据链。
New file @@ -0,0 +1,16 @@ # 项目变更记录 创建人员：Codex 文件职责：记录项目级变更，包括体系启用/停用、目录调整、角色调整、项目目标或边界变化。 管理规范/模板：../全局规范.md；../common/project-doc/项目规范.md；../common/project-doc/项目变更记录模版.md。 引用文件：项目配置清单.md；项目执行日志.md。 记录方式：append；项目级配置或目录变化时追加。 ## CHANGE-AIWORKSPACE-SMOKE-001 时间：2026-06-05 变更内容：初始化项目，并为 smoke 创建 `ai-smoke/工作说明.md` 和 `ai-smoke/项目问题反馈.md`。 影响范围：项目配置清单、项目执行日志、AI 工作空间。
New file @@ -0,0 +1,27 @@ # 项目总览 创建人员：Codex 文件职责：记录项目稳定基础信息、目标、周期、背景和关键入口。 管理规范/模板：../全局规范.md；../common/project-doc/项目规范.md；../common/project-doc/项目总览范本.md。 引用文件：项目规范.md；项目配置清单.md；项目事项总纲.md；项目执行日志.md。 记录方式：稳定项目画像；项目基础信息变化时更新，并在项目变更记录中留痕。 ## 1. 基本信息 | 字段 | 内容 | |---|---| | 项目名称 | AI 工作空间反馈 smoke 项目 | | 项目 ID | project-ai-workspace-feedback-smoke-20260605 | | 项目根目录 | D:/manage_system/project-ai-workspace-feedback-smoke-20260605 | | 创建时间 | 2026-06-05 | | 项目管理员 | Codex | | 当前状态 | 测试完成待审 | ## 2. 项目目标 验证新项目创建时，AI 工作空间会按指南生成 `工作说明.md` 和 `项目问题反馈.md`，并能被校验方案检查通过。 ## 3. 背景 管理系统新增 AI 工作空间私有反馈文档要求，需要验证通用指南和项目创建指南不会遗漏该文件。
New file @@ -0,0 +1,22 @@ # 项目执行日志 创建人员：Codex 文件职责：记录项目创建、体系启用、角色调整、目录调整和其他项目级管理动作。 管理规范/模板：../全局规范.md；../common/project-doc/项目规范.md；../common/project-doc/项目执行日志模版.md。 引用文件：项目事项总纲.md；项目事项计划.md；项目事项审计报告.md；项目变更记录.md。 记录方式：append；关键执行节点追加记录。 ## LOG-AIWORKSPACE-SMOKE-001 时间：2026-06-05 执行内容： 1. 创建项目目录。 2. 创建项目基础文档。 3. 创建开发根级目录和文档入口。 4. 创建 `ai-smoke/工作说明.md`。 5. 创建 `ai-smoke/项目问题反馈.md`。 输出位置：D:/manage_system/project-ai-workspace-feedback-smoke-20260605
New file @@ -0,0 +1,12 @@ # 项目规范 创建人员：Codex 文件职责：记录本项目本地项目规范入口和本地补充。 管理规范/模板：../全局规范.md；../common/project-doc/项目规范.md；../common/project-doc/项目规范模版.md。 引用文件：项目总览.md；项目配置清单.md；项目事项总纲.md；项目执行日志.md。 记录方式：本地规范补充；默认引用 common 项目规范。 本项目必须遵守 `../全局规范.md` 和 `../common/project-doc/项目规范.md`。 本地补充：本项目仅用于 AI 工作空间反馈文档创建 smoke，不承载正式业务事项。
New file @@ -0,0 +1,62 @@ # 项目配置清单 创建人员：Codex 文件职责：记录本项目当前启用体系、AI 角色、权限边界、工作空间、目录映射和核心文档入口，是项目当前配置的事实源。 管理规范/模板：../全局规范.md；../common/project-doc/项目规范.md；../common/project-doc/项目配置清单模版.md。 引用文件：项目总览.md；项目规范.md；项目事项总纲.md；项目执行日志.md；项目事项审计报告.md；项目问题记录.md；项目变更记录.md；../common/ai-workplace/AI工作空间创建指南.md。 记录方式：项目配置清单；当前状态可覆盖更新，变更原因和历史必须同步写入项目变更记录.md 和项目执行日志.md。 ## 1. 项目基本配置 | 字段 | 内容 | |---|---| | 项目名称 | AI 工作空间反馈 smoke 项目 | | 项目 ID | project-ai-workspace-feedback-smoke-20260605 | | 项目根目录 | D:/manage_system/project-ai-workspace-feedback-smoke-20260605 | | 项目管理员 | Codex | | 创建时间 | 2026-06-05 | | 当前状态 | 测试完成待审 | ## 2. 已启用体系 | 体系 | 是否启用 | 目录 | common 规范 | 本地规范 | 适用角色 | 最近变更记录 | |---|---|---|---|---|---|---| | 项目体系 | 是 | ./ | ../common/project-doc/项目规范.md | 项目规范.md | 项目管理员 | CHANGE-AIWORKSPACE-SMOKE-001 | | 开发体系 | 是 | dev/；dev/test/；dev/tmp/；dev-doc/ | ../common/dev-doc/编码规范.md；../common/dev-doc/开发审计规范.md | dev-doc/编码规范.md；dev-doc/开发审计规范.md | 开发 AI | CHANGE-AIWORKSPACE-SMOKE-001 | ## 3. AI 角色与权限 | AI 名称 | 角色 | 是否审核员 | 工作空间 | 默认写权限范围 | 审计报告入口 | 备注 | |---|---|---|---|---|---|---| | smoke | 项目管理员；项目事项审核员 | 是 | ai-smoke/ | 项目根目录；ai-smoke/ | 项目事项审计报告.md | 测试 AI | ## 4. 目录映射 | 目录 | 用途 | 负责人 / 角色 | 状态 | 备注 | |---|---|---|---|---| | ./ | 项目根目录 | 项目管理员 | 已创建 | | | dev/ | 开发代码根目录 | 开发 AI | 已创建 | | | dev-doc/ | 开发文档根目录 | 开发 AI | 已创建 | | | tmp/ | 项目级临时文件 | 项目管理员 | 已创建 | | | ai-smoke/ | AI 工作空间 | smoke | 已创建 | 包含 `工作说明.md` 和 `项目问题反馈.md` | ## 5. 核心文档入口 | 文档 | 作用 | 状态 | |---|---|---| | 项目总览.md | 项目稳定基础信息 | 已创建 | | 项目规范.md | 本地项目规范 | 已创建 | | 项目配置清单.md | 当前配置事实源 | 已创建 | | 项目事项总纲.md | 项目事项账本 | 已创建 | | 项目事项计划.md | 项目事项计划账本 | 已创建 | | 项目执行日志.md | 项目执行日志 | 已创建 | | 项目事项审计报告.md | 项目事项审计报告 | 已创建 | | 项目问题记录.md | 非审计问题记录 | 已创建 | | 项目变更记录.md | 项目级变更历史 | 已创建 | ## 6. 变更索引 | 时间 | 变更记录 ID | 变更摘要 | 执行人 | |---|---|---|---| | 2026-06-05 | CHANGE-AIWORKSPACE-SMOKE-001 | 初始化项目并创建 ai-smoke 工作空间 | Codex |
New file @@ -0,0 +1,10 @@ # 项目问题记录 创建人员：Codex 文件职责：记录非审计来源的项目级问题；审计问题只做跨轮索引。 管理规范/模板：../全局规范.md；../common/project-doc/项目规范.md；../common/project-doc/项目问题记录模版.md。 引用文件：项目事项审计报告.md；项目执行日志.md；项目变更记录.md。 记录方式：append；无问题时保留空账本。 当前无非审计来源项目级问题。 Binary files differ
