AgentSkillsCN

xeku-entity-generation

XekuII 实体定义与生成规范技能。当您需要新增或修改 entities/*.xeku.yaml、menu.xeku.yaml 文件,或希望深入理解 hooks / UI / generator 的相关规则时,可使用此技能。

SKILL.md
--- frontmatter
name: xeku-entity-generation
description: XekuII 實體定義與生成規範技能。當需要新增或修改 entities/*.xeku.yaml、menu.xeku.yaml,或要理解 hooks / UI / generator 規則時使用。

XekuII Entity Generation Skill

Use

  • 需要撰寫或更新 entities/*.xeku.yaml
  • 需要理解 hooks(inventory_adjust / set_field)與狀態變更條件
  • 需要對齊 UI 設定(list/form/detail)與 generator 行為
  • 需要 menu 定義與導航生成規則

Primary Reference

  • references/ENTITY_GENERATION.md

Workflow

  1. 先確認需求範圍(新增/修改實體、關聯、欄位、hooks、UI、menu)
  2. references/ENTITY_GENERATION.md 對應章節
  3. 依規範修改或新增 YAML
  4. 必要時執行 Generator

Notes

  • YAML 使用 UnderscoredNamingConvention(如 db_table, lookup_field, default_sort
  • hooks 的 status_changed_to/from 必須對應 enum 成員
  • 參考文件較長時只讀需要的段落