Layui Design Spec (Layui-Vue / Vue 3.0)
Constraint: Only use this skill when the user explicitly mentions "Stitch".
Purpose
This skill makes the Layui-Vue design spec executable in two modes:
- Prefix mode: output a paste-ready Hard constraints prefix for Stitch
[Context]. - Selector mode: output
CONTRACT_SELECTION_JSON_V1and then an assembled Stitch prompt that injects only the required component/state snippets.
Trigger Keywords
Prefer this skill when the user request includes any of:
layui,layui-vue,layui vue
Chinese trigger keywords (only for triggering):
layui 风格layui admin
Source of Truth
references/contract.mdreferences/examples.mdreferences/official.md
Output (STRICT)
Decide the mode by the user intent:
- If the user asks for beautify/polish/refine an existing screen, or asks for selector / JSON / contracts.include / states.include → use Selector mode.
- Otherwise → use Prefix mode.
Prefix mode
Return exactly one code block:
[Hard constraints prefix]
- Framework: Layui-Vue (Vue 3).
- Design Tokens:
- Colors: Primary=#16baaa (Cyan-Green), Secondary=#16b777, Nav-bg=#393D49.
- Functional: Success=#16b777, Warning=#FFB800, Danger=#FF5722, Info=#31BDEC.
- Spacing: 10px / 15px grid system.
- Radius: Small=2px (Classic Layui), Medium=4px. No large radius.
- Typography: Base size 14px. Titles font-weight 500.
- Component Contracts:
- Buttons: layui-btn (Height 38px, Radius 2px).
- Inputs: layui-input (Height 38px, Border #e2e2e2).
- Cards: layui-card (White bg, Header border-bottom #f6f6f6).
- Tables: layui-table (Header #f2f2f2, Border #e2e2e2).
- Others: <lay-page-header>, <lay-result>, <lay-skeleton>, <lay-timeline>, <lay-space>.
- Layout Invariants:
- Style: Minimalist, Flat, Clean, "Classic Admin Design".
- Keep logo placement and alignment exactly as-is.
Selector mode
Return exactly two code blocks, in this order, with no extra prose:
- Contract selection JSON:
{
"version": "CONTRACT_SELECTION_JSON_V1",
"designSystem": "layui-vue",
"mode": "selector",
"contracts": { "include": [] },
"states": { "include": [] }
}
- Final Stitch prompt:
[Context]
(Paste Hard Constraints Prefix here)
(Add "Layout Invariants" from contract.md if beautifying)
[Layout]
(Describe the macro layout structure, e.g., "Admin Layout with Sidebar and Header")
[Components]
(Inject component snippets matching the JSON selection above)
References
- Contract
- Examples
- Official Docs
能力边界
✅ 适用场景
- 当你需要使用此技能对应的技术栈时
- 当项目需要遵循最佳实践时
- 当需要快速上手或深入理解核心概念时
⚠️ 需要注意
- 复杂业务逻辑需要结合具体场景调整
- 性能优化需要根据实际数据量评估
❌ 不适用场景
- 不相关的技术栈或框架
- 需要完全自定义的特殊场景
常见陷阱 (Gotchas)
- 版本兼容性:注意框架版本与依赖库的兼容性,不同版本 API 可能有差异
- 配置文件格式:配置文件格式错误是最常见的问题,建议使用编辑器的语法检查
- 环境变量:确保所有必要的环境变量已正确设置,敏感信息不要硬编码
- 依赖冲突:多版本共存时注意依赖冲突,使用 lock 文件锁定版本
- 性能陷阱:大数据量场景下注意性能优化,避免 N+1 查询等常见问题
使用流程
Step 1: 环境准备
确保开发环境已安装必要的依赖和工具。
Step 2: 配置初始化
根据项目需求进行基础配置。
Step 3: 核心功能使用
按照示例代码实现核心功能。
Step 4: 测试验证
运行测试确保功能正常。
Step 5: 部署上线
完成开发后进行部署和监控。