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/目录导读.md | 14 ++++++++------ 1 files changed, 8 insertions(+), 6 deletions(-) diff --git "a/common/ai-workplace/\347\233\256\345\275\225\345\257\274\350\257\273.md" "b/common/ai-workplace/\347\233\256\345\275\225\345\257\274\350\257\273.md" index e57849e..6ceba88 100644 --- "a/common/ai-workplace/\347\233\256\345\275\225\345\257\274\350\257\273.md" +++ "b/common/ai-workplace/\347\233\256\345\275\225\345\257\274\350\257\273.md" @@ -3,7 +3,7 @@ 创建人员：Codex 文件职责：说明 `common/ai-workplace/` 下 AI 工作空间和角色指派相关通用文档的入口。 管理规范/模板：../../全局规范.md。 -引用文件：AI工作空间创建指南.md；AI会话协作语义规范.md；项目问题反馈范本.md。 +引用文件：AI工作空间创建指南.md；AI会话协作语义规范.md；AI技能使用规范.md；项目问题反馈范本.md。 记录方式：目录导读；新增或删除本目录文件时更新。 ## 文件清单 @@ -12,14 +12,16 @@ |---|---| | AI工作空间创建指南.md | 指导项目管理员创建 AI 工作空间、分配角色、生成工作说明和项目问题反馈入口并做校验 | | AI会话协作语义规范.md | 定义 AI 角色会话如何把“提交审核、退回、交给产品、上报管理员”等文档字眼转换为正式角色交互动作 | +| AI技能使用规范.md | 定义 AI 会话如何选择、声明、执行和记录技能，尤其是状态变更、消息交互、失败和越权处理 | | 项目问题反馈范本.md | 提供 `ai-<name>/项目问题反馈.md` 的参考写法，用于重大协作问题和反复返修问题反馈 | ## 使用顺序 1. 项目管理员先确认项目根目录和 `项目配置清单.md`。 2. 按 `AI工作空间创建指南.md` 创建 `ai-<name>/`。 -3. 读取 `AI会话协作语义规范.md`，把角色间交接、审核、确认、返修、升级等自然语言动作写入工作说明。 -4. 生成 `ai-<name>/工作说明.md`。 -5. 参考 `项目问题反馈范本.md` 创建 `ai-<name>/项目问题反馈.md`。 -6. 同步更新 `项目配置清单.md`、`项目执行日志.md`、`项目变更记录.md`。 -7. 按指南中的校验方案检查。 +3. 读取 `AI会话协作语义规范.md` 和当前 `MB-X Skill Context.communication_doc`，把角色间交接、审核、确认、返修、升级等自然语言动作及 Codex 原生任务通信的固定流程、三态终态、单目标单次发送和禁止自动回退写入工作说明。 +4. 读取 `AI技能使用规范.md`，把角色允许使用的技能、显式声明方式、状态变更记录和失败处理口径写入工作说明。 +5. 生成 `ai-<name>/工作说明.md`。 +6. 参考 `项目问题反馈范本.md` 创建 `ai-<name>/项目问题反馈.md`。 +7. 同步更新 `项目配置清单.md`、`项目执行日志.md`、`项目变更记录.md`。 +8. 按指南中的校验方案检查；新角色首次反馈必须能说明原生任务发现、核验、发送、等待和终态判定，才能标记为通信初始化完成。 -- Gitblit v1.9.3