tcg-engines
为多款TCG（集换式卡牌）游戏提供开源引擎与模拟器开发套件。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：tcg-engines。 它的用途是：为多款TCG（集换式卡牌）游戏提供开源引擎与模拟器开发套件。 完整的 Skill 内容见：https://321skill.com/skills/tcg-engines/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我想为《洛卡纳》游戏开发一个测试AI对战策略的模拟环境。”，它会引导你克隆此仓库，进入 `submodules/lorcana` 目录安装依赖，并利用其中的模拟器工具和测试框架来构建你的AI策略测试流程。或者，
对AI说：“我需要理解TCG游戏中‘抽牌’和‘费用’规则的通用实现方式。”，它会建议你查看 `submodules/agnostic-simulator` 中的共享协议和合约代码，以了解跨游戏的核心机制设计。
介绍
TCG Engines 是一个开源项目，旨在为《洛卡纳》、《赛博朋克》、《高达》、《海贼王》等多款集换式卡牌游戏提供核心的游戏规则引擎、卡牌定义、模拟器以及配套的开发工具。它解决了开发者需要为不同TCG游戏重复构建底层逻辑和测试环境的问题，提供了一个统一、可复用的技术框架。
开发者可以通过克隆仓库，进入特定的游戏子模块（如 submodules/lorcana）进行开发。项目采用 pnpm workspace 管理，每个子模块独立，需要分别安装依赖并运行对应的构建和验证脚本。这允许开发者专注于单一游戏的规则实现或适配器开发，而无需关心其他模块。
该技能包主要适合游戏后端开发、全栈开发以及智能体开发人员，特别是那些需要为特定TCG游戏开发AI对战、规则验证、卡牌效果模拟或构建自动化测试工具的技术人员。对于希望研究或贡献于TCG游戏核心逻辑的开源爱好者也很有价值。
使用前请确保环境符合要求（Node.js 24.x, pnpm 10.33.x等）。由于生产环境服务（如匹配、用户系统）是私有的，此仓库仅包含公共的引擎和模拟器部分，适合进行非商业性的规则扩展、卡牌添加、AI策略开发及工具链改进。
核心特点
与单一游戏模拟器不同，它提供了一个跨游戏的“通用模拟器协议”（agnostic-simulator），允许在不同TCG游戏间共享模拟器合约和UI组件，并集中管理了多款热门IP（洛卡纳、赛博朋克等）的官方级规则实现。
注意事项
不包含任何线上服务、用户账户、匹配系统或部署配置，仅适用于引擎规则开发、模拟测试和工具链构建，无法直接部署为可运营的线上游戏服务器。
常见问题
我能用这个仓库来搭建一个在线的卡牌游戏网站吗？
不能。此仓库仅包含游戏规则引擎和模拟器，缺少服务器、网关、用户认证、匹配等线上服务所需的后端组件，这些是私有的。
如何为《洛卡纳》添加一张新卡牌？
在 `submodules/lorcana` 工作区内，按照现有卡牌的定义格式编写新卡牌的JSON或代码文件，然后运行 `pnpm run ci:lorcana:check` 进行验证。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/tcg-engines/raw/index.md 读取 tcg-engines 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/tcg-engines/raw/index.md（查看排版版本）