Luban Dev

What it does

When your agent uses it

• Tasks that involve Excel spreadsheets

Example prompts

• “/luban-dev”

Requirements

• Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

1. 1先判断改动属于数据、表结构、Bean/Enum、schema、模板、导表脚本还是运行时消费。
2. 2读现有定义：tables.xlsx、beans.xlsx、enums.xlsx、目标业务表和相关 ConfigMgr。
3. 3改源文件，不改 LubanConfig/ 下生成代码。
4. 4运行或提示运行默认导表脚本。
5. 5验证生成目录、Unity 编译、ConfigSystem.Instance.Tables 访问和业务管理器封装。

What it can do on your machine

Read from SKILL.md and the folder at commit df0e6f4. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 2 files in scripts/ (Python), which the agent can run.

  Shell commands in SKILL.md call:

  • python
  • bash
  • pip

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Links to these hosts (documentation or services it may open):

  • datable.cn

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Luban Dev loads about 2.1k tokens when it runs, and up to ~22k if it reads all its reference files. Until then it costs about 118 tokens; SKILL.md has 430 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~118

When it runs · the whole SKILL.md, loaded when a task matches

~2.1k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~22k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from AmaniDawn/DGame at commit df0e6f4, republished under its MIT licence (© AmaniDawn). 430 words, ~2,068 tokens.

name

luban-dev

description

DGame Luban 游戏配置全栈工具，支持枚举/Bean/数据表/字段/数据行的增删改查、配置校验、引用检查、导表脚本调用、ConfigMgr 封装与运行时消费链路排查。触发场景：(1) 编辑 GameConfig/Datas 下的游戏配置数据（道具表、文本表、模型表、音效表、特效表、GM 表等），(2) 新增/修改/删除配置表结构、字段、枚举或 Bean，(3) 处理 __tables__.xlsx/__beans__.xlsx/__enums__.xlsx、# 自动导入表或 DGame Sheet 拆表规则，(4) 修改 luban.conf、Defines、CustomTemplate 或 GenerateTool_Binary 导表脚本，(5) 生成/校验客户端 GameProto 配置代码和二进制配置数据，(6) 排查 ConfigSystem、Tables、GameLogic/ConfigMgr 配置访问问题。即使用户未明确说 “Luban”，只要是在编辑或排查游戏配置数据，也应使用此技能。

cmd /c "set AI_MODE=1 && GameConfig\GenerateTool_Binary\gen_bin_client_lazyload.bat"

bash GameConfig/GenerateTool_Binary/gen_bin_client_lazyload.sh

python .agents/scripts/workflow.py luban validate
python .agents/scripts/workflow.py luban test
python .agents/scripts/workflow.py luban preview --mode lazyload
python .agents/scripts/workflow.py approve --plan <preview.json> --by <实际确认人> --reason <实际确认记录> --high-risk
python .agents/scripts/workflow.py luban apply --plan <preview.json> --approval <approval.json>

using GameLogic;

var modelCfg = ModelConfigMgr.Instance.GetOrDefault(modelId);
var hasModel = ModelConfigMgr.Instance.ContainsKey(modelId);
var ok = SoundConfigMgr.Instance.TryGetValue(soundId, out var soundCfg);

using GameProto;

public ModelConfig GetOrDefault(int modelID) => TbModelConfig.GetOrDefault(modelID);

python .agents/skills/luban-dev/scripts/luban_helper.py --data-dir GameConfig/Datas <command>

© AmaniDawn, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 14 other files (scripts, references) in .agents/skills/luban-dev of AmaniDawn/DGame.

• SKILL.md
• agents/openai.yaml
• references/command-reference.md
• references/data-sources.md
• references/dgame-integration.md
• references/dgame-table-rules.md
• references/excel-format.md
• references/luban-conf.md
• references/operating-guide.md
• references/runtime.md
• references/schema.md
• references/type-system.md
• references/validators.md
• scripts/luban_helper.py
• scripts/requirements.txt

Open the folder on GitHubat commit df0e6f4