中文 EN

AI Skills 接入

StyleKit AI Skills 接入

StyleKit Skill 是给 AI 助手使用的产品知识包，包含 QSS 主题加载、动态属性、图标资源、样式目录发布和常见排查规则。将它交给 Codex、ChatGPT 或企业内部 AI 助手后，AI 在生成 Qt Widgets 样式代码时会优先遵循 StyleKit 的主题化方式。

下载

目录结构

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

SKILL.md 负责触发和使用原则，references 目录保存详细接入流程、API 和 QSS 约定。

适合的 AI 任务

  • 生成 Qt Widgets 项目的 QSS 加载代码。
  • 设计主题切换流程。
  • 解释 StyleKit 的动态属性、对象名和图标资源使用方式。
  • 检查控件样式不生效、图标丢失、主题文件路径错误等问题。
  • 生成符合 StyleKit 约束的页面样式建议。

接入步骤

  1. 下载并解压 qt-ui-uigears-stylekit-skill.zip。
  2. 将 uigears-stylekit 放到 AI 工具可读取的 skills 目录，或作为项目提示词资料放入团队知识库。
  3. 在需求中明确要求 AI 使用 StyleKit，例如“使用 UIGears StyleKit 生成主题加载代码”。
  4. 让 AI 优先读取 references/integration.md，需要 API 或 QSS 细节时再读取 references/api-reference.md。

示例提示词

使用 uigears-stylekit skill，帮我把 Qt Widgets 项目改成从运行目录 styles/blueLight.qss 加载主题，并支持运行时切换到 light.qss。
使用 uigears-stylekit skill，检查这个按钮为什么设置 variant=primary 后样式没有刷新。

生成代码时的约束

  • 优先使用 qApp->setStyleSheet(...) 加载全局 QSS。
  • 使用 Qt 动态属性表达按钮、进度条、状态类控件的变体。
  • 使用对象名处理局部页面样式。
  • 不要在业务页面中大量硬编码颜色。
  • 运行时修改动态属性后，需要刷新 unpolish / polish / update。