codebuddy需通过--system-prompt等参数精准设定ai角色,确保生成代码符合团队规范;支持文件加载角色、追加式增强,并强调引号格式与路径规范。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想让CodeBuddy写出符合团队规范、风格统一、能直接进CI的代码,而不是每次都要手动重命名变量、补类型注解、改目录结构——这靠默认提示词做不到,必须用角色设定精准控制AI的“性格”和“身份”。
用系统提示词定义AI角色
角色不是写在对话里的客气话,而是通过--system-prompt参数注入的底层人格设定,它决定AI思考问题的优先级和表达方式。
第一步:启动时直接传入角色指令
codebuddy --system-prompt "你是一位专注微服务架构的Go语言工程师,所有代码必须使用Go 1.22+、gRPC接口、Protobuf定义,禁止使用全局变量,每个服务必须自带健康检查端点"
第二步:确认角色生效
输入“写一个用户注册API”,观察输出——若生成的是HTTP handler而非gRPC service,说明角色未生效,检查引号是否为英文直角引号,【中文引号会导致整个提示词被忽略】。
第三步:验证行为一致性
连续追问“生成对应的Protobuf定义”“写Dockerfile”“补充单元测试”,三次输出都应保持gRPC、Protobuf、健康检查等特征。若某次突然返回Express.js代码,说明角色设定被后续对话覆盖,需重启会话。
从文件加载标准化角色
团队协作中,角色设定不能靠口头约定,必须版本化管理,否则新成员一接入就写出风格迥异的代码。
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 问题
方法一:创建角色文件
在项目根目录新建 .codebuddy/roles/backend-sre.txt,内容为:
• 所有日志必须含trace_id、service_name、level字段
• HTTP响应头强制添加X-Request-ID
• 错误码只允许500/400/404,禁止裸抛panic
• 每个服务必须提供/metrics和/healthz端点
方法二:绑定角色启动
codebuddy --system-prompt-file .codebuddy/roles/backend-sre.txt
注意:文件路径必须是相对当前工作目录的路径,【绝对路径会导致加载失败且无报错提示】。
追加式角色增强
多数场景不需要推翻默认行为,只需在原有能力上叠加专业视角——比如保留CodeBuddy的通用代码理解力,再让它多一层“前端性能优化师”的身份。
codebuddy --append-system-prompt "你同时是Web性能专家:所有React组件必须用React.memo包裹;CSS-in-JS必须启用extractCritical;图片资源自动转成webp并添加srcset;Lighthouse评分目标≥95"
这一步操作起来很简单,直接把命令粘贴进终端回车就行。但要注意:追加提示词不会覆盖默认的代码补全、错误诊断等基础能力,只强化特定维度——如果你发现AI开始忽略类型检查或跳过单元测试生成,说明追加内容与默认规则冲突,需删减冗余约束。










