要打造一个真正懂你的全栈开发智能体，关键不在于安装了多少插件，而在于能不能让AI“记住”你们团队的约定俗成。举个例子，你每次写Spring Boot代码都习惯用某个特定版本，前端组件永远走函数式写法，数据库表名还非得加个统一的业务前缀——这些琐碎的规范，如果每次都得重新交代一遍，那所谓的智能体也就谈不上“智能”了。
所以，跳过基础配置，直接上手构建专属智能体。下面这四步，能帮你实现这个目标。
定义智能体角色与能力边界
第一步，先在项目根目录下新建一个.codebuddy/agents/fullstack.yaml文件。这个路径是CodeBuddy识别自定义Agent的强制约定——放错位置，加载就会失败。
文件里写入核心角色声明：
name: fullstack-dev
description: 专精React 18 + TypeScript前端、Spring Boot 3.2后端、PostgreSQL数据库的全栈开发智能体
capabilities:
- frontend-generation
- backend-api-design
- database-migration
- docker-compose-generation
需要注意的是，【name字段必须小写字母+短横线，不能含空格或下划线】——这一点务必记牢。否则CodeBuddy启动时会静默跳过该Agent，不报错也不加载，排查起来相当费时。
注入项目专属上下文记忆
接下来，打开.codebuddy/memories/project-context.md，用自然语言把真实约束条件写清楚：
“本项目使用Spring Boot 3.2.4，禁用Lombok，所有DTO必须手动编写getter/setter；前端采用Vite+React 18，组件必须使用函数式写法，禁止class组件；数据库为PostgreSQL 15，所有表名加app_前缀。”
这段文字不是注释，而是Memories模块的原始输入源。CodeBuddy会在每次会话开始时自动加载它，并在生成代码前做语义对齐校验。
保存后别忘了执行codebuddy --reload-memories强制刷新内存缓存。不执行这步，新写的约束永远不会生效。
绑定斜杠命令触发专属工作流
要想让操作更顺滑，可以创建.codebuddy/commands/fullstack.slash，内容如下：
/api-gen
→ 调用fullstack-dev智能体
→ 根据project-context.md中定义的Spring Boot版本生成Controller+Service+Repository三层代码
→ 自动添加Swagger @Operation注解和@Valid校验
→ 同步生成对应React Axios调用示例
这个斜杠命令一旦注册，你在VS Code中输入/api-gen /users POST，CodeBuddy就会跳过通用模式，直连fullstack-dev智能体执行完整链路。命令名/api-gen必须以斜杠开头，且全局唯一。若已存在同名命令，新注册的会被静默覆盖，不会提示冲突。
配置MCP协议打通本地开发服务
最后一步，编辑.codebuddy/mcp/config.json，声明两个关键服务：
① 数据库服务："database": { "type": "postgresql", "connection": "postgresql://localhost:5432/myapp" }
② 前端开发服务器："vite-server": { "type": "http", "url": "http://localhost:5173" }
这两项配置让fullstack-dev智能体在生成代码时能实时校验表结构是否存在、接口路径是否已被占用。比如你让它生成/orders接口，它会先向vite-server发探测请求，发现已有同名路由就自动改用/api/orders。配置完成后运行codebuddy --mcp-enable启用协议。未启用状态下，MCP服务声明只是静态文本，不会触发任何联动。
激活智能体并验证响应一致性
配置做完，总要验证一下效果。在项目任意代码文件中右键，选择「Ask CodeBuddy」，输入：用fullstack-dev帮我生成一个带分页查询的用户列表API，返回JSON格式，包含id、name、email字段
那就来看看结果是否满足三个硬性条件：
1. Controller类使用@RestController而非@Controller；
2. Repository接口继承JpaRepository；
3. 前端示例代码中Axios请求URL带/api/users?page=1&size=10参数。
三项全部命中，说明专属智能体已成功接管全栈生成逻辑。