Kiro 日常编码流程(Bug 修复 / 小功能 / 小优化)参考
一、流程总览
| 阶段 | 核心动作 | 模式 |
|---|
| 1. 定位问题 | 复现 bug / 明确改动范围 | 人工 |
| 2. 拉上下文 & 描述任务 | #File / #Folder 拉代码,描述任务 | Vibe Chat + Supervised |
| 3. Review 代码 | 逐次审查 Kiro 生成的 diff | Supervised(逐次确认) |
| 4. 本地验证 | 跑测试 + PMD | 人工 |
| 5. 提交 | git commit & push | 人工 |
二、详细流程图
三、不同场景的开发流程选择推荐-参考
| 场景 | 推荐流程 | 说明 |
|---|
| Bug修复,小优化调整, 改动文件很少,不涉及新表/新接口 | Vibe 或者 轻量 spec 日常小优化/Bug 修复场景的建议开发流程 | bug 修复、小优化、配置调整,参见 kiro-daily-dev-workflow.md |
| 新需求开发, 改动文件多,或跨模块 | 完整 Spec 流程服务端标准需求开发流程 | 参见 kiro-backend-dev-workflow.md |
四、上下文拉取技巧
| 场景 | 推荐方式 | 示例 |
|---|
| 知道具体文件 | #File | #File ExamSessionAnswerService.java |
| 知道目录但不确定文件 | #Folder | #Folder service/newexam/ |
| 完全不确定哪些文件相关 | #Codebase | 让 Kiro 自己搜索相关代码 |
| 需要参考已有类似实现 | #File 拉参考文件 | 拉一个类似的 Service 作为参考 |
| 涉及数据库表 | #File 拉 Model + Dao | 同时拉 Model 和对应的 Dao |
五、任务描述模板
好的描述应该包含:问题是什么 + 在哪里 + 期望结果
# Bug 修复模板
修复 [Service名].[方法名]() 中的 [问题描述]。
当 [触发条件] 时,[当前行为],期望 [正确行为]。
参考 #File [相关文件]
# 小功能模板
在 [Service名] 中新增 [方法名],用于 [功能描述]。
入参:[参数说明],返回:[返回说明]。
参考 #File [类似实现的文件]
# 小优化模板
优化 [Service名].[方法名]() 的 [优化点]。
当前问题:[性能/可读性/规范问题]。
参考 #File [相关文件]
六、Review 检查清单
| 检查项 | 说明 |
|---|
| 分层规范 | Service 层没有直接用 LambdaQueryWrapper |
| 命名规范 | createBy 不是 creator,RequestXXX / ResponseXXX |
| 注释完整 | 类、方法、字段都有注释 |
| 无硬编码 | 没有硬编码字符串写入 Map |
| 无循环 IO | for 循环中没有数据库操作、RPC 调用 |
| 对象拷贝 | 使用 mapstruct,不用 BeanUtil |
| DAO 规范 | 没有直接使用 DAO 查出的列表做流式操作 |
| 基类继承 | 实体类继承了正确的 BaseModel 子类 |
七、角色职责
程序员
| 阶段 | 职责 |
|---|
| 1. 定位问题 | 复现 bug,明确改动范围,判断走哪个流程 |
| 2. 拉上下文 | 选择合适的上下文方式,清晰描述任务 |
| 3. Review | 逐次审查 diff,确保符合规范 |
| 4. 本地验证 | 跑测试和 PMD |
| 5. 提交 | commit & push |
🤖 Kiro AI
| 阶段 | 职责 |
|---|
| 2. 生成代码 | 参考 steering 规范生成代码 |
| 3. 修改代码 | 根据 Review 反馈修改 |
八、与 Spec 流程的对比
| 维度 | Spec 流程(新需求) | Chat 流程(日常编码) |
|---|
| 适用场景 | 新功能、跨模块、涉及新表/新接口 | bug 修复、小功能、小优化 |
| Kiro 模式 | Spec 模式 | Vibe Chat 模式 |
| 自主程度 | Autopilot 或 Supervised | Supervised(推荐) |
| 文档产出 | requirements + design + tasks | 无 |
| 上下文方式 | doc/ 目录文档 + steering | #File / #Folder / #Codebase |
| 审查方式 | 人工审查 Spec → 逐 task 执行 | Supervised 模式逐次 review |
| 测试 | Kiro 生成完整测试用例 | 跑已有测试 + PMD |
| 耗时 | 数小时~数天 | 数分钟~数小时 |