Files

Game Director 5ec384c414 docs: 更新文档存储架构和初稿管理规范

- 明确专精 agent 初稿保存位置：projects/项目/分类/初稿/
- 规范初稿命名：<agentID>-<内容>-v<版本>.md
- 两种 Git 提交策略：只提交最终稿 (推荐) / 提交完整历史
- 更新 .gitignore 配置建议
- 完善 AI 协作流程

2026-03-19 03:31:25 +08:00

8.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 返回的完整内容
耗时	✅	秒
状态	✅	进行中/已完成

📂 Git 目录结构

文档层级说明

层级	位置	内容	提交
初稿	`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 产出规范

初稿保存位置

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：提交完整历史（可选）

提交流程：

# 提交初稿 + 最终稿
git add projects/项目名/系统设计/初稿/
git add projects/项目名/系统设计/公会系统设计文档.md
git commit -m "feat: 新增公会系统设计文档（含初稿）"
git push

优点：

完整记录创作过程
可追溯每个 agent 贡献
方便后续修改参考

调用 AI 策划流程

1. 策划总监分析需求，选择模板
   ↓
2. 调用专精 agent A → 输出初稿 A → 保存到初稿/
   ↓
3. 调用专精 agent B → 输出初稿 B → 保存到初稿/
   ↓
4. 策划总监整合初稿 → 完整文档
   ↓
5. 策划总监审核、调整、标准化
   ↓
6. 记录调用到飞书多维表格
   ↓
7. 策划总监提交 Git（最终稿）
   ↓
8. 返回用户最终文档

选择模板 - 根据需求选择对应模板
下发任务 - 发送模板 + 需求给 AI agent
记录调用 - 填写飞书多维表格
接收产出 - AI 返回 .md 格式文档
保存初稿 - 保存到 初稿/ 文件夹
审核整合 - 策划总监审核调整
提交归档 - 策划总监 Git 提交最终稿

调用限制

限制项	值	说明
每个 agent 调用次数	≤2 次	允许一次追问
单次任务总调用	≤5 次	所有 agent 合计
超时时间	600 秒	10 分钟

📊 飞书多维表格字段

表格链接： https://basegames.feishu.cn/base/Joc4bhUqEa6wJdsmevFc9YVhnH0

必填字段（16 个）

调用时间
调用方
被调用方
任务类型
会话 ID
任务下发时间
任务下发内容
回复时间
回复完整内容
返回结果摘要
耗时 (秒)
追问记录
时间线
关联文档
调用轮次
状态

⚠️ 重要原则

文档正文 → 只用 Git 管理 (.md)
沟通记录 → 只用飞书多维表格
不混用 → 飞书云盘不存储文档正文
版本追溯 → 所有修改走 Git 历史
AI 可读 → 保持 .md 标准格式

此规范由游戏策划工作室制定并执行

8.5 KiB Raw Blame History Unescape Escape

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

📁 文档存储架构

纯 Git 工作流（策划文档）

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

🔄 工作流程

新项目启动

Agent 调用记录

📂 Git 目录结构

推荐结构

文档层级说明

🎯 工具使用边界

📝 Git 提交规范

Commit Message 格式

Type 类型

示例

🤖 AI 协作流程

文档编写职责分工

专精 Agent 产出规范

初稿保存位置

命名规范

初稿内容要求

最终稿整合

Git 提交策略

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

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

调用 AI 策划流程

调用限制

📊 飞书多维表格字段

必填字段（16 个）

⚠️ 重要原则

8.5 KiB

Raw Blame History