要构建专属全栈开发智能体，需依次完成四步：定义角色与能力边界（新建.fullstack.yaml并规范命名）、注入项目上下文记忆（编辑project-context.md并执行--reload-memories）、绑定斜杠命令触发工作流（创建fullstack.slash）、配置mcp协议打通本地服务（编辑config.json并启用--mcp-enable），最后通过右键调用验证响应一致性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让CodeBuddy真正理解你的项目技术栈、编码习惯和团队规范，不再每次写代码都得重复解释Spring Boot版本、Lombok开关状态或Vue3组合式API偏好，必须跳过基础配置，直接构建专属全栈开发智能体。
定义智能体角色与能力边界
打开项目根目录，新建.codebuddy/agents/fullstack.yaml文件。这个路径是CodeBuddy识别自定义Agent的强制约定，放错位置将导致加载失败。
在文件中写入核心角色声明：
name: fullstack-dev<br>description: 专精React 18 + TypeScript前端、Spring Boot 3.2后端、PostgreSQL数据库的全栈开发智能体<br>capabilities:<br> - frontend-generation<br> - backend-api-design<br> - database-migration<br> - 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 <endpoint><method><br>→ 调用fullstack-dev智能体<br>→ 根据project-context.md中定义的Spring Boot版本生成Controller+Service+Repository三层代码<br>→ 自动添加Swagger @Operation注解和@Valid校验<br>→ 同步生成对应React Axios调用示例</method></endpoint>
这个斜杠命令一旦注册，你在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<user long></user>；
3. 前端示例代码中Axios请求URL带/api/users?page=1&size=10参数。
三项全部命中，说明专属智能体已成功接管全栈生成逻辑。
