From bf157a136d9b08c14b4da2997dc5a03b1a1af33d Mon Sep 17 00:00:00 2001 From: Cai <cai@nbcai.cc> Date: Mon, 07 Sep 2026 12:59:24 +0800 Subject: [PATCH] docs: update governance and operations guidance --- common/ai-workplace/AI工作空间创建指南.md | 15 +++++++++++---- 1 files changed, 11 insertions(+), 4 deletions(-) diff --git "a/common/ai-workplace/AI\345\267\245\344\275\234\347\251\272\351\227\264\345\210\233\345\273\272\346\214\207\345\215\227.md" "b/common/ai-workplace/AI\345\267\245\344\275\234\347\251\272\351\227\264\345\210\233\345\273\272\346\214\207\345\215\227.md" index 66cb76d..f482911 100644 --- "a/common/ai-workplace/AI\345\267\245\344\275\234\347\251\272\351\227\264\345\210\233\345\273\272\346\214\207\345\215\227.md" +++ "b/common/ai-workplace/AI\345\267\245\344\275\234\347\251\272\351\227\264\345\210\233\345\273\272\346\214\207\345\215\227.md" @@ -3,7 +3,7 @@ 创建人员：Codex 文件职责：指导项目管理员在某个项目中为指定 AI 创建工作空间、分配一个或多个角色，并生成该 AI 的 `工作说明.md` 和 `项目问题反馈.md`。 管理规范/模板：../../全局规范.md；../project-doc/项目规范.md；../project-doc/项目配置清单模版.md。 -引用文件：../../全局规范.md；../project-doc/项目规范.md；../project-doc/项目环境创建指南.md；../project-doc/项目配置清单模版.md；AI技能使用规范.md；项目问题反馈范本.md。 +引用文件：../../全局规范.md；../project-doc/项目规范.md；../project-doc/项目环境创建指南.md；../project-doc/项目配置清单模版.md；AI会话协作语义规范.md；AI技能使用规范.md；项目问题反馈范本.md；当前 `MB-X Skill Context.communication_doc` 指向的正式通信协议。 记录方式：通用创建指南；AI 工作空间、角色分配、工作说明或校验口径变化时更新本文。 ## 1. 使用场景 @@ -224,7 +224,8 @@ 10. 审核规范维护边界：如果该 AI 是审核员，要写清可维护的本地审核 / 审计规范入口，以及不得默认修改的被审体系执行规范入口。 11. 技能使用入口：写清允许使用的技能、显式声明方式、状态变更记录和失败处理口径。 12. Codex 会话上下文保护：写清主体内容落文档、窗口只展示摘要和证据入口、大输出不得直接回显、上下文耗尽不得擅自新建 thread。 -13. 禁止事项和越权边界。 +13. Codex 原生通信入口：写清 `communication_doc`、固定工具流程、三态语义、单目标单次发送和禁止自动回退旧链。 +14. 禁止事项和越权边界。 `工作说明.md` 不能替代 `实验规范.md`、`编码规范.md`、`开发审计规范.md`、`项目规范.md` 等体系文档。体系流程变化时，以对应体系文档为准，工作说明只做入口索引。 审核员角色的“必读文档入口”必须同时列出被审体系规范、审计规范 / 审计报告入口、被审对象账本入口。 @@ -235,6 +236,9 @@ 2. 是否能找到必须阅读的体系文档。 3. 是否有不理解、冲突或不合理的地方。 4. 如果有问题，应该反馈给项目管理员并记录到项目执行日志或对应审计报告。 +5. 是否能说清 `list_threads -> read_thread -> wait_threads(timeoutMs=0) -> send_message_to_thread(一次) -> wait_threads(afterCursor) -> read_thread`，以及 `dispatch_accepted != observed != completed`。 + +新角色在完成上述首次阅读反馈前，只算“目录和配置已创建”，不算“通信初始化完成”。首次反馈如果不能说明精确目标核验、唯一 `handoff_id`、单次发送、终态证据和原生工具不可用时停止而非自动回退，项目管理员应直接补充同一份工作说明并要求重读；这是初始化纠正，不新建事项、设计或重复审核链。 ### 5.4 工作说明.md 推荐模板 @@ -244,7 +248,7 @@ 创建人员：<创建人员> 文件职责：记录 <AI_DISPLAY_NAME> 在 <PROJECT_NAME> 中的角色入口、职责边界、权限范围和体系文档路由。 管理规范/模板：../../全局规范.md；../项目规范.md；../项目配置清单.md；../../common/ai-workplace/AI工作空间创建指南.md。 -引用文件：../项目配置清单.md；../项目执行日志.md；../项目变更记录.md；../../common/ai-workplace/AI技能使用规范.md；已启用体系规范。 +引用文件：../项目配置清单.md；../项目执行日志.md；../项目变更记录.md；../../common/ai-workplace/AI会话协作语义规范.md；../../common/ai-workplace/AI技能使用规范.md；当前 `MB-X Skill Context.communication_doc`；已启用体系规范。 记录方式：当前配置说明；角色、权限或工作入口变化时覆盖更新，并在项目变更记录中保留历史。 ## 1. 基本信息 @@ -269,6 +273,7 @@ | 场景 / 角色 | 先读文档 | 用途 | |---|---|---| | 项目基础 | ../项目配置清单.md；../项目规范.md | 确认角色、权限、已启用体系和项目规则 | +| 角色通信 | ../../common/ai-workplace/AI会话协作语义规范.md；当前 `MB-X Skill Context.communication_doc` | 掌握 Codex 原生工具流程、正式 handoff、三态终态和兼容边界 | | <ROLE_SCOPE> | <体系规范入口> | 按体系规范执行，不在工作说明里重复流程 | ## 4. 目录入口 @@ -293,6 +298,7 @@ 1. 首次读取本文件后，在 `ai-<AI_NAME>/worklog/` 记录理解反馈。 2. 如果有不理解、冲突或不合理的地方，反馈给项目管理员，不要自行脑补执行。 3. 如果问题会影响项目协作、角色权限或体系推进，同步记录到 `ai-<AI_NAME>/项目问题反馈.md`。 +4. 反馈必须说明原生任务发现、目标核验、baseline、单次发送、等待和终态判定方法；不能说明时不得把角色标记为通信初始化完成。 ## 7. 技能使用入口 @@ -400,7 +406,8 @@ 13. 是否写清 `项目问题反馈.md` 的入口和边界：只反馈重大协作问题，不替代正式审计报告、问题记录或执行日志。 14. 是否说明 `项目问题反馈.md` 的写法参考 `common/ai-workplace/项目问题反馈范本.md`。 15. 是否引用 `common/ai-workplace/AI技能使用规范.md`，并写清技能显式声明、状态变更记录、消息交互和失败越权处理口径。 -16. 如果角色运行于 Codex 客户端，是否把原生任务通信写成默认路径，并明确 `dispatch_accepted != observed != completed`、单目标单次发送和不得自动回退旧 MB-X inbox/route。 +16. 如果角色运行于 Codex 客户端，是否引用 `AI会话协作语义规范.md` 与当前 `communication_doc`，把原生任务通信写成默认路径，并明确固定工具流程、`dispatch_accepted != observed != completed`、单目标单次发送和不得自动回退旧 MB-X inbox/route。 +17. 首次阅读反馈是否实际说明上述通信方法；只有“已阅读”或“配置匹配”而没有通信理解，不算通信初始化完成。 组合角色还必须按角色类型做专项校验： -- Gitblit v1.9.3