docs: 新增工作流程规范

- 明确文档存储架构：纯 Git 工作流 - Agent 沟通记录：飞书多维表格 - 规定 Git 提交规范 - 定义 AI 协作流程和调用限制 - 记录多维表格 16 个必填字段
2026-03-19 02:53:10 +08:00
parent ba503055b3
commit 54ace8dfa7
1 changed files with 192 additions and 0 deletions
--- a/WORKFLOW.md
+++ b/WORKFLOW.md
@@ -0,0 +1,192 @@
+# 游戏策划工作室 - 工作流程规范
+
+**最后更新：** 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 标准格式
+
+---
+
+*此规范由游戏策划工作室制定并执行*