主题
技能体系 ⭐ 核心
这是 Agile-Qt 与普通 Qt 模板最大的不同：52 个「领域知识包」，让 AI 每次动手前先「懂」你的框架。
什么是「技能」
每个技能是一份结构化的 SKILL.md，封装了某个领域的约定、参考代码位置、最佳实践和禁令—— 比如「怎么写一个自定义 QWidget」「怎么设计数据库迁移」「怎么集成 Claude 流式响应」。
它不是给人看的文档，而是给 AI 即时加载的工作指南，让模型从「凭训练记忆瞎写」变成「照着你框架的规矩写」。
强制评估机制：评估 → 激活 → 实现
用户每次提问，Hook 会自动注入技能评估提示。AI 必须先匹配相关技能、逐个激活，再开始写代码——这是硬约束，不能跳过。
① 提问 → ② 评估 → ③ 激活 → ④ 实现
用户需求 Hook 注入 加载匹配的 沿约定与
技能清单 SKILL.md 禁令落地效果
AI 不会再写出过时 API、违反分层、漏掉内存管理或踩中框架禁令——因为动手前，规矩已经加载进上下文。
三级分层 · 52 个技能
| 层级 | 数量 | 定位 |
|---|---|---|
| L1 · 直接复用 | 13 | 通用软件工程方法论：头脑风暴、任务跟踪、Git、技术选型、多模型协作——跨项目即拿即用。 |
| L3 · 深度定制 | 26 | Qt / C++ 领域技能，针对五层架构与 Qt 6 API 深度定制：控件、信号槽、数据库、插件、KDE 三件套…… |
| L4 · 框架专属 | 13 | Agile-Qt 独有的能力：自主开发、AI 集成、加密、多线程、打包发布、响应式数据流…… |
技能地图
52 个技能按领域归类，覆盖一个桌面应用从架构到上线的全生命周期：
| 领域 | 技能 |
|---|---|
| 🏛️ 架构与导航 | architecture-design · project-navigator · project-init · code-patterns · context-action-routing |
| 🎨 UI 与交互 | qt-widgets · ui-frontend · custom-painting · style-theming · semantic-color-roles · gui-action-system |
| 🔗 信号与状态 | signal-slot · store-management · reactive-streams |
| 🗄️ 配置与数据 | config-system · kcfg-config-schema · database-ops · data-interop · sync-engine |
| 🌐 服务与集成 | network-service · ai-integration · crypto-security · system-integration · qml-scripting · multithreading |
| 🧱 插件与命令 | plugin-development · command-pattern |
| 🔬 质量与诊断 | test-development · bug-detective · error-handler · performance-doctor · memory-management · logging-categories · crash-reporting |
| 📦 兼容与发布 | pimpl-binary-compat · api-evolution · cmake-build · cross-platform · packaging-deploy · release-publish |
| 🛡️ 合规与隐私 | license-compliance · telemetry-privacy · kauth-action-model |
| 🤝 方法与协作 | brainstorm · tech-decision · task-tracker · git-workflow · collaborating-with-codex · collaborating-with-gemini · add-skill · exp-sediment · i18n-development |
9 个斜杠命令
技能是「知识」，命令是「动作」。常用斜杠命令把多技能编排成一键流程：
| 命令 | 用途 |
|---|---|
/dev | 开发新功能（Widget + Service + Manager 全套生成） |
/command | 创建 Command 子类（撤销 / 重做支持） |
/plugin | 生成插件骨架（plugin.json + Plugin 子类 + CMake） |
/bump | 版本号 + SONAME 协同升级（SemVer + CHANGELOG） |
/check | 代码规范检查（C++20 + Qt 6 + 命名 + clang-tidy） |
/progress | 项目进度报告 |
/next | 下一步建议 |
/start | 项目启动导航 |
/release | 打包发布（CPack 生成安装包 + 版本号更新） |
还有自主开发命令
面向 AI 自主开发的编排命令 /kickoff · /dev-loop · /loop-gen · /exp，详见 AI 原生开发。
会自我进化的技能库
技能体系不是一次写死的：
- add-skill —— 把新沉淀的实现模式转化成可复用技能。
- exp-sediment —— 把每次会话踩过的坑、确认过的做法，反哺成新禁令或新技能。框架越用越聪明。