必须通过配置层将开发规范转化为AI可执行规则：1. 修改.settings.json绑定规范文件；2. 在.rules目录下编写自然语言硬性约束；3. 用Claw设置全局Prompt前缀；4. 用Skill脚本嵌入结构化模板。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让CodeBuddy输出的代码严格匹配团队已发布的《前端/后端/全栈开发规范》，必须绕过默认模型偏好，将规范转化为AI可执行、可校验、可继承的配置层。手动改提示词或临时加备注无法覆盖补全、重构、日志生成等全部场景，必须在配置系统中锚定规则源头。
修改项目级 .codebuddy/settings.json 绑定规范
这是最直接生效的方式，适用于新成员入职即用、CI/CD流水线自动识别的标准化场景。
1、在项目根目录创建 【.codebuddy/settings.json】 文件（若不存在）。
2、写入以下结构，其中 "style_guide" 字段必须指向团队已托管的规范定义文件路径，支持本地相对路径或HTTP URL：
{<br> "language": "简体中文",<br> "style_guide": "./.codebuddy/team-frontend-v3.json",<br> "model": "gpt-5",<br> "permissions": { "deny": ["Bash(curl:*)"] }<br>}
3、确保 【.codebuddy/team-frontend-v3.json】 文件已存在且格式合法——它必须包含 naming_convention、indentation、comment_style 等键，否则CodeBuddy启动时会静默忽略该配置并回退到全局默认。
在 .codebuddy/rules 目录下编写自然语言硬性约束
当规范中存在“禁止”“必须”“严禁”等不可协商条款时，仅靠 settings.json 无法触发实时拦截，需用 rules 机制划出红线。
方法一：项目级日志规范强制落地
1、在项目根目录新建 【.codebuddy/rules/log-standards.md】。
2、写入明确指令：“所有新生成的日志语句必须包含 timestamp、level、trace_id、event 四个字段；error 级别仅用于不可恢复异常；warn 不得出现在用户注册流程中”。
3、保存后，下次调用 CodeBuddy 的 Craft 功能生成日志时，AI 将自动拒绝输出缺失字段或越界 level 的代码。
方法二：Java 阿里规约关键项注入
1、在相同目录下新建 【.codebuddy/rules/alibaba-java-core.md】。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、写入：“禁止使用 SimpleDateFormat 实例变量；所有日期格式化操作必须封装在 ThreadLocal 中；@Service 类必须以 Impl 结尾；布尔类型 getter 方法不得加 get 前缀”。
3、无需重启或重载，规则文件保存即被监听，后续所有 /init 或 /fix 操作都会实时校验输出是否触碰这些红线。
通过 Claw 设置全局 Prompt 前缀统一上下文
该方式不修改任何文件，专为跨项目、跨仓库但归属同一团队的开发者设计，确保即使打开一个空文件夹，输入“写个登录接口”也会自动带上团队语境。
第一步：进入 Claw 会话增强设置
点击 WorkBuddy 右上角头像 →「Claw 设置」→「会话增强」。
第二步：粘贴并启用前缀
启用「全局Prompt前缀」开关，在输入框中粘贴团队标准前缀，例如：“你正在为[金融中台]编写生产环境 Java 代码，必须遵守：① 所有 DTO 字段加 @NotNull 注解；② Controller 层禁止出现业务逻辑；③ 每个 Service 方法开头必须调用 traceId.get() 并记录到 MDC”。
第三步：推送至团队设备
勾选「同步至绑定IM端（企业微信/飞书）」→ 点击「保存并推送至团队设备」。系统将在 30 秒内将该前缀广播至所有已登录同一腾讯账号的终端，旧会话需手动刷新生效。
用 Skill 脚本嵌入结构化 Prompt 模版
这是粒度最细、控制力最强的方式，适用于对某类技能（如 code-gen、log-gen）做深度定制，但需具备基础脚本维护能力。
1、定位到 【skills/code-gen/SKILL.md】 文件，用 VS Code 或其他编辑器打开。
2、在 prompt_template 区块内，将原始指令完全替换为团队工程师角色声明与规范锚点，例如：“你是一名银行核心系统 Java 工程师，严格遵循《XX银行Java安全编码手册v4.2》：所有 SQL 拼接必须使用 PreparedStatement；敏感字段（身份证、手机号）必须脱敏后才可 log.info；Controller 返回值统一包装为 Result
3、在 output_template 区块中，定义输出包裹结构，强制返回校验信息：“【生成代码】\n
{{code}}\n【合规检查】SQL安全:{{sql_safe}}|脱敏:{{mask_status}}|包装类型:{{result_wrapper}}”。
4、保存文件后，右键点击「code-gen」技能 → 选择「重载技能」。这一步不可跳过，否则修改不会加载进运行时引擎。
