第 18 章 AI 辅助开发(skills + LLMs.txt)
学习目标
学完本章,你应该能:
- 理解 fba 的 AI 辅助开发思路
- 掌握 fba skills 和 LLMs.txt 的作用
- 知道如何让 Claude Code、Cursor 等 AI 工具读懂项目规范
一、为什么需要 AI 辅助
fba 是一套有严格规范的项目。人工开发容易偏离规范,AI 开发又可能"不懂"项目的特殊约定,生成出不符合架构的代码。
fba 的解决方案:把项目规范"喂"给 AI 工具,让 AI 照着规范写代码。
官方是这样描述的:
fba skills + LLMs.txt 让 Claude Code、Cursor、Codex 等直接读懂项目规范。
问题的本质
二、fba skills
Skills(技能) 是给 AI 工具的"技能包",告诉 AI 这个项目该怎么写代码。
fba 官方提供了 fba skills,包含:
- 完整的架构规范
- 编码风格
- Service / CRUD 开发流程
- 分页、缓存、Celery、i18n
- 插件开发与分享指导
安装建议
官方建议:使用 AI 辅助开发时,先安装 fba skills,再按 model、schema、router、service、crud 的顺序生成或审查代码。
安装后,AI 工具(Claude Code、Cursor、Codex 等)会自动遵循这些规范。
三、LLMs.txt
LLMs.txt 是一种专为 AI 大模型设计的文档格式(类似给 AI 看的"说明书"),把项目的关键信息(架构、规范、约定)浓缩成 AI 易读的形式。
有了它,AI 工具能快速理解项目,不用每次都从头摸索。
通俗理解:LLMs.txt 就像给 AI 的"项目速查手册",skills 就像给 AI 的"操作技能书"。
skills 与 LLMs.txt 的分工
四、AI 辅助开发的正确姿势
结合官方建议,推荐的 AI 开发流程:
- 安装 fba skills:让 AI 先懂项目规范
- 按标准顺序开发:让 AI 按 model → schema → router → service → crud 顺序生成
- 生成后复核:AI 生成的代码仍需人工审查,确保符合业务需求
- 善用 skills 审查:让 AI 读取 skills 来审查代码是否符合规范
AI 辅助开发流程
五、其他 AI 相关能力
fba 的 AI 生态还包括:
| 能力 | 说明 |
|---|---|
| MCP | Model Context Protocol,AI 工具接入协议 |
| Prompt | AI 提示词相关支持 |
| LLMs | 大模型相关文档 |
这些让你能用各种 AI 工具高效地开发 fba 项目。
六、常见疑问
Q1:一定要用 AI 辅助开发吗? 不是必须的。AI 辅助只是提效手段。但 fba 官方推荐用 skills + LLMs.txt 来保证 AI 生成的代码符合规范。
Q2:AI 生成的代码能直接用吗? 建议人工复核。AI 可能理解偏差或遗漏业务细节,最终代码仍需你确认。
本章小结
关键要点回顾:
- fba 通过 skills + LLMs.txt 让 AI 读懂项目规范
- 安装 fba skills 后再让 AI 开发,效果更好
- 开发顺序:model → schema → router → service → crud
- AI 生成的代码仍需人工复核
下一步: 第 19 章讲 Docker 部署和可观测性,把项目上线到生产。
对应官方文档:
AI-Skills(ai/skills.html)、AI-LLMs(ai/llms.html)