CodeBuddy代码规范需分层配置：一、项目级通过.settings.json精准控制；二、团队级用Skill脚本固化风格锚点；三、上下文感知靠CODEBUDDY.md自动继承；四、实时干预用/rules命令动态加载。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy 的代码规范设置不是“一键开启”就能自动适配的，而是需要结合项目实际、团队约定和工具能力做分层配置。核心思路是：让 AI 明白“你写什么、怎么写、为什么这么写”。下面按实用场景拆解关键操作。
一、项目级规范：用 .codebuddy/settings.json 精准控制
这是最稳定、可提交到 Git 的方式，适合团队统一执行。CodeBuddy 会优先读取项目根目录下的 .codebuddy/settings.json 文件。
- 新建该文件，填入风格约束，例如：
"rules": {"indent": "4 spaces", "naming": "camelCase", "commentStyle": "JSDoc", "noVar": true}- 支持 JSON/YAML 格式，字段名需与 CodeBuddy 内置规则引擎匹配（如
indent、naming_convention） - 无需重启，保存后新生成的代码立即生效；已有文件可通过
/fix命令触发批量重格式化
二、团队级模板：通过 Skill 脚本固化风格锚点
如果你希望所有成员生成的 Controller、Service、DTO 都带相同注释头、字段顺序、异常包装逻辑，就得改 Skill 层。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
- 找到
skills/code-gen/SKILL.md，编辑prompt_template区块 - 插入明确指令，比如：“所有 Java 类必须包含 @author、@since、@version；方法参数禁止使用 Map 或 Object，必须声明具体 DTO；布尔字段命名以 is 开头，不加 get 前缀”
- 同步更新
output_template，确保返回结构含风格校验字段（如{{jsdoc_status}}） - 右键对应 Skill →「重载技能」，全团队调用时即自动遵循
三、上下文感知：靠 CODEBUDDY.md 自动继承规范
适合 RESTful 接口、微服务模块等有强语义约定的场景。AI 会主动读取这个 Markdown 文件作为当前项目的“开发契约”。
- 在项目根目录新建
CODEBUDDY.md - 写入可执行条款，例如：
“API 路径必须为 /api/v1/{resource}；资源名用复数；GET 返回 200，POST 成功返回 201；错误响应统一用 ErrorResult{code, message, timestamp}” - 之后只要说“生成用户管理接口”，AI 就不再问路径或状态码，直接按文档输出
四、实时干预：用 /rules 命令动态加载规范
适合临时切换规范，比如给老系统补写代码时要兼容 Checkstyle，或对接阿里规约。
- 在对话框第一行输入：
/rules AlibabaJavaStandard - 等待提示“已加载阿里Java开发规范v1.7.0（2022）”
- 接着输入
/init OrderService，生成内容将自动含 ThreadLocal 封装 SimpleDateFormat、Objects.equals 替代 == 等细节 - 也可加载自定义规则文件：
/rules ./rules/our-team-rules.json
不复杂但容易忽略——规范不是设完就万事大吉，得配合 /fix 扫描、/explain 反向验证、以及定期用 codebuddy --print 测试 CLI 输出一致性。真正落地的关键，在于把“人写的规则”变成“AI默认的直觉”。
