Files

Game Director 2db71e37f4 docs: 明确单一 Workspace 架构

- 所有 agent 共用 workspace-game-director
- 没有独立的 agent workspace
- 统一存储在 projects/ 目录下
- 策划总监管理整个 workspace

2026-03-19 03:35:21 +08:00

9.5 KiB

Raw Blame History

游戏策划工作室 - 工作流程规范

最后更新： 2026-03-19
版本： v1.1

📁 文档存储架构

纯 Git 工作流（策划文档）

内容类型	存储位置	格式	工具
策划模板	Git 仓库	.md	Git
项目文档	Git 仓库	.md	Git
竞品分析	Git 仓库	.md	Git
规范标准	Git 仓库	.md	Git

远程仓库： http://git.joywaygames.cn:3000/basegames/gamedesign-docs-templates.git

飞书多维表格（Agent 沟通记录）

内容类型	存储位置	说明
Agent 调用记录	飞书多维表格	记录每次 AI 策划调用
任务下发内容	飞书多维表格	任务描述、时间
返回结果	飞书多维表格	AI 产出内容摘要
耗时统计	飞书多维表格	性能监控

多维表格： https://basegames.feishu.cn/base/Joc4bhUqEa6wJdsmevFc9YVhnH0

🔄 工作流程

新项目启动

1. 用户在飞书提出需求
   ↓
2. 我在本地创建项目文件夹 (Git)
   ↓
3. 复制对应模板到项目文件夹
   ↓
4. 调用 AI 策划 agent 生成初稿
   ↓
5. 记录调用到飞书多维表格
   ↓
6. 审核并整合产出
   ↓
7. 提交到 Git 仓库
   ↓
8. 返回用户最终文档

Agent 调用记录

每次调用专精策划时必须记录：

字段	必填	说明
调用时间	✅	精确到秒
调用方	✅	game-director
被调用方	✅	专精 agent ID
任务类型	✅	竞品分析/系统设计等
会话 ID	✅	关联完整会话
任务下发内容	✅	完整任务描述
回复内容	✅	AI 返回的完整内容
耗时	✅	秒
状态	✅	进行中/已完成

📂 Workspace 架构

单一 Workspace 模式

重要： 所有 Agent 共用一个 Workspace，不各自独立。

/home/admin/.openclaw/
└── workspace-game-director/     ← 唯一工作区（策划总监管理）
    ├── templates/               # 模板文件
    ├── projects/                # 项目文档（所有 agent 共用）
    │   └── 项目名/
    │       ├── 系统设计/
    │       │   ├── 初稿/        # 所有 agent 初稿都保存到这里
    │       │   └── 最终稿
    │       └── ...
    ├── agents/                  # agent 人设文档
    └── ...

关键点：

✅ 只有一个 Workspace：workspace-game-director
✅ 所有 Agent 共享这个 Workspace
✅ 统一存储在 projects/ 目录下
✅ 策划总监管理整个 Workspace

Git 目录结构

gamedesign-docs-templates/
├── templates/                    # 模板文件（只读，不常改）
│   ├── 【模板】关卡设计文档.md
│   ├── 【模板】UIUX 设计文档.md
│   └── ...
├── projects/                     # 项目文档
│   └── 项目名称/
│       ├── 系统设计/
│       │   ├── 初稿/             # 专精 agent 产出（可选提交）
│       │   │   ├── system-designer-xxx-v1.md
│       │   │   └── numerics-designer-xxx-v1.md
│       │   └── XXX 系统设计文档.md  ← 最终稿（必须提交）
│       ├── 数值设计/
│       │   ├── 初稿/
│       │   └── XXX 数值设计文档.md
│       ├── 战斗设计/
│       ├── 叙事设计/
│       └── ...
├── competitive-analysis/         # 竞品分析
├── standards/                    # 规范标准
├── drafts/                       # 临时草稿（不提交）
└── README.md

文档层级说明

层级	位置	内容	提交
初稿	`projects/项目/分类/初稿/`	专精 agent 产出	可选
最终稿	`projects/项目/分类/`	策划总监整合	✅ 必须
临时稿	`drafts/`	工作过程文件	❌ 不提交

🎯 工具使用边界

工具	用途	不用于
Git	策划文档版本管理	非文文件、大文件
飞书多维表格	Agent 沟通记录	文档正文存储
飞书云盘	可选：文档审阅协作	主存储
本地编辑器	文档编写	-

📝 Git 提交规范

Commit Message 格式

<type>: <subject>

[optional body]

Type 类型

类型	说明	示例
feat	新功能	`feat: 新增原神项目文档`
docs	文档修改	`docs: 更新 README.md`
fix	修复	`fix: 修正数值公式错误`
refactor	重构	`refactor: 优化模板结构`
style	格式	`style: 格式化 Markdown`

示例

git commit -m "feat: 新增原神项目 - 核心玩法系统设计"
git commit -m "docs: 更新模板使用说明"
git commit -m "fix: 修正战斗公式计算错误"

🤖 AI 协作流程

文档编写职责分工

内容	负责方	说明
专业内容初稿	专精 agent	各自领域的专业内容
技术细节	专精 agent	公式、配置、规则
需求分析	策划总监	理解用户需求，拆解任务
模板选择	策划总监	选择合适的文档模板
格式统一	策划总监	确保文档风格一致
内容整合	策划总监	合并多个 agent 产出
质量审核	策划总监	检查完整性、一致性
最终提交	策划总监	Git 提交、返回用户

核心原则：

✅ 专精 agent 输出专业初稿，不直接提交最终文档
✅ 策划总监统一审核、整合、提交
✅ 用户只对接策划总监一人

专精 Agent 产出规范

Workspace 说明

所有专精 Agent 共用策划总监的 Workspace：

✅ 没有独立的 agent workspace
✅ 所有文档保存在 workspace-game-director/projects/
✅ 策划总监统一管理和协调

初稿保存位置

projects/项目名称/分类/初稿/<agentID>-<内容>-v<版本>.md

示例：
- projects/原神/系统设计/初稿/system-designer-公会系统 -v1.md
- projects/原神/数值设计/初稿/numerics-designer-经济数值 -v1.md

命名规范

<agentID>-<内容简述>-v<版本号>.md

示例：
- system-designer-公会系统架构 -v1.md
- numerics-designer-战斗数值 -v1.md
- narrative-writer-世界观设定 -v1.md
- combat-designer-Boss 技能设计 -v1.md

初稿内容要求

✅ 完整的专业内容
✅ 技术细节和公式
✅ 可以包含注释和待确认项
✅ 使用标准 Markdown 格式
✅ 调用 markdown-formatter 格式化

最终稿整合

projects/项目名称/分类/<文档类型> 文档.md

示例：
- projects/原神/系统设计/公会系统设计文档.md
- projects/原神/数值设计/战斗数值设计文档.md

Git 提交策略

方案 A：只提交最终稿（推荐）

.gitignore 配置：

# 初稿文件夹（可选）
projects/*/初稿/

# 临时文件
drafts/
*.tmp

提交流程：

# 策划总监整合后提交最终稿
git add projects/项目名/系统设计/公会系统设计文档.md
git commit -m "feat: 新增公会系统设计文档"
git push

优点：

仓库简洁
只保留最终版本
减少文件大小

方案 B：提交完整历史（可选）