CodeBuddy 提供三种需求输入方式：原型截图、文字描述或 CLI 命令。如果您希望 AI 直接生成可运行的代码，而无需手动编写多个文件再拼凑逻辑——那么必须理解需求输入方式、AI 理解路径以及代码落地机制，三者缺一不可。
具体而言，第一步是确保项目根目录已打开，这样 AI 才能识别上下文（例如 package.json 或 tsconfig.json）。否则生成的代码很可能缺少依赖声明或路径错误，导致无法直接运行。
明确需求输入形态与入口
先判断当前需求处于哪个阶段：如果是墨刀原型或 Figma 截图，优先使用 CodeBuddy IDE 打开；如果是文字描述（例如“开发一个带登录和商品列表的 React 管理后台”），直接在 VS Code 插件侧边栏输入框中粘贴即可；如果是命令行环境且已进入项目目录，运行codebuddy后选择“Craft 模式 → Plan mode”启动。
【必须确保当前工作目录是项目根目录，否则 AI 无法识别 package.json 或 tsconfig.json 等上下文信息，生成的代码可能缺少依赖声明或路径错误】
操作非常简单，直接将文件拖拽进去即可完成。
触发需求拆解与计划生成
选定入口后，输入完整需求描述，例如：“开发一个支持 JWT 登录、用户角色权限控制、商品 CRUD 的 Spring Boot 后台服务，数据库使用 MySQL，返回 RESTful JSON 接口”。
按下回车或点击“生成计划”，CodeBuddy 会自动进入 Plan 阶段，输出结构化任务清单：
① 创建 User、Role、Permission、Product 实体类
② 设计 JWT 认证过滤器与登录接口
③ 实现基于注解的 RBAC 权限校验逻辑
④ 编写 ProductController 及对应 Service、Mapper 层
⑤ 配置 application.yml 中的数据库连接与 JWT 密钥
但请注意：此时不要跳过人工审查——AI 可能将“角色权限控制”默认实现为内存 Map 缓存，而您的生产环境要求 Redis 同步校验，必须在此阶段指出并让 AI 重写该子任务。
执行代码生成并绑定项目 Skill
确认计划无误后，点击“开始执行”或输入指令/execute，AI 将按顺序逐个完成文件创建与修改。
方法一：IDE 版自动新建模块
AI 会在项目中新建src/main/java/com/example/auth等包路径，生成带 Lombok 注解的实体类、含 Swagger 文档的 Controller、带@PreAuthorize 注解的 Service 方法，并自动补全 pom.xml 依赖项（例如 spring-boot-starter-security、mybatis-spring-boot-starter）。
方法二：CLI 版定向生成单文件
在终端输入：codebuddy generate --file src/main/java/com/example/product/ProductController.java --template rest-controller，强制 AI 只生成控制器文件，避免影响已有代码结构。
【生成前务必检查 AI 是否识别出项目已使用的框架版本，比如 Spring Boot 3.2.x 需适配 Jakarta EE 命名空间，若 AI 按旧版 javax.* 生成会导致编译失败】
审查与迭代修改代码
AI 生成完成后，立即打开关键文件查看逻辑完整性：重点检查 Controller 层是否有@Valid 参数校验、Service 层事务边界是否合理、Mapper XML 中 SQL 是否带防注入占位符。
发现异常时，不要直接删除代码重来——选中问题代码块，在 CodeBuddy 对话框中输入：“这个 saveProduct 方法没有做库存校验，请在调用 productMapper.insert 前加入 checkStock() 调用，并抛出 BusinessException”，AI 会精准定位并修改该函数。
这一步不能跳过，否则联调时才发现事务未生效，就需要倒查三层代码。
启动本地服务验证结果
在 IDE 中点击绿色三角形运行按钮，或 CLI 中执行mvn spring-boot:run。
访问http://localhost:8080/swagger-ui.html确认接口文档自动生成；用 Postman 调用POST /api/v1/login传入测试账号，观察是否返回 JWT token 及 HTTP 状态码是否为 200。
若返回 500 且日志提示“No qualifying bean of type 'xxxMapper'”，说明 AI 生成的 Mapper 接口未被@MapperScan 扫描到——此时回到 application.java，手动添加@MapperScan("com.example.mapper")即可。