Instruction file imported from xiaoxin1358/shockcard (.github/instructions/shockcard-gameplay.instructions.md). Copyright stays with the author.

Shockcard Instructions

Name: Shockcard Gameplay Preferences
Author: xiaoxin1358

项目目标

本项目是一个 2D 横版物理冲刺 Demo，优先目标是：

快速实现可玩版本（MVP）
验证核心玩法（拖拽施力 + 撞击 + 扑克结算）
保持代码简单、可维护、适合单人开发

禁止过度设计，不追求完美架构。

AI 行为规范

你是一个协助开发的 AI agent，请遵守以下规则。

允许行为

可以补充必要的小函数或工具方法
可以添加合理默认参数
可以修复明显 bug
可以优化局部代码可读性
可以补充最小必要的注释

禁止行为

不要重构整个系统结构
不要随意修改已有类的职责
不要引入复杂架构（如事件总线、DI 容器、状态机框架）
不要创建多余抽象层
不要拆分过多文件
不要改变已有命名风格
不要为了“更优雅”而增加复杂度

开发原则

MVP 优先

先实现能跑
再优化好玩
最后考虑好看

单一职责（但不过度）

每个脚本做一件事
但不要拆得过细

可测试优先

每个功能都必须可以单独运行验证
不依赖未完成系统

可读性优先

代码必须清晰
避免过度抽象
优先直观实现

当前项目架构约束

核心系统

Player（拖拽施力 + 运动）
Energy（能量系统）
Enemy（碰到即死）
Card（收集 + 结算）
Boss（血量 + 阶段）
Obstacle（木板 / 石板）
MapReset（地图重置）
HUD（UI 显示）

系统边界

Player 只负责移动和碰撞
Enemy 只负责死亡和掉牌
CardManager 负责卡牌逻辑
Boss 不负责地图重置
MapResetManager 负责刷新地图
HUD 只负责显示，不处理逻辑

实现规则

输入系统

使用鼠标拖拽施加加速度
拖拽长度映射力度

物理规则

玩家有速度衰减
撞击后保留动能
速度影响伤害

能量系统

消耗与加速度成正比
能量为 0 无法施力

战斗规则

敌人碰到即死
障碍物根据速度判断是否破坏

卡牌系统

敌人掉牌
自动收集
5 张自动结算
自动判定最优牌型

Boss 规则

每 25% 血量切换阶段
阶段触发地图重置

可视化规范

在没有美术资源时，使用简单几何图形：

Player：圆形
Enemy：方块 + 文本
木板：棕色矩形
石板：灰色矩形
Boss：红色

禁止等待贴图资源。

输出要求

每次输出代码时必须：

提供完整可运行代码。
指明挂载到哪个节点、需要哪些子节点、需要配置哪些参数。
不省略关键逻辑。
不输出伪代码。
不只写片段。

工作方式

每次只实现一个模块：

不要一次实现整个系统
按阶段推进
每一步必须可运行

信息不完整时

不要提问
直接选择最简单合理实现
优先保证功能可运行

风格要求

简单 > 优雅
直接 > 抽象
可跑 > 完美

{ "ocm": "1", "id": "xiaoxin1358-shockcard-shockcard-gameplay-instructions", "kind": "skill", "name": "Shockcard Gameplay Preferences", "description": "Use when implementing or modifying Shockcard gameplay systems, architecture boundaries, and code generation behavior in this repository.", "publisher": "xiaoxin1358", "version": "1.0.0", "capabilities": { "domains": [ "coding" ], "tags": [ "skill-md", "github-instructions" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Use when implementing or modifying Shockcard gameplay systems, architecture boundaries, and code generation behavior in this repository." ], "primary": false, "metadata": { "source": { "provider": "github-instructions", "repository": "https://github.com/xiaoxin1358/shockcard", "path": ".github/instructions/shockcard-gameplay.instructions.md", "ref": "e28a782f3735f12f874d8e44831a87e063e64a73", "url": "https://github.com/xiaoxin1358/shockcard/blob/e28a782f3735f12f874d8e44831a87e063e64a73/.github/instructions/shockcard-gameplay.instructions.md", "key": "xiaoxin1358/shockcard/.github/instructions/shockcard-gameplay.instructions.md" }, "applies_to": "**" }, "instructions": "# Shockcard Instructions\n\n## 项目目标\n\n本项目是一个 2D 横版物理冲刺 Demo，优先目标是：\n\n- 快速实现可玩版本（MVP）\n- 验证核心玩法（拖拽施力 + 撞击 + 扑克结算）\n- 保持代码简单、可维护、适合单人开发\n\n禁止过度设计，不追求完美架构。\n\n## AI 行为规范\n\n你是一个协助开发的 AI agent，请遵守以下规则。\n\n### 允许行为\n\n- 可以补充必要的小函数或工具方法\n- 可以添加合理默认参数\n- 可以修复明显 bug\n- 可以优化局部代码可读性\n- 可以补充最小必要的注释\n\n### 禁止行为\n\n- 不要重构整个系统结构\n- 不要随意修改已有类的职责\n- 不要引入复杂架构（如事件总线、DI 容器、状态机框架）\n- 不要创建多余抽象层\n- 不要拆分过多文件\n- 不要改变已有命名风格\n- 不要为了“更优雅”而增加复杂度\n\n## 开发原则\n\n### MVP 优先\n\n- 先实现能跑\n- 再优化好玩\n- 最后考虑好看\n\n### 单一职责（但不过度）\n\n- 每个脚本做一件事\n- 但不要拆得过细\n\n### 可测试优先\n\n- 每个功能都必须可以单独运行验证\n- 不依赖未完成系统\n\n### 可读性优先\n\n- 代码必须清晰\n- 避免过度抽象\n- 优先直观实现\n\n## 当前项目架构约束\n\n### 核心系统\n\n- Player（拖拽施力 + 运动）", "cost": { "context_tokens": 354 } }

Shockcard Gameplay Preferences

About