luban-dev

Automates Luban configuration table creation, validation, and export workflows from Design/config Excel files and Defines.

63|6|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/xiayu519/Tyou --skill luban-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: luban-dev
Source: https://github.com/xiayu519/Tyou/tree/main/.agents/skills/luban-dev
Command: npx skills add https://github.com/xiayu519/Tyou --skill luban-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openpyxl, and includes scripts (resource) components.

What problem does it solve?

Tyou Luban 配表开发专用指导,提供面向 Luban 配表开发的结构化工作流、参考资料与工具,帮助团队在 Design/config 下的 Excel 表、Defines、luban 配置实现一致、可追溯的变更。

Core Features & Use Cases

  • 提供从设计稿到 Luban 配表的一整套工作流:扫描配置、添加/修改枚举与 Bean、生成/验证表结构,以及导出二进制配置的约定流程。
  • 集成的工具链包括 Luban Excel helper、scan-luban.ps1 运行脚本,以及用于导表/校验的开放规范(OpenSpec) 驱动的工作方式,帮助确保数据完整性和代码对齐。
  • 常见用例:创建新表、修改字段、合并/校验枚举与 Bean、执行导表、验证表结构和生成产物,并在变更前后进行引用检查。

Quick Start

Start by running the Luban Excel helper in read-only mode to inspect the Luban configuration sheets under Design/config, then follow the OpenSpec-guided workflow to modify the source Excel files and regenerate the binary tables.

Frequently Asked Questions about luban-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate Luban configuration tables before exporting?

You can validate Luban configuration tables by running the scan-luban.ps1 script to inspect Excel definitions and enforce OpenSpec changes, ensuring data integrity and correct code generation before exporting binary tables.

What is the standard workflow for modifying Luban Excel definitions and beans?

The standard Luban workflow involves scanning configuration sheets in read-only mode, modifying source Excel files for beans and enums, and regenerating binary tables using an OpenSpec-guided process to maintain traceable changes.

Does this Luban config tool require openpyxl to inspect Excel sheets?

Yes, this Luban config tool requires the openpyxl dependency to read and modify Excel configuration sheets, enabling the luban_helper.py script to inspect and process table structures during development.

How do I add new enums and beans to Luban configuration tables?

To add new enums and beans to Luban configuration tables, follow the OpenSpec-guided workflow to modify the source Excel files under Design/config, then regenerate and validate the output using integrated helper scripts.

What's the best way to ensure data integrity when updating Luban exports?

The best way to ensure data integrity when updating Luban exports is to enforce OpenSpec changes and run reference checks before and after modifications using the luban_helper.py and scan-luban.ps1 scripts.

Why are my generated Luban binary tables misaligned with the client codebase?

Luban binary tables misalign with the client codebase when OpenSpec changes are not enforced or when Excel definitions for beans and enums are modified without running validation and reference checks using scan-luban.ps1.