Skip to content

第 18 章 AI 辅助开发(skills + LLMs.txt) ​

学习目标 ​

学完本章,你应该能:

  1. 理解 fba 的 AI 辅助开发思路
  2. 掌握 fba skills 和 LLMs.txt 的作用
  3. 知道如何让 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 开发流程:

  1. 安装 fba skills:让 AI 先懂项目规范
  2. 按标准顺序开发:让 AI 按 model → schema → router → service → crud 顺序生成
  3. 生成后复核:AI 生成的代码仍需人工审查,确保符合业务需求
  4. 善用 skills 审查:让 AI 读取 skills 来审查代码是否符合规范

AI 辅助开发流程 ​

五、其他 AI 相关能力 ​

fba 的 AI 生态还包括:

能力说明
MCPModel Context Protocol,AI 工具接入协议
PromptAI 提示词相关支持
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)