游戏开发技能库

面向真实游戏开发流程的 AI Agent 技能库。

这不是提示词合集，而是一组可安装、可组合的 SKILL.md。目标是把游戏项目中的稳定工作方式沉淀为 Agent 可执行流程：先澄清玩法，再形成文档；先做可验证的功能拆分/细分，再实现；先复现问题，再诊断修复；先验证资源、性能和构建，再判断交付。

核心实现内环

用户侧只需要记住一个入口：

game-captain

当不确定该用哪个技能时，直接说“用 game-captain 判断并执行下一步”。game-captain 会根据当前请求和项目上下文选择后续技能，例如任务分诊、系统设计、实现、调参、调试或资源管线。

game-captain
  -> game-feature-iteration
  -> game-research
  -> game-brainstorm
  -> game-setup-game-dev-skills
  -> game-brief
  -> game-gdd
  -> game-level-content-design
  -> game-economy-progression-design
  -> game-onboarding-tutorial-design
  -> game-feature-slicer
  -> game-task-triage
  -> game-unity-system-design
  -> game-ui-hud-flow-design
  -> gameplay-balance-tuning
  -> game-unity-implementation
  -> game-playtest-ux-evaluation
  -> game-accessibility-localization-check
  -> game-qa-debug

实现后的评审、架构审计、性能构建、发布和交接见 游戏开发技能库地图。

技能列表

第一版包含 27 个技能：

• game-captain：游戏技能路由入口。
• game-feature-iteration（Game Feature Iteration）：为已有项目新增功能、稳定化、热修和内容/数值迭代建立影响面与回归范围。
• game-research：为玩法、竞品、平台规则、技术路线、市场和素材参考提供可追溯调研证据。
• game-brainstorm：为游戏创意、机制 Hook、跨域组合、非换皮玩法和可验证原型假设提供 Brainstorm 流程。
• game-setup-game-dev-skills：初始化游戏项目的 Agent 工作约定。
• game-brief：澄清游戏想法、项目边界或存量项目功能增量简报。
• game-design-grilling：底层设计追问循环。
• game-gdd：生成轻量 GDD。
• game-domain-modeling：维护游戏领域语言和 ADR。
• game-level-content-design：设计关卡、任务、敌人/障碍组合、节奏曲线、难度台阶和内容复用。
• game-economy-progression-design：设计成长、奖励、消耗、解锁、资源流和付费/广告边界。
• game-onboarding-tutorial-design：设计新手引导、首次体验、首局学习路径、错误提示和失败恢复。
• game-feature-slicer：将版本目标或功能增量简报细分成可验证、可排期、可落地的游戏功能任务。
• game-task-triage：实现前分诊任务成熟度、影响范围、回归范围、依赖、资源、预研和阻塞状态。
• game-unity-system-design：实现前设计可见的 Unity 系统框架、接口、adapter 和测试 seam。
• game-ui-hud-flow-design：设计 HUD、菜单、结算、设置、新手引导、信息层级、交互流程和远距离可读性。
• gameplay-balance-tuning：复核游戏数值、难度曲线、公平性、经济和奖励参数。
• game-playtest-ux-evaluation：评估试玩体验，整理玩家理解、操作、反馈、节奏、HUD 可读性和爽感问题。
• game-accessibility-localization-check：检查可读性、色盲、字幕、输入适配、多语言文本膨胀和发布前语言风险。
• game-unity-implementation：按任务实现 Unity 功能并保护存量行为。
• game-art-audio-pipeline：规划美术和音频资源管线。
• game-qa-debug：游戏 Bug 诊断和复现闭环。
• game-unity-code-review：Unity 规格、工程、运行和回归风险评审。
• game-unity-architecture-audit：审计 Unity 工程结构、长期维护风险和定期 codebase health。
• game-performance-build：性能、包体、构建检查。
• game-release-liveops：发布和运营检查。
• game-handoff-game-context：跨会话交接游戏上下文。

Unity 类技能在当前会话可用时可能调用外部入口 unity-captain-skill-index 获取 Editor 证据；它是可选外部联动，不计入本库 27 个技能。

安装

在目标项目目录里运行：

npx game-dev-skills add

如果本机 npm registry 指向镜像源且尚未同步，可以临时指定官方源：

npx --registry=https://registry.npmjs.org/ game-dev-skills add

本地开发时，也可以直接使用本仓库 CLI：

node bin/game-dev-skills.js add

Codex 项目级安装目标是当前项目的 .codex/skills/，不是全局目录。这个目录是隐藏目录，Finder 中需要使用 Command + Shift + . 显示。

交互式安装菜单：

npx game-dev-skills add

菜单会依次选择目标 Agent（Codex、Claude Code、OpenCode、Cursor 或全部）、安装范围和安装全部或单个技能。脚本或 CI 中仍推荐使用下面的参数模式。

全局安装到 Codex：

npx game-dev-skills add --agent codex --scope global

项目级安装到当前项目的 Codex：

npx game-dev-skills add --agent codex --scope project

项目级安装到当前项目的 Claude Code：

npx game-dev-skills add --agent claude --scope project

项目级安装到当前项目的 OpenCode：

npx game-dev-skills add --agent opencode --scope project

项目级安装到当前项目的 Cursor：

npx game-dev-skills add --agent cursor --scope project

只安装单个技能：

npx game-dev-skills add --agent codex --scope project --skill game-captain

注意：单独安装 game-captain 只适合演示路由入口；真实项目建议安装完整技能库。否则它推荐的下游技能可能不存在，Agent 只能提示缺失，不能继续执行完整流程。

自定义安装目录：

npx game-dev-skills add --dest ./vendor/skills

从 GitHub 远程仓库直接安装或升级：

npx --yes github:dalong1225/skill_dev add --agent codex --scope global
npx --yes github:dalong1225/skill_dev upgrade --agent codex --scope project

如果用户是本地 clone 仓库：

git pull
node bin/game-dev-skills.js upgrade --agent codex --scope project

Git clone 本地工具：

Codex：

./scripts/install-codex.sh

Claude：

./scripts/install-claude.sh

OpenCode：

./scripts/install-opencode.sh

Cursor：

./scripts/install-cursor.sh

列出技能：

./scripts/list-skills.sh

校验：

node scripts/validate-skills.js
npm run verify

文档

• 游戏开发专业技能库方案
• 游戏开发技能库地图
• 游戏开发技能库可视化地图
• 技能库开发指导：游戏开发标准化质量门
• 技能库开发指导：验收与证据标准
• 技能库开发指导：Unity 工程最佳实践标准
• 技能库开发指导：内容资产管线标准
• 技能库开发指导：发布就绪标准
• 技能编写规范
• 技能打磨清单
• 技能测试案例
• 安装说明
• 设计取舍