diff --git a/README.md b/README.md new file mode 100644 index 0000000..920ec0c --- /dev/null +++ b/README.md @@ -0,0 +1,226 @@ +# 游戏策划文档模板库 + +> 专业、全面、AI 友好的游戏策划文档模板集合 + +**版本:** v1.0 +**最后更新:** 2026-03-18 +**维护团队:** 游戏策划工作室 + +--- + +## 📖 简介 + +本模板库提供 **11 个专业游戏策划文档模板**,覆盖游戏设计的全流程: + +- ✅ 系统设计类(关卡、UI/UX、战斗、技能) +- ✅ 数值经济类(数值设计、经济系统) +- ✅ 叙事内容类(世界观、角色、剧情) +- ✅ 商业化运营类(商业化设计、活动策划) + +所有模板采用 **标准 Markdown 格式**,AI agent 可直接读取和处理,同时适合人类策划人员使用。 + +--- + +## 📁 模板清单 + +| # | 模板名称 | 文件 | 适用场景 | +|---|----------|------|----------| +| 1 | 关卡设计文档 | `【模板】关卡设计文档.md` | 关卡/副本/地图设计 | +| 2 | UI/UX 设计文档 | `【模板】UIUX 设计文档.md` | 界面/交互/视觉规范 | +| 3 | 数值设计文档 | `【模板】数值设计文档.md` | 属性/成长/战斗公式 | +| 4 | 经济系统设计文档 | `【模板】经济系统设计文档.md` | 货币/资源/付费点 | +| 5 | 战斗系统设计文档 | `【模板】战斗系统设计文档.md` | 战斗机制/AI/规则 | +| 6 | 技能设计文档 | `【模板】技能设计文档.md` | 技能/天赋/Buff | +| 7 | 世界观设定文档 | `【模板】世界观设定文档.md` | 世界背景/地理/势力 | +| 8 | 角色设定文档 | `【模板】角色设定文档.md` | 角色档案/性格/关系 | +| 9 | 剧情大纲文档 | `【模板】剧情大纲文档.md` | 主线/支线/对话 | +| 10 | 商业化设计文档 | `【模板】商业化设计文档.md` | 付费点/定价/分层 | +| 11 | 活动策划文档 | `【模板】活动策划文档.md` | 运营活动/排期/评估 | + +--- + +## 🚀 快速开始 + +### 1. 克隆仓库 + +```bash +git clone http://git.joywaygames.cn:3000/basegames/gamedesign-docs-templates.git +cd gamedesign-docs-templates +``` + +### 2. 选择模板 + +根据设计需求选择对应模板: + +```bash +# 示例:创建新关卡设计文档 +cp templates/【模板】关卡设计文档.md projects/我的项目/关卡 01 设计.md +``` + +### 3. 填充内容 + +打开模板文件,替换 `[占位符]` 为实际内容: + +```markdown +# 【项目 -XXX】关卡设计文档 + +**关卡名称:** 第一章 - 初出茅庐 ← 替换 +**所属项目:** 我的游戏项目 ← 替换 +**关卡类型:** 主线关卡 ← 选择 +... +``` + +### 4. 提交文档 + +```bash +git add projects/我的项目/关卡 01 设计.md +git commit -m "feat: 新增第一章关卡设计文档" +git push +``` + +--- + +## 📋 模板结构说明 + +每个模板包含以下核心模块: + +### 基础信息 +- 文档元数据(名称、版本、负责人) +- 设计目标与原则 +- 前置条件/适用范围 + +### 核心设计 +- 详细设计内容(因模板类型而异) +- 表格、流程图、公式 +- 配置参数与规则 + +### 验证与测试 +- 设计验证清单 +- 测试要点 +- 平衡性检查 + +### 变更记录 +- 版本历史 +- 修改记录 + +--- + +## 🎯 使用规范 + +### 文档命名 + +| 类型 | 命名格式 | 示例 | +|------|----------|------| +| 模板 | `【模板】XXX 文档.md` | `【模板】关卡设计文档.md` | +| 项目文档 | `【项目-XXX】XXX 文档.md` | `【项目 - 原神】关卡设计.md` | +| 竞品分析 | `【竞品分析】游戏名 - 内容.md` | `【竞品分析】原神 - 核心玩法.md` | + +### 版本管理 + +- **主版本 (v1.0)** - 重大修改 +- **次版本 (v1.1)** - 内容增补 +- **修订版 (v1.1.1)** - 错别字/格式修正 + +### 填写规范 + +1. **占位符** - `[填写内容]` 必须替换 +2. **可选内容** - `[可选]` 根据需求选择 +3. **表格** - 保持格式对齐 +4. **公式** - 使用代码块包裹 + +--- + +## 🤖 AI 协作 + +### AI 可读格式 + +模板采用标准 Markdown,AI agent 可直接读取: + +```bash +# AI 读取示例 +ai-agent read templates/【模板】关卡设计文档.md +ai-agent generate --template=关卡设计 --game=我的游戏 +``` + +### 与 AI 策划配合 + +1. **任务下发** - 将模板发送给 AI 策划 agent +2. **内容生成** - AI 填充初稿 +3. **人工审核** - 策划审核调整 +4. **版本提交** - 提交到 Git 仓库 + +--- + +## 📁 推荐目录结构 + +``` +gamedesign-docs-templates/ +├── templates/ # 模板文件(本仓库) +├── projects/ # 项目文档 +│ ├── 项目 A/ +│ │ ├── 系统设计/ +│ │ ├── 数值设计/ +│ │ └── 剧情设计/ +│ └── 项目 B/ +├── competitive-analysis/ # 竞品分析 +├── standards/ # 规范标准 +└── README.md +``` + +--- + +## 🔄 更新流程 + +### 模板更新 + +1. **提出修改** - 在对应模板文件修改 +2. **测试验证** - 用实际项目验证模板 +3. **提交审核** - 提交 PR 或直接 commit +4. **版本升级** - 更新版本号 + +### 新增模板 + +1. **创建文件** - `templates/【模板】新模板.md` +2. **更新清单** - 在 README.md 添加记录 +3. **提交审核** - 团队审核后合并 + +--- + +## 📊 统计信息 + +| 指标 | 数值 | +|------|------| +| 模板数量 | 11 个 | +| 总行数 | 3766 行 | +| 覆盖领域 | 5 大类 | +| 文件格式 | Markdown (.md) | + +--- + +## 📝 变更日志 + +### v1.0 (2026-03-18) + +**初始化版本** +- ✅ 新增 11 个专业策划模板 +- ✅ 覆盖系统设计、数值、战斗、叙事、商业化 +- ✅ AI 友好格式,标准 Markdown +- ✅ Git 版本管理配置 + +--- + +## 📞 反馈与支持 + +- **问题反馈:** 在 Git 仓库提交 Issue +- **模板建议:** 联系游戏策划工作室 +- **文档链接:** [Git 仓库](http://git.joywaygames.cn:3000/basegames/gamedesign-docs-templates) + +--- + +## 📄 许可证 + +本模板库仅供内部使用,未经许可不得外传。 + +--- + +*文档由游戏策划工作室自动生成和维护*