Skip to main content

​
📝 策划文档标准模板库

使用说明:
  1. 点击代码块右上角的 “Copy” 按钮。
  2. 新建一个 .md 文件。
  3. 粘贴内容，并替换 [ ] 中的文字。
  4. 不要 删除 “边界情况” (Edge Cases) 章节，如果真的没有，请写 “无”。

​
🏗️ 模板 1: 系统设计文档 (System Design)

适用场景: 新增一个功能模块（如：好友系统、强化系统、每日任务）。 
# 🏗️ [系统名称] 设计文档

## 1. 核心概述 (Overview)
*   **一句话描述**: [这个系统是做什么的？给玩家带来什么核心体验？]
*   **目标用户**: [新手/老手/付费玩家]
*   **解锁条件**: [通关 1-5 / 等级达到 10]

## 2. 详细流程 (Flowchart)
> 使用 Mermaid 画出核心交互流程。

\`\`\`mermaid
graph TD
    A[玩家点击入口] --> B{检查资源}
    B -->|不足| C[弹出获取提示]
    B -->|足够| D[执行强化]
    D --> E[播放特效]
    E --> F[更新属性]
\`\`\`

## 3. 规则细节 (Rules)
### 3.1 基础规则
1.  [规则点 1]
2.  [规则点 2]

### 3.2 资源消耗与产出
*   **消耗**: [金币 x 100]
*   **产出**: [攻击力 + 5]

## 4. 边界情况 (Edge Cases) ⚠️ **CRITICAL**
*   **断网处理**: [操作时断网，扣了钱没加属性怎么办？]
*   **极限数值**: [攻速达到上限时，是否溢出？]
*   **并发操作**: [多端登录同时操作怎么处理？]
*   **资源不足**: [扣除失败的提示文案]

## 5. 数据结构需求 (Data Requirements)
*   **配置表**:
    *   `UpgradeTable`: ID, Cost, StatGain
*   **服务器存储**:
    *   `PlayerProfile`: CurrentLevel (int)

## 6. 美术与音效需求 (Assets)
*   **UI**: [弹窗背景、按钮图标]
*   **VFX**: [强化成功特效、失败特效]
*   **SFX**: [点击音效、成功音效]

​
⚔️ 模板 2: 内容设计文档 (Content Design)

适用场景: 新增一个具体的游戏对象（如：新怪物、新防御塔、新装备）。 
# ⚔️ [内容名称] 设计文档

## 1. 概念设定 (Concept)
*   **名称**: [例如：火焰法师]
*   **定位**: [高伤脆皮 / 远程控制 / 坦克]
*   **视觉参考**: ![Ref](图片链接)

## 2. 基础属性 (Stats)

|          属性          |          初始值          |          成长系数          |          备注          |
|          :---          |          :---          |          :---          |          :---          |
|          生命值          |          100          |          1.2          |                   |
|          移动速度          |          3.5          |          0          |                   |
|          护甲          |          0          |          0          |                   |

## 3. 技能与行为 (Skills & AI)
### 3.1 普攻
*   **描述**: [发射一枚火球]
*   **范围**: [5.0]
*   **冷却**: [1.5s]
*   **伤害**: [100% 攻击力]

### 3.2 被动/特殊技能
*   **触发条件**: [血量低于 30%]
*   **效果**: [进入狂暴状态，攻速 +50%]

### 3.3 AI 行为树逻辑
*   **优先目标**: [距离最近的单位 / 血量最低的单位]
*   **寻路逻辑**: [地面行走 / 飞行]

## 4. 资源需求 (Assets)
*   **模型**: [FireMage.fbx]
*   **动作**: [Idle, Run, Attack, Die]
*   **特效**: [Fireball_Projectile, Hit_VFX]
*   **音效**: [Attack_Voice, Die_Voice]

​
🎨 模板 3: UI/UX 设计文档 (UI Design)

适用场景: 新增一个界面或交互流程。 
# 🎨 [界面名称] 交互设计

## 1. 界面层级 (Hierarchy)
*   **父级**: [主界面 / 战斗界面]
*   **层级**: [弹窗层 (Popup) / 顶层 (Top)]

## 2. 布局示意 (Wireframe)
> 在这里放一张草图或 Figma 截图。

![Wireframe](图片链接)

## 3. 交互逻辑 (Interaction)
### 3.1 状态流转
*   **打开方式**: [点击主界面按钮]
*   **关闭方式**: [点击右上角 X / 点击背景遮罩]
*   **刷新机制**: [打开时刷新 / 实时监听数据变化]

### 3.2 控件列表

|          控件ID          |          类型          |          功能描述          |          点击反馈          |
|          :---          |          :---          |          :---          |          :---          |
|          `btn_upgrade`          |          按钮          |          执行强化          |          播放点击音效，发送请求          |
|          `txt_gold`          |          文本          |          显示金币          |          无          |
|          `img_icon`          |          图片          |          显示装备图标          |          长按显示详情          |

## 4. 表现细节 (Polish)
*   **入场动画**: [弹窗从中心缩放弹出 (Scale 0->1, Elastic)]
*   **音效**: [Popup_Open.wav]
*   **本地化**: [所有文本需支持多语言 Key]