要构建专属CodeBuddy智能体，需创建项目结构、定义行为规则、绑定知识库与MCP工具，并启动验证：①建目录并执行codebuddy --init生成agent.yaml；②在rules下添加类型注解、命名与路径格式约束；③启用MCP、挂载文档、注册gen_api_doc.py技能；④运行codebuddy -p启动服务，用curl测试是否符合三项规范。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让CodeBuddy不再只是帮你补全代码的“高级自动完成”，而是变成真正理解你项目规范、记住你命名习惯、能主动按你团队标准生成模块的专属开发助理——这需要从零构建一个属于你的智能体，而不是用默认的通用模型。
创建专属智能体项目结构
在终端中执行以下命令，新建一个智能体工程目录并初始化基础文件：
mkdir -p my-codebuddy-agent/src/agents my-codebuddy-agent/src/utils
进入目录后，用codebuddy --init命令生成智能体骨架配置文件：cd my-codebuddy-agent && codebuddy --init。这一步会自动生成agent.yaml和skills/目录，【必须保留agent.yaml中的version字段为语义化版本号，否则后续技能加载会失败】。
手动创建src/agents/core.py作为主调度逻辑入口，内容只需写一行：def run(context): return "Hello from your custom agent"。这是最简可用态，确保后续调试不卡在空文件报错。
定义智能体行为规则（Rules）
Rules是让AI“记住规矩”的核心配置。打开刚生成的agent.yaml，在rules:节点下添加三条强制约束：
方法一：直接编辑YAML
在rules:下新增三行：- enforce: "所有Python函数必须带类型注解"- enforce: "变量名禁止使用下划线前缀（如__private）"- enforce: "API路由路径统一用kebab-case格式（如/user-profile）"
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 问题
方法二：通过CLI命令注入（适合快速验证）
运行codebuddy --append-system-prompt "你是一个严格遵守PEP 8且拒绝生成任何print()调试语句的Python专家"。这条指令会临时覆盖当前会话的行为，但不会写入agent.yaml，【临时指令无法跨会话生效，正式部署前务必写入YAML】。
绑定本地知识库与MCP工具
第一步：启用MCP协议支持
在项目根目录执行codebuddy --enable-mcp。该命令会自动在.codebuddy/config.json中写入"mcp_enabled": true，并创建mcp-tools/目录。
第二步：挂载项目文档
将你团队的《前端组件命名规范.md》和《后端接口设计白皮书.pdf》两个文件放入mcp-tools/docs/目录。CodeBuddy会在后续对话中自动索引这些内容，无需额外指令。
第三步：注册自定义技能
在skills/目录下新建gen_api_doc.py，填入如下代码：from mcp import register_skill@register_skill(name="generate_openapi_spec")def gen_spec(code: str) -> str: return f"OpenAPI 3.1 spec generated from {len(code)} lines"
保存后，执行codebuddy --reload-skills使新技能立即可用。
启动并验证专属智能体
① 进入项目根目录，运行codebuddy -p src/agents/core.py启动智能体服务；
② 在另一终端窗口，用curl -X POST http://localhost:8000/ask -H "Content-Type: application/json" -d '{"query":"写一个用户登录接口，返回token"}'发送测试请求；
③ 观察返回结果是否包含类型注解、是否使用kebab-case路径、是否调用generate_openapi_spec技能——三项全部命中即表示专属智能体已就绪。
