中文 EN

AI Skills 接入

WidgetKit AI Skills 接入

WidgetKit Skill 是给 AI 助手使用的控件库知识包，包含 UIGQ 控件体系、主题 JSON、容器布局、按钮/图标状态、SVG 颜色、滚动条、序列化和常见排查规则。它适合让 AI 生成或修改 WidgetKit 页面、主题配置和控件代码。

下载

目录结构

uigears-widgetkit/
  SKILL.md
  agents/openai.yaml
  references/
    integration.md
    api-reference.md

适合的 AI 任务

  • 生成 WidgetKit 初始化代码和资源加载流程。
  • 使用 UIGQContainer、UIGQPushButton、UIGQLineEdit 等控件组装页面。
  • 编写或检查 theme.json、style.json。
  • 将可复用视觉样式迁移到主题配置。
  • 排查 SVG 图标、按钮 hover、fade、滚动条方向、布局比例和绝对停靠问题。
  • 生成控件 JSON 属性说明和序列化实现建议。

接入步骤

  1. 下载并解压 qt-ui-uigears-widgetkit-skill.zip。
  2. 将 uigears-widgetkit 放到 AI 工具可读取的 skills 目录。
  3. 需求中明确要求 AI 使用 WidgetKit，例如“使用 UIGears WidgetKit 控件实现这个设置页”。
  4. 新项目接入时先让 AI 读取 references/integration.md。
  5. 修改控件 API、主题 JSON 或布局问题时，让 AI 读取 references/api-reference.md。

示例提示词

使用 uigears-widgetkit skill，帮我用 UIGQContainer 和 UIGQPushButton 实现一个顶部工具栏，样式通过 theme.json/style.json 配置。
使用 uigears-widgetkit skill，检查这个按钮设置 SVG icon 后为什么显示为黑色，并给出修复建议。

生成代码时的约束

  • 初始化顺序保持为 UIGQtLib::init()、设置皮肤目录、加载主题目录、创建窗口。
  • WidgetKit 页面优先使用 UIGQ* 控件，不随意混入普通 QWidget + QLayout。
  • 可复用外观优先落到 theme.json 和 style.json。
  • setDrawBackground(false) 这类绘制行为可以保留在 C++。
  • 主题切换不应意外改变布局尺寸，除非主题项明确配置了几何字段。