convez.ai
AgenteUtilidadesAvançado
aliuguofa

CCGame - Plataforma de Jogos com IA

aliuguofa/CCGame

Jogue contra IA direto no Claude Code, sem instalações extras

Ver no GitHub
InicialPluginScore · de 0 a 100

Plataforma de jogos baseada em Claude Code onde você enfrenta agentes IA em turnos. Suporta jogos de cartas, estratégia e texto com motor de regras determinístico em TypeScript. Extensível via módulos de jogo independentes.

Instalação

$npx convez-ai aliuguofa/CCGame

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Desenvolvimento de jogos multiplayer com IA
  • Prototipagem rápida de mecânicas de turnos
  • Testes de estratégia com agentes persistentes

Veredito

Projeto ambicioso que combina game engine determinístico com agentes Claude persistentes. Arquitetura bem pensada (isolamento de informação, validação de regras, reprodutibilidade), mas ainda em estágio inicial com apenas um jogo implementado (Dou Dizhu). Ideal para quem quer explorar integração profunda entre IA e lógica de jogo estruturada.

README

A tradução para o português deste README ainda está na fila.

CCGame

基于 Claude Code 的 AI 游戏平台。在 Claude Code 会话中直接与 AI Agent 对战。

我们希望有更多开发者加入,共同丰富这个平台的游戏库。无论是棋牌、策略还是文字冒险,只要能用回合制表达,就能跑在 CCGame 上。

特点

  • 即开即玩 — 输入 /start doudizhu 直接开局,无需额外安装
  • AI 对手有性格 — 每个 AI 玩家有独立人设和连贯策略
  • 公平对战 — 确定性规则引擎保证公正,AI 看不到你的手牌
  • 可扩展 — 新游戏放入 games/ 目录即可接入,无需注册
  • 测试友好 — vitest 单元测试 + seed 洗牌,任何局面可复现

可用游戏

游戏人数命令状态
斗地主3人 (1v2)/start doudizhu✅ 可玩
???--等你贡献

快速开始

前置条件

  • Node.js >= 18
  • Claude Code CLI
  • 环境变量 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

安装

npm install

开始游戏

# 在 Claude Code 中
/start              # 查看游戏列表
/start doudizhu     # 开始一局斗地主

架构

玩家 ←→ Claude (裁判) ←→ 常驻 Agent (AI 对手)
              ↕                    ↑
        规则引擎 (TypeScript)      SendMessage 续接
  • Claude 担任游戏主持人,驱动回合流程
  • TypeScript 规则引擎处理所有确定性计算(洗牌、验证、判胜负)
  • 每个 AI 对手是常驻的 sub-agent,游戏开始时初始化,全程保持完整上下文
  • 通过 SendMessage 与 AI agent 交互,agent 自然积累对局记忆

项目结构

games/              游戏模块目录
  doudizhu/         斗地主
runtime/            运行时数据(游戏存档、AI思维链)
docs/               文档
.claude/            Claude Code skills 和 commands
openspec/           规范和变更管理

贡献新游戏

欢迎贡献!添加一个新游戏只需三步:

1. 创建游戏目录

games/your-game/
  engine.ts         规则引擎 CLI 入口
  state.ts          类型定义
  rules.ts          核心规则逻辑
  deck.ts           初始化逻辑(发牌/建局)
  render.ts         渲染逻辑
  agents.ts         AI prompt 生成
  meta.json         游戏元信息
  personalities/    AI 性格文件(.md)
  __tests__/        单元测试

2. 实现标准 CLI 接口

engine.ts 需要响应以下子命令(stdin/stdout JSON 协议):

npx tsx games/your-game/engine.ts setup          # 初始化游戏状态
npx tsx games/your-game/engine.ts validate       # 验证动作合法性
npx tsx games/your-game/engine.ts apply          # 执行动作,返回新状态
npx tsx games/your-game/engine.ts render         # 渲染当前局面
npx tsx games/your-game/engine.ts status         # 查询游戏状态(是否结束)
npx tsx games/your-game/engine.ts init-prompt    # 生成 AI agent 初始化 prompt
npx tsx games/your-game/engine.ts turn-prompt    # 生成每轮增量 prompt
npx tsx games/your-game/engine.ts agent-prompt   # 生成 AI 完整 prompt(恢复用)
npx tsx games/your-game/engine.ts get-fallback   # AI 决策失败时的兜底动作

3. 添加测试

npm test    # 用 vitest 跑所有游戏的测试

建议提供 seed 参数支持可复现洗牌/初始化,并编写确定性测试 AI 用于集成测试。

设计原则

  • 规则引擎必须确定性 — 所有游戏逻辑在 TypeScript 中实现,不依赖 LLM 判断
  • 信息隔离 — AI prompt 中只包含该玩家能看到的信息
  • apply() 契约 — 内部强制 validate,非法动作抛异常
  • 状态不可变 — apply 返回新状态(structuredClone),不修改原状态

游戏灵感

以下是一些适合本平台的游戏类型:

  • 🃏 牌类 — 德州扑克、UNO、跑得快、升级
  • ♟️ 棋类 — 五子棋、黑白棋、简化象棋
  • 🎲 骰子/策略 — 大话骰、Yahtzee
  • 📖 文字 — Wordle、成语接龙、20 Questions
  • 🗡️ 冒险 — 文字 RPG、地下城探索

选择你感兴趣的,或者发明全新的玩法。

开发

npm test            # 运行测试
npx tsc --noEmit    # 类型检查

自动化测试

支持使用 Codex 多 Agent 架构进行端到端自动化测试。主 Agent 调度两个子 Agent:PTY Keeper 以高权限启动 PTY daemon,Game Agent 通过 ptyctl 连接 daemon 并驱动完整游戏流程。

详见 Codex 自动化测试指南。

技术栈

  • TypeScript / Node.js (ESM)
  • Vitest(测试)
  • Claude Code (Skill/Command)
  • Claude Agent Teams (SendMessage 常驻 agent)

License

MIT

Ver o original no GitHub

Bom para

Relacionados