docs: 更新文档存储架构和初稿管理规范

- 明确专精 agent 初稿保存位置:projects/项目/分类/初稿/
- 规范初稿命名:<agentID>-<内容>-v<版本>.md
- 两种 Git 提交策略:只提交最终稿 (推荐) / 提交完整历史
- 更新 .gitignore 配置建议
- 完善 AI 协作流程
This commit is contained in:
Game Director
2026-03-19 03:31:25 +08:00
parent e6f7191f7b
commit 5ec384c414

View File

@@ -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 提交最终稿
### 调用限制 ### 调用限制