TheQtCompanyRnD/agent-skills

解决的问题

它提供了一套标准化的“代理技能”(agentic skills)，协助 AI 代码助手（如 Claude Code、GitHub Copilot 和 Gemini CLI）更准确地理解并使用 Qt 框架。它专门解决常见的 LLM 错误，例如对旧版工具 (qmake) 的预训练偏差，或是对 QML 绑定与作用域的错误假设。

运作方式

技能被封装为包含 SKILL.md 文件的目录，其中包含 YAML 前言与选用的参考文档。这种结构允许 AI 代理使用“渐进式揭露”(progressive disclosure)，在启动时仅加载基本元数据，并在特定技能启用时才提取详细的技术参考。该项目还包含一个用于实时 Qt API 文档查询的 MCP (Model Context Protocol) 服务器。

适用对象

使用 AI 代码工具开发 Qt、QML 和 C++ 应用程序的软件开发人员与 QA 工程师。

特色亮点

• 代码审查：针对 C++ 和 QML 的专业技能，结合确定性 Linting 与深度 AI 分析，以确保内存安全、线程安全与性能。
• 概念修正：修正 LLM 对声明式 QML 以及 C++/QML 边界错误认知的指南。
• 自动化工具：用于生成 QML 测试案例、将 Figma 设计 Token 提取为 QML 单例，以及管理 CMake 项目的技能。
• 跨平台支持：兼容于 Claude Code、Codex CLI、Gemini CLI 与 GitHub Copilot。
• 文档整合：提供托管的 MCP 服务器，可直接访问 API 文档。