CodeBuddyAI智能体角色怎么自定义角色能力【教程】

2026-07-09AI165469

CodeBuddy可通过自定义Skills技能包、Rules规则、MCP服务和Agent角色四步实现AI行为固化:先建web-frontend技能包(含system.prompt、tools.json、workflow.py),再配置全局或项目级Vue3强制规则,接着绑定MCP服务扩展能力,最后创建高优先级Agent角色并自动触发。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想让CodeBuddy在处理前端任务时自动用Vue3+Pinia,写后端时默认套Spring Boot 3.2+WebFlux模板,查日志时主动调用ELK接口——这些不是靠反复叮嘱实现的,而是通过自定义AI智能体角色能力来固化行为模式。

创建专属Skills技能包

第一步:在项目根目录下新建文件夹 skills/web-frontend,命名必须全小写、用短横线分隔,不能含空格或中文。

第二步:在该文件夹内新建三个必需文件:system.prompt(定义角色)、tools.json(声明可用工具)、workflow.py(执行逻辑脚本)。

第三步:编辑 system.prompt,开头必须写明角色身份与核心约束,例如:
“你是一名专注 Vue3 生态的前端架构师,只使用 Composition API + Pinia + Vite 构建项目。禁止使用 Options API、Vuex 或任何非官方插件。所有组件必须支持 SSR。”

第四步:在 tools.json 中只列出当前角色真正需要调用的能力,比如:{"readFile":true,"writeFile":true,"runCommand":false,"searchWeb":false}。把不需要的能力设为 false,能显著减少幻觉输出。

第五步:将整个 web-frontend 文件夹拖入 CodeBuddy 的 Skills 管理界面 → 点击「注册技能」→ 等待状态变为「已激活」。

配置Rules规则强制生效

方法一:全局规则(影响所有会话)
打开 CodeBuddy 设置 → Rules → 新建规则 → 输入名称「Vue3强制规范」→ 在规则内容框中粘贴:
当用户提及“组件”、“页面”、“路由”或“状态管理”,必须使用 Vue3 Composition API + Pinia;禁止生成 import { ref } from 'vue' 以外的任何 Vue 2 语法;所有 setup 函数返回值必须包含 defineComponent 封装。

方法二:项目级规则(仅对当前工作区生效)
在项目根目录创建 .codebuddy/rules.yaml,写入:
rules:
 - id: "vue3-strict"
   trigger: ["src/", "views/", "components/"]
   content: "所有 .vue 文件必须使用语法,props 使用 defineProps() 声明,禁止 any 类型"

【注意】rules.yaml 必须放在项目根目录,且文件名带英文点号,大小写不可错

绑定MCP服务扩展上下文

Skills本身不连接外部系统,要让角色具备读取数据库结构或调用内部API的能力,必须通过 MCP 服务桥接。

php获得文件的mime type类

php获得文件的mime type类

下载

第一步:确认已配置好 MCP 服务端(如本地运行的 mcp-server-std),并在 CodeBuddy 设置中填入正确地址(默认 http://localhost:3000)。

第二步:在 skills/web-frontend/tools.json 中添加 MCP 工具声明:
"mcpTools": ["db-schema-reader", "api-doc-fetcher"]

第三步:重启 CodeBuddy,进入「MCP 服务管理」面板,勾选对应工具并授权访问权限。

这一步完成后,当你对AI说“根据当前数据库字段生成Vue表单”,它会自动调用 db-schema-reader 获取真实字段,而不是凭空编造。

启用Agent角色并设置优先级

第一步:打开 CodeBuddy 侧边栏 → Agents → 点击「+ 新建 Agent」。

第二步:填写基础信息:
• 名称:Vue3 Frontend Architect
• 描述:专精 Vue3 全栈前端开发,自动识别 src 目录结构并生成合规代码
• 关联 Skills:勾选刚注册的 web-frontend 技能包
• 关联 Rules:勾选「Vue3强制规范」全局规则

第三步:设置触发条件:
• 模式:Automatic(自动触发)
• 上下文匹配路径:src/**/*.{vue,ts}
• 优先级:设为 9(数字越大越优先,最高10)

第四步:点击「保存并启用」。此时只要你在 src/views/Home.vue 文件中输入注释“// 生成用户列表卡片”,AI就会以 Vue3 Frontend Architect 角色响应,不会混用 React 或 Svelte 语法。

《CodeBuddyAI智能体角色怎么自定义角色能力【教程】.doc》

下载本文的Word格式文档,以方便收藏与打印。