5ec384c414
- 明确专精 agent 初稿保存位置：projects/项目/分类/初稿/ - 规范初稿命名：<agentID>-<内容>-v<版本>.md - 两种 Git 提交策略：只提交最终稿 (推荐) / 提交完整历史 - 更新 .gitignore 配置建议 - 完善 AI 协作流程
333 lines
8.5 KiB
Markdown
333 lines
8.5 KiB
Markdown
# 游戏策划工作室 - 工作流程规范
|
||
|
||
**最后更新：** 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 目录结构
|
||
|
||
### 推荐结构
|
||
|
||
```
|
||
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` |
|
||
|
||
### 示例
|
||
|
||
```bash
|
||
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
|
||
```
|
||
|
||
**提交流程：**
|
||
```bash
|
||
# 策划总监整合后提交最终稿
|
||
git add projects/项目名/系统设计/公会系统设计文档.md
|
||
git commit -m "feat: 新增公会系统设计文档"
|
||
git push
|
||
```
|
||
|
||
**优点：**
|
||
- 仓库简洁
|
||
- 只保留最终版本
|
||
- 减少文件大小
|
||
|
||
#### 方案 B：提交完整历史（可选）
|
||
|
||
**提交流程：**
|
||
```bash
|
||
# 提交初稿 + 最终稿
|
||
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. 返回用户最终文档
|
||
```
|
||
|
||
1. **选择模板** - 根据需求选择对应模板
|
||
2. **下发任务** - 发送模板 + 需求给 AI agent
|
||
3. **记录调用** - 填写飞书多维表格
|
||
4. **接收产出** - AI 返回 .md 格式文档
|
||
5. **保存初稿** - 保存到 `初稿/` 文件夹
|
||
6. **审核整合** - 策划总监审核调整
|
||
7. **提交归档** - 策划总监 Git 提交最终稿
|
||
|
||
### 调用限制
|
||
|
||
| 限制项 | 值 | 说明 |
|
||
|--------|-----|------|
|
||
| 每个 agent 调用次数 | ≤2 次 | 允许一次追问 |
|
||
| 单次任务总调用 | ≤5 次 | 所有 agent 合计 |
|
||
| 超时时间 | 600 秒 | 10 分钟 |
|
||
|
||
---
|
||
|
||
## 📊 飞书多维表格字段
|
||
|
||
**表格链接：** https://basegames.feishu.cn/base/Joc4bhUqEa6wJdsmevFc9YVhnH0
|
||
|
||
### 必填字段（16 个）
|
||
|
||
1. 调用时间
|
||
2. 调用方
|
||
3. 被调用方
|
||
4. 任务类型
|
||
5. 会话 ID
|
||
6. 任务下发时间
|
||
7. 任务下发内容
|
||
8. 回复时间
|
||
9. 回复完整内容
|
||
10. 返回结果摘要
|
||
11. 耗时 (秒)
|
||
12. 追问记录
|
||
13. 时间线
|
||
14. 关联文档
|
||
15. 调用轮次
|
||
16. 状态
|
||
|
||
---
|
||
|
||
## ⚠️ 重要原则
|
||
|
||
1. **文档正文** → 只用 Git 管理 (.md)
|
||
2. **沟通记录** → 只用飞书多维表格
|
||
3. **不混用** → 飞书云盘不存储文档正文
|
||
4. **版本追溯** → 所有修改走 Git 历史
|
||
5. **AI 可读** → 保持 .md 标准格式
|
||
|
||
---
|
||
|
||
*此规范由游戏策划工作室制定并执行*
|