CodeBuddy 提升业务理解准确性的四种文档注入方法：一、粘贴结构化文档片段至提示词；二、通过 IDE 文件关联自动加载规范命名文档；三、用 CLI --context 参数批量注入多文档；四、构建带锚点标记的轻量索引并关键词引用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 CodeBuddy 进行开发时发现 AI 生成的代码与业务逻辑偏差较大，可能是因为 AI 缺乏对项目专属语义、领域术语和流程规范的上下文感知。项目文档是承载这些关键信息的核心载体。以下是将项目文档有效注入 CodeBuddy 工作流，从而提升 AI 对业务需求理解准确性的多种方法：
一、将结构化文档片段直接粘贴至提示词上下文
CodeBuddy 的提示词解析机制支持实时融合用户输入的文本内容。将当前任务强相关的文档段落（如 PRD 中的功能描述、接口字段说明、状态流转图文字版）前置粘贴到提示词中，可显著增强 AI 对业务边界的识别能力。
1、打开项目所在目录下的 requirements_v2.md 文件，定位至“订单履约状态机”章节。
2、复制该章节全部文字（含状态枚举值、触发条件、禁止跳转路径等约束说明）。
3、在 CodeBuddy 的 Chat 或 Craft 输入框中，先粘贴该段文字，再输入指令，例如：“基于以上状态机规则，为 OrderService.java 补充 updateStatus() 方法，禁止从 ‘已发货’ 直接回退至 ‘待支付’”。
二、利用 CodeBuddy IDE 的文件关联功能自动加载文档
CodeBuddy IDE 能主动扫描当前工作区中的常见文档文件（如 README.md、API_SPEC.yaml、DOMAIN_MODEL.txt），并在生成代码时将其作为隐式上下文参与推理。该机制无需手动粘贴，但依赖文档命名与位置的规范性。
1、确保项目根目录下存在名为 DOMAIN_MODEL.txt 的纯文本文件，其中明确定义了核心实体（如 Customer、Order、Shipment）及其属性、关系与业务含义。
2、在编辑 OrderController.java 时，右键选择 “Ask CodeBuddy about this file”。
3、在弹出的提示框中输入：“生成一个校验订单收货地址合法性的服务方法”，系统将自动关联 DOMAIN_MODEL.txt 中关于 Address 结构的定义，并输出符合字段约束的校验逻辑。
三、通过 CLI 命令显式注入多文档上下文
CodeBuddy code CLI 支持使用 --context 参数批量加载多个文档文件，适用于跨模块重构或端到端功能开发场景。该方式可绕过 IDE 界面限制，确保 AI 在处理复杂任务时获得完整知识基底。
1、在终端中进入项目根目录，执行命令：codebuddy code --context docs/API_SPEC.yaml --context docs/BUSINESS_RULES.md "重构 payment-service 中的 refund flow，需满足 API_SPEC.yaml 第 3.2 节与 BUSINESS_RULES.md 第 5 条"。
2、等待 CLI 完成上下文加载与分析，确认输出日志中显示 “Loaded 2 context files (128KB)”。
3、查看生成的 RefundProcessor.java，验证其是否引用了 API_SPEC.yaml 中定义的 refund_reason_code 枚举及 BUSINESS_RULES.md 中规定的时效阈值。
四、构建轻量级文档索引并启用关键词锚定
当项目文档体量较大且分散时，AI 易因信息过载而忽略关键约束。通过在文档中添加标准化锚点标记（如 [RULE-ORDER-007]），再于提示词中明确引用，可强制 AI 锁定特定条款进行推理。
1、在 docs/BUSINESS_RULES.md 中，为“优惠券叠加规则”条目添加唯一标识：[RULE-PROMO-004]：同一订单仅允许使用一张平台通用券与一张店铺定向券，不可叠加使用同类型券。
2、在 CodeBuddy 提示词中写入：“请为 CouponService.java 实现 applyCoupons() 方法，严格遵循 [RULE-PROMO-004] 约束，返回冲突提示而非静默丢弃”。
3、确认生成代码中包含对 couponType 字段的分组计数逻辑及对应错误码抛出分支。
