taptap-maker-dev-kit-guide git:20260818.27e9c76A

Immutable. This exact content never changes and is served at /api/v1/blob/d9565e6a275edd54.

---
name: taptap-maker-dev-kit-guide
description: 介绍 Maker 项目随附的 AI 开发套件，包括开发指南、示例、模板和引擎参考资料。
---

# TapTap Maker AI Dev Kit

Use this skill to orient the local AI/Agent after `taptap-maker init` installs the AI dev kit into a
Maker project directory.

## What To Tell The Local Agent

After the Maker project is cloned, point the local AI/Agent at these local resources:

- `CLAUDE.md`: the main AI development guide entry. Read this first before changing Maker game code.
- `examples/`: runnable or copyable examples for common Maker development patterns.
- `templates/`: starter templates for creating new files or common game structures.
- `urhox-libs/`: engine APIs, capabilities, and local reference material for Maker runtime features.

Keep the explanation short. The goal is to help the local AI discover the installed development
resources, not to duplicate their contents in chat.

## Usage Guidance

When a user asks to develop or modify a Maker project after clone:

1. Check whether the current directory contains the dev-kit entries above.
2. Tell the local AI/Agent that `CLAUDE.md` is the first document to read.
3. Use `examples/` when the user asks for implementation patterns.
4. Use `templates/` when creating new game files or scaffolding.
5. Use `urhox-libs/` when engine API behavior or capability names are needed.

If these entries are missing in a bound Maker project, read `maker://status` or call
`maker_status_lite` with the actual project directory as `target_dir` to confirm state, then run
`taptap-maker dev-kit update` in that project directory to restore missing local dev-kit entries.
If status includes `Maker remote sync`, follow that section before editing: pull first only when the
workspace is clean, otherwise let the local AI help the user submit, stash, or cancel before pulling.

These files are local development aids. Do not submit them to Maker Git unless the user explicitly
asks and understands they are local environment files.

## Testing And Result Check

Keep validation simple for Maker users. 用户可以直接说“提交”或“构建”:

- If the current workspace is a bound Maker project and the user says “提交”, “推送”, “构建”,
  “预览”, “跑一下”, “查看结果”, “看看效果”, or “验证游戏效果”, use
  `maker_build_current_directory`. The tool commits when needed, pushes to Maker remote, and then
  runs the remote build.
- Do not treat generic code checks like “验证代码”, “跑测试”, “lint”, or “检查实现” as Maker
  remote build unless the user explicitly asks to build, run, or preview the Maker game.
- If push fails, do not start a separate build or generic Git push. Explain the returned recovery
  details, follow the returned classification-specific recovery (`remote_rejected`,
  `branch_not_allowed`, `forbidden_path`, or `auth`), then retry `maker_build_current_directory`.
- After submit or build finishes, report the returned Maker URL, build status, and runtime log file
  path when available. Do not auto-open TapMaker pages.

Do not create local-only test scripts just to verify Maker changes. The expected validation path is
chat request -> Maker MCP submit/build tool -> returned build result, Maker URL, and runtime logs.