diff --git a/WORKFLOW.md b/WORKFLOW.md new file mode 100644 index 0000000..795609e --- /dev/null +++ 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 格式 + +``` +: + +[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 标准格式 + +--- + +*此规范由游戏策划工作室制定并执行*