未配置统一模板与规范导致风格不一致，需通过五步实现统管：一、skill脚本嵌入结构化prompt模版；二、claw配置全局prompt前缀；三、.codebuddy/rules编写硬性约束；四、接入私有知识库沉淀经验；五、分层settings.json实现多级配置覆盖。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用CodeBuddy生成代码时发现各成员输出风格不一致，如缩进方式混用、注释缺失、命名规则冲突，则很可能是未配置统一的自定义代码模板与团队规范。以下是实现团队级代码风格统管的具体操作路径：
一、通过Skill脚本嵌入结构化Prompt模版
该方法直接修改具体Skill（如code-gen）的SKILL.md文件，在prompt_template与output_template双区域同步注入风格锚点，确保模型每次调用均受同一套语法与语义规则约束，所有变量占位符需与Python脚本中return字典key严格对应。
1、定位到skills/code-gen/SKILL.md文件，用文本编辑器打开。
2、在prompt_template区块内，将原始指令替换为：“你是一名资深前端工程师，严格遵循Airbnb JavaScript规范：使用4空格缩进、驼峰式变量名、单引号字符串、函数声明前置、禁止console语句；所有代码块必须包含JSDoc注释，首行注明@file、@author team-frontend”。
3、在output_template区块中，定义输出包裹结构：“【生成代码】\njavascript\n{{code}}\n\n【风格校验】缩进:{{indent_style}}|命名:{{naming_convention}}|注释:{{jsdoc_status}}”。
4、保存文件后，在WorkBuddy主界面右键点击「code-gen」技能 → 选择「重载技能」。
二、利用Claw配置全局Prompt前缀
该方法借助Claw框架的会话级上下文注入能力，在不修改任何Skill的前提下，为整个团队账号下的所有自然语言指令自动附加标准化Prompt前缀，实现零侵入式风格统管。
1、点击WorkBuddy右上角头像 → 进入「Claw 设置」→「会话增强」。
2、启用「全局Prompt前缀」开关，并在输入框中粘贴：“你正在为[XX科技前端团队]生成生产级代码，必须遵守以下三条铁律：① 所有函数参数按ESLint no-unused-vars规则显式声明；② JSX中属性顺序固定为:key → id → className → data-* → 其他；③ 每个组件文件顶部必须包含MIT许可证声明及作者邮箱”。
三、在.codebuddy/rules目录下编写硬性约束规则文件
该方式定义AI必须执行的红线级规范，适用于变量命名、注释强制、禁用语法等不可协商条款，规则以自然语言书写，保存后立即生效，无需重启服务。
1、在项目根目录下创建.codebuddy/rules文件夹（若不存在）。
2、新建一个team-style.md文件，写入如下内容：
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 问题
“#代码规范
- 变量名使用小驼峰，常量全大写加下划线
- 函数必须有jsdoc注释
- 禁止使用var，优先const
- React组件必须定义props类型”。
3、保存后，AI即自动遵守该文件所列全部约束。
四、接入私有知识库沉淀软性经验
该方式将团队内部最佳实践作为可选参考知识注入AI推理过程，适用于组件调用偏好、业务术语解释、安全合规要求等非强制但高价值场景，需企业版支持。
1、登录CodeBuddy管控台 → 创建“知识库” → 上传团队编码规范文档、组件库说明、安全白皮书等PDF/MD文件。
2、系统自动完成向量化索引，约10–20分钟内生效。
3、上传公司特有daterangepicker组件说明后，当用户输入“生成带日期范围选择的筛选表单”，AI将直接调用该组件而非通用实现。
五、通过分层settings.json实现多级配置覆盖
该机制支持用户级、项目级、本地偏好三级配置叠加，确保个人实验不污染团队标准，项目定制不干扰全局策略，适配真实研发协作场景。
1、用户级设置写入~/.codebuddy/settings.json，对所有项目生效。
2、项目级设置写入.codebuddy/settings.json，随代码检入Git并与团队共享。
3、本地偏好写入.codebuddy/settings.local.json，自动被Git忽略，仅限个人调试使用。
4、在项目级settings.json中添加如下字段："permissions": {"deny": ["bash(curl:*)", "read(./.env)"]}，可阻止AI执行高危命令或读取敏感文件。
