---
name: "design-execution"
description: "执行案编写技能 — 执行案的格式要求、质量标准、写作示例和技术边界红线。当需要"写执行案"、"编写执行案"、"执行案模板"时使用。"
---

# 执行案编写规范

> 执行案是程序实现的核心输入。本技能定义执行案的格式、必填项、质量标准和写作红线。

## 触发条件

- **策划产出执行案时**：game-designer agent 写执行案时自动使用此技能
- **用户手动触发**：用户说"写执行案"、"执行案模板"等

---

## 文件表头（必填）

每个执行案必须以以下格式开头：

```markdown
# <系统名>执行案

## 迭代记录

| 迭代版本 | 修改日期 | 状态 | 说明 |
|----------|----------|------|------|
| v0.1 | YYYY-MM-DD | 📝 设计中 | 初始版本 |

> 状态标记：📝 设计中 | 🔄 开发中 | ✅ 已同步

---

## 系统概述
（描述该系统做什么、服务于什么体验目标）

## 行为规则
（当前最新状态的所有行为规则）
```

---

## 必须包含

1. **迭代记录表头** — 文件顶部，追踪版本变更。
2. **系统概述** — 做什么、服务于什么体验目标。
3. **完整的行为规则** — 每个操作的触发条件 → 表现/响应 → 结束条件。
4. **状态和状态转换** — 系统有哪些状态、什么条件触发状态变化。
5. **边界情况处理** — 异常/极端情况下的系统行为。
6. **跨系统交互** — 与其他系统的关联和影响。

---

## 写作质量标准

**好的示例：**
- ✅ "玩家走近交互物 1.5m 范围内 → 屏幕上方显示交互提示图标（'按 E 交互'）→ 按下 E 键 → 镜头从跟随位置平滑推近到距目标 0.8-1m 处 → 进入交互状态"
- ✅ "弹珠碰撞判定：弹珠完全停止滚动后 1s（建议值，可调，范围 0.5-2s），判定回合结束"

**坏的示例（绝不写这些）：**
- ❌ "创建一个 Sphere Collision 组件做触发器"
- ❌ "用 Widget Blueprint 显示 UI"
- ❌ "大概在这个距离吧，到时候调"
- ❌ "存入 DataTable 中"

---

## 技术边界红线

执行案中绝不包含：
- 具体引擎组件（Blueprint、Widget、Actor、Component 等）
- 代码/脚本架构描述
- 数据存储格式（DataTable、DataAsset、JSON 序列化等）
- 确切的硬编码参数值（标注为"建议值，可调"并附范围）

---

## 模糊语言黑名单

执行案中绝不使用：
- "大概" "也许" "可能" "看情况" "差不多"
- "之类的" "等" "等等"（列表应穷举或明确标注为非完整示例）
- "后续再定" "到时候再说"（必须在当前版本决定或标注"vX.X 后处理"）