| | |
|---|
| | | 创建人员：Codex |
|---|
| | | 文件职责：说明 `common/ai-workplace/` 下 AI 工作空间和角色指派相关通用文档的入口。 |
|---|
| | | 管理规范/模板：../../全局规范.md。 |
|---|
| | | 引用文件：AI工作空间创建指南.md。 |
|---|
| | | 引用文件：AI工作空间创建指南.md；AI会话协作语义规范.md；AI技能使用规范.md；项目问题反馈范本.md。 |
|---|
| | | 记录方式：目录导读；新增或删除本目录文件时更新。 |
|---|
| | | |
|---|
| | | ## 文件清单 |
|---|
| | | |
|---|
| | | | 文件 | 作用 | |
|---|
| | | |---|---| |
|---|
| | | | AI工作空间创建指南.md | 指导项目管理员创建 AI 工作空间、分配角色、生成工作说明并做校验 | |
|---|
| | | | AI工作空间创建指南.md | 指导项目管理员创建 AI 工作空间、分配角色、生成工作说明和项目问题反馈入口并做校验 | |
|---|
| | | | AI会话协作语义规范.md | 定义 AI 角色会话如何把“提交审核、退回、交给产品、上报管理员”等文档字眼转换为正式角色交互动作 | |
|---|
| | | | AI技能使用规范.md | 定义 AI 会话如何选择、声明、执行和记录技能，尤其是状态变更、消息交互、失败和越权处理 | |
|---|
| | | | 项目问题反馈范本.md | 提供 `ai-<name>/项目问题反馈.md` 的参考写法，用于重大协作问题和反复返修问题反馈 | |
|---|
| | | |
|---|
| | | ## 使用顺序 |
|---|
| | | |
|---|
| | | 1. 项目管理员先确认项目根目录和 `项目配置清单.md`。 |
|---|
| | | 2. 按 `AI工作空间创建指南.md` 创建 `ai-<name>/`。 |
|---|
| | | 3. 生成 `ai-<name>/工作说明.md`。 |
|---|
| | | 4. 同步更新 `项目配置清单.md`、`项目执行日志.md`、`项目变更记录.md`。 |
|---|
| | | 5. 按指南中的校验方案检查。 |
|---|
| | | 3. 读取 `AI会话协作语义规范.md`，把角色间交接、审核、确认、返修、升级等自然语言动作写入工作说明。 |
|---|
| | | 4. 读取 `AI技能使用规范.md`，把角色允许使用的技能、显式声明方式、状态变更记录和失败处理口径写入工作说明。 |
|---|
| | | 5. 生成 `ai-<name>/工作说明.md`。 |
|---|
| | | 6. 参考 `项目问题反馈范本.md` 创建 `ai-<name>/项目问题反馈.md`。 |
|---|
| | | 7. 同步更新 `项目配置清单.md`、`项目执行日志.md`、`项目变更记录.md`。 |
|---|
| | | 8. 按指南中的校验方案检查。 |
|---|
