# Luban Validator

> Writes Luban field validators (ref, range, path, size, set, regex, non-default). Use when adding validation rules on types or Excel

- Skill: `focus-creative-games/luban-validator` (Agent Skill)
- Install (CLI): `npx skillmds@latest add focus-creative-games/luban-validator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/focus-creative-games/luban-validator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: focus-creative-games (https://skillmd.com/u/focus-creative-games)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/focus-creative-games/luban-validator

---


# Luban: 校验器

校验在生成期执行。发布建议 `--strict`。

## 常用写法

| 能力 | 示例 |
|------|------|
| 非默认 | `int!`、`int?!` |
| 引用 | `int#ref=item.TbItem` |
| 引用可跳过 0 | `int#ref=item.TbItem?` |
| 范围 | `int#range=[1,100]` |
| 路径 | `string#path=unity` + `-x pathValidator.rootDir=...` |
| 集合大小 | `(list#size=4),int` |
| 允许值 | `int#set=1;2;3` |
| 正则 | `string#regex=^[a-z]+$` |

写在 XML `type="..."` 或 Excel `##type`。

## 步骤

1. 确认被引用表全名（可用 schema-json / MCP）。
2. 改字段类型字符串，保留原有 group/注释。
3. `dotnet Luban.dll ... -f --strict --errorFormat json` 验证。

## 注意

- 容器约束加在容器上：`(list#size=n),T`
- 可空为 null 时多数引用类校验会跳过
- 不要用削弱校验的方式「修好」坏数据