docs: 更新文档存储架构和初稿管理规范
- 明确专精 agent 初稿保存位置:projects/项目/分类/初稿/ - 规范初稿命名:<agentID>-<内容>-v<版本>.md - 两种 Git 提交策略:只提交最终稿 (推荐) / 提交完整历史 - 更新 .gitignore 配置建议 - 完善 AI 协作流程
This commit is contained in:
132
WORKFLOW.md
132
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/项目名称/分类/初稿/<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
|
||||
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 提交最终稿
|
||||
|
||||
### 调用限制
|
||||
|
||||
|
||||
Reference in New Issue
Block a user