refactor(skills): Agent架构重构——去阶段/去步骤号/审查纯Issue化/工作流拆技能/目录扁平化
- game-reviewer: 删除本地审查记录,仅Issue评论 - quality-gate-review: 删除审查记录/步骤号/阶段标准 - game-dev: 删除阶段感知节,4个工作流详情拆到技能 - game-designer: 删除原型/批量生产阶段,执行案规范拆到技能 - game-pm: 去掉节号和步骤号 - 全局去掉步骤标号(①-⑧/步骤1-5/1.4.X/第一步-第四步) - 新建技能: code-implementation/deviation-report/design-execution - 原型目录扁平化: docs/design/prototype/* → docs/design/ - requirements-analysis及子文件去步骤号和阶段引用 - stage-iteration/sketch/roadmap去任务编号 - 更新所有docs/design/路径引用
This commit is contained in:
@@ -0,0 +1,83 @@
|
||||
---
|
||||
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 后处理")
|
||||
Reference in New Issue
Block a user