主题
为什么是 Agile-Qt
一个反直觉的前提：这个框架假定所有代码主要由 AI（Claude / Codex）生成。
于是它的所有取舍，都不以「哪个技术最先进」为标准，而以一个更朴素的目标为最高权重—— AI 输出的准确度，以及改完之后能不能在编译期自我验证。
传统 Qt 开发，对 AI 并不友好
| 痛点 | 说明 |
|---|---|
🧩 .ui 文件易破 | Designer 的 XML 结构脆弱，AI 改一处常牵连一片，且无法独立完成「改完 → 验证」闭环。 |
| 🌀 API 凭记忆瞎写 | Qt API 浩如烟海，模型凭训练记忆容易写出过时或不存在的接口。 |
| 🚧 改完没有回路 | UI 改动是否生效，往往要人肉跑起来肉眼看，AI 拿不到反馈，只能盲改。 |
Agile-Qt 的解法
把每一个容易让 AI 翻车的环节，都换成 AI 擅长、且能被编译器或工具验证的路径：
| 强制原则 | 为什么 |
|---|---|
| UI 默认 = QWidget + 纯 C++ | 训练数据海量、编译期纠错、Git 行级 diff 可读。 |
禁止新增 .ui Designer 文件 | XML 易破，AI 无法独立完成验证闭环。 |
| QML 只用于扩展点 | 脚本扩展 / 子区域 / 启动 Splash，引入须经技术决策留痕。 |
| Qt API 不准凭记忆 | 不确定就用 context7 查 Qt 6 官方文档，杜绝幻觉 API。 |
一句话
「AI 写 Qt UI → QWidget 是默认答案，没有第二选项。」
三句话定位
- 📐 约定优于配置 —— 命名、分层、目录、构建都有约定，AI 沿着约定走，少决策、少出错。
- 🤝 AI 协作友好 —— 52 个技能 + 强制评估机制，让 AI 每次动手前先「懂」你的框架。
- ✅ 编译期可验证 —— 类型安全配置、新式信号槽、CMake 闭环，错误在编译期就被拦下。