54ace8dfa7
- 明确文档存储架构：纯 Git 工作流 - Agent 沟通记录：飞书多维表格 - 规定 Git 提交规范 - 定义 AI 协作流程和调用限制 - 记录多维表格 16 个必填字段
193 lines
4.6 KiB
Markdown
193 lines
4.6 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/ # 项目文档
|
||
│ ├── 项目 A/
|
||
│ │ ├── 系统设计/
|
||
│ │ ├── 数值设计/
|
||
│ │ └── ...
|
||
│ └── 项目 B/
|
||
├── competitive-analysis/ # 竞品分析
|
||
├── standards/ # 规范标准
|
||
└── README.md
|
||
```
|
||
|
||
---
|
||
|
||
## 🎯 工具使用边界
|
||
|
||
| 工具 | 用途 | 不用于 |
|
||
|------|------|--------|
|
||
| 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 协作流程
|
||
|
||
### 调用 AI 策划
|
||
|
||
1. **选择模板** - 根据需求选择对应模板
|
||
2. **下发任务** - 发送模板 + 需求给 AI agent
|
||
3. **记录调用** - 填写飞书多维表格
|
||
4. **接收产出** - AI 返回 .md 格式文档
|
||
5. **审核整合** - 人工审核调整
|
||
6. **提交归档** - 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 标准格式
|
||
|
||
---
|
||
|
||
*此规范由游戏策划工作室制定并执行*
|