From 5ec384c414e9d52f941f4ea92704c5ed28c01530 Mon Sep 17 00:00:00 2001 From: Game Director Date: Thu, 19 Mar 2026 03:31:25 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E5=AD=98=E5=82=A8=E6=9E=B6=E6=9E=84=E5=92=8C=E5=88=9D=E7=A8=BF?= =?UTF-8?q?=E7=AE=A1=E7=90=86=E8=A7=84=E8=8C=83?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 明确专精 agent 初稿保存位置：projects/项目/分类/初稿/ - 规范初稿命名：-<内容>-v<版本>.md - 两种 Git 提交策略：只提交最终稿 (推荐) / 提交完整历史 - 更新 .gitignore 配置建议 - 完善 AI 协作流程 --- WORKFLOW.md | 132 ++++++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 118 insertions(+), 14 deletions(-) diff --git a/WORKFLOW.md b/WORKFLOW.md index fcb4c87..3cd9a52 100644 --- a/WORKFLOW.md +++ b/WORKFLOW.md @@ -73,23 +73,41 @@ ## 📂 Git 目录结构 +### 推荐结构 + ``` gamedesign-docs-templates/ -├── templates/ # 模板文件（只读，不常改） +├── templates/ # 模板文件（只读，不常改） │ ├── 【模板】关卡设计文档.md │ ├── 【模板】UIUX 设计文档.md │ └── ... -├── projects/ # 项目文档 -│ ├── 项目 A/ -│ │ ├── 系统设计/ -│ │ ├── 数值设计/ -│ │ └── ... -│ └── 项目 B/ -├── competitive-analysis/ # 竞品分析 -├── standards/ # 规范标准 +├── 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/` | 工作过程文件 | ❌ 不提交 | + --- ## 🎯 工具使用边界 @@ -153,14 +171,99 @@ git commit -m "fix: 修正战斗公式计算错误" - ✅ 策划总监统一审核、整合、提交 - ✅ 用户只对接策划总监一人 +### 专精 Agent 产出规范 + +#### 初稿保存位置 + +``` +projects/项目名称/分类/初稿/-<内容>-v<版本>.md + +示例： +- projects/原神/系统设计/初稿/system-designer-公会系统 -v1.md +- projects/原神/数值设计/初稿/numerics-designer-经济数值 -v1.md +``` + +#### 命名规范 + +``` +-<内容简述>-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 +2. 调用专精 agent A → 输出初稿 A → 保存到初稿/ ↓ -3. 调用专精 agent B → 输出初稿 B +3. 调用专精 agent B → 输出初稿 B → 保存到初稿/ ↓ 4. 策划总监整合初稿 → 完整文档 ↓ @@ -168,7 +271,7 @@ git commit -m "fix: 修正战斗公式计算错误" ↓ 6. 记录调用到飞书多维表格 ↓ -7. 策划总监提交 Git +7. 策划总监提交 Git（最终稿） ↓ 8. 返回用户最终文档 ``` @@ -177,8 +280,9 @@ git commit -m "fix: 修正战斗公式计算错误" 2. **下发任务** - 发送模板 + 需求给 AI agent 3. **记录调用** - 填写飞书多维表格 4. **接收产出** - AI 返回 .md 格式文档 -5. **审核整合** - 策划总监审核调整 -6. **提交归档** - 策划总监 Git 提交 +5. **保存初稿** - 保存到 `初稿/` 文件夹 +6. **审核整合** - 策划总监审核调整 +7. **提交归档** - 策划总监 Git 提交最终稿 ### 调用限制