外观
AI辅助编程
CodeBuddy入门
选择自己喜欢的、熟悉的AI辅助编程工具即可。下面以腾讯 CodeBuddy 为例说明。
CODEBUDDY.md
仓库根目录的 CODEBUDDY.md.example 是模板,描述了项目目标、架构分层、编码规范、与 AI 的约定。将其复制为 CODEBUDDY.md ,默认每次对话会将原文全文放入上下文。
其中“与 AI 编程助手的约定”最关键的一条是:遇到大的修改,先给出修改 / 设计方案,确认后再修改代码。这条约定能在动手前暴露理解偏差,避免大规模返工。
powershell
cp CODEBUDDY.md.example CODEBUDDY.md项目规则
项目规则存储在代码库的 .codebuddy/rules 目录中,按需要自行创建。
代码库本身
当文档与代码存在歧义时,以代码为准。AI 助手会优先参考既有模块的“代码风格示例”,保持新增代码与存量风格一致。
AI 辅助开发工作流
高效协作模式
- 先设计,后动手:先让 AI 给出方案,你确认无误后再进入实现
- 给 AI 足够的上下文:指明涉及的目录或文件
- 分而治之:把大需求拆成小任务逐个推进,每步都可验证
以“新增一个后端业务模块”为例,推荐协作流程:
- 提需求:描述功能、字段、接口形态,参考既有模块。
- 审设计:AI 给出目录、命名、数据表与字段设计,你确认。
- 写代码:AI 按约定生成 model / schema / crud / service / controller。
- 查代码:运行 ruff 格式化与检查,处理类型 / 未使用变量。
- 跑测试:必要时运行 pytest 或端到端用例。
- 交付:确认行为符合预期后提交。
模型选择建议
- 日常开发:GLM-5.3-Flash (思考强度 max)
- 设计阶段:GLM-5.3