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 目录结构
|
## 📂 Git 目录结构
|
||||||
|
|
||||||
|
### 推荐结构
|
||||||
|
|
||||||
```
|
```
|
||||||
gamedesign-docs-templates/
|
gamedesign-docs-templates/
|
||||||
├── templates/ # 模板文件(只读,不常改)
|
├── templates/ # 模板文件(只读,不常改)
|
||||||
│ ├── 【模板】关卡设计文档.md
|
│ ├── 【模板】关卡设计文档.md
|
||||||
│ ├── 【模板】UIUX 设计文档.md
|
│ ├── 【模板】UIUX 设计文档.md
|
||||||
│ └── ...
|
│ └── ...
|
||||||
├── projects/ # 项目文档
|
├── projects/ # 项目文档
|
||||||
│ ├── 项目 A/
|
│ └── 项目名称/
|
||||||
│ │ ├── 系统设计/
|
│ ├── 系统设计/
|
||||||
│ │ ├── 数值设计/
|
│ │ ├── 初稿/ # 专精 agent 产出(可选提交)
|
||||||
│ │ └── ...
|
│ │ │ ├── system-designer-xxx-v1.md
|
||||||
│ └── 项目 B/
|
│ │ │ └── numerics-designer-xxx-v1.md
|
||||||
├── competitive-analysis/ # 竞品分析
|
│ │ └── XXX 系统设计文档.md ← 最终稿(必须提交)
|
||||||
├── standards/ # 规范标准
|
│ ├── 数值设计/
|
||||||
|
│ │ ├── 初稿/
|
||||||
|
│ │ └── XXX 数值设计文档.md
|
||||||
|
│ ├── 战斗设计/
|
||||||
|
│ ├── 叙事设计/
|
||||||
|
│ └── ...
|
||||||
|
├── competitive-analysis/ # 竞品分析
|
||||||
|
├── standards/ # 规范标准
|
||||||
|
├── drafts/ # 临时草稿(不提交)
|
||||||
└── README.md
|
└── 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 策划流程
|
### 调用 AI 策划流程
|
||||||
|
|
||||||
```
|
```
|
||||||
1. 策划总监分析需求,选择模板
|
1. 策划总监分析需求,选择模板
|
||||||
↓
|
↓
|
||||||
2. 调用专精 agent A → 输出初稿 A
|
2. 调用专精 agent A → 输出初稿 A → 保存到初稿/
|
||||||
↓
|
↓
|
||||||
3. 调用专精 agent B → 输出初稿 B
|
3. 调用专精 agent B → 输出初稿 B → 保存到初稿/
|
||||||
↓
|
↓
|
||||||
4. 策划总监整合初稿 → 完整文档
|
4. 策划总监整合初稿 → 完整文档
|
||||||
↓
|
↓
|
||||||
@@ -168,7 +271,7 @@ git commit -m "fix: 修正战斗公式计算错误"
|
|||||||
↓
|
↓
|
||||||
6. 记录调用到飞书多维表格
|
6. 记录调用到飞书多维表格
|
||||||
↓
|
↓
|
||||||
7. 策划总监提交 Git
|
7. 策划总监提交 Git(最终稿)
|
||||||
↓
|
↓
|
||||||
8. 返回用户最终文档
|
8. 返回用户最终文档
|
||||||
```
|
```
|
||||||
@@ -177,8 +280,9 @@ git commit -m "fix: 修正战斗公式计算错误"
|
|||||||
2. **下发任务** - 发送模板 + 需求给 AI agent
|
2. **下发任务** - 发送模板 + 需求给 AI agent
|
||||||
3. **记录调用** - 填写飞书多维表格
|
3. **记录调用** - 填写飞书多维表格
|
||||||
4. **接收产出** - AI 返回 .md 格式文档
|
4. **接收产出** - AI 返回 .md 格式文档
|
||||||
5. **审核整合** - 策划总监审核调整
|
5. **保存初稿** - 保存到 `初稿/` 文件夹
|
||||||
6. **提交归档** - 策划总监 Git 提交
|
6. **审核整合** - 策划总监审核调整
|
||||||
|
7. **提交归档** - 策划总监 Git 提交最终稿
|
||||||
|
|
||||||
### 调用限制
|
### 调用限制
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user