Kiro 多工程协作与上下文引用技巧
一、为什么需要引用其他工程
在实际开发中，我们经常需要参考其他项目的实现方式，比如：
- 新项目参考已有项目的 MQ、OSS、导入导出等基础设施代码
- 同一产品线不同微服务之间共享相似的业务模式
- 想让 Kiro 根据已有实现风格来生成新代码
Kiro 默认只能访问当前工作区内的文件。如果参考代码在另一个项目中，就需要把它"带入"工作区。
注：
博客：
https://blog.csdn.net/badao_liumang_qizhi
二、将其他工程添加到工作区
操作步骤
- 点击 Kiro 顶部菜单 File → Add Folder to Workspace...
- 在弹出的文件选择器中导航到目标工程目录（如
D:\WorkSpace\test） - 选中后点击 添加
添加后当前工作区变为多根目录工作区（Multi-root Workspace），Kiro 可以同时读取所有已添加文件夹中的文件。
注意事项
- 添加后如果
#引用列表中找不到新文件夹，尝试 Ctrl+Shift+P → Reload Window 重新加载 - 多根目录工作区中，文件路径需要指定具体的工作区根目录
- 添加的文件夹仅作为参考，不影响你原项目的 Git 状态
三、在对话中引用文件和文件夹
#File --- 引用单个文件
在聊天输入框中输入 # 后选择目标文件，Kiro 会将该文件内容加载到对话上下文中。
适合场景：
- 指定某个具体文件让 Kiro 分析或修改
- 提供一个示例文件让 Kiro 模仿风格
#Folder --- 引用文件夹
输入 # 后选择文件夹，Kiro 会将该文件夹结构（和部分内容）加载到上下文。
适合场景：
- 让 Kiro 了解某个模块的整体结构
- 提供参考工程的目录布局
#Problems --- 引用当前文件的诊断问题
让 Kiro 看到你当前文件中的编译错误或警告，便于定位和修复问题。
#Terminal --- 引用终端输出
让 Kiro 看到命令行输出，比如构建错误、测试失败日志等。
#Git Diff --- 引用当前的改动
让 Kiro 看到你当前未提交的变更，用于代码审查或继续调整。
四、直接告诉 Kiro 路径
如果 # 引用列表中找不到目标，可以直接在对话中告诉 Kiro 完整路径：
请参考 D:\WorkSpace\test 这个工程中的导入实现只要该路径对应的文件夹已经在工作区中，Kiro 就能直接用 listDirectory、readFile 等工具去读取。
五、拖拽附件
图片
直接拖拽图片到聊天输入框，或点击附件图标。适合：
- 提供页面原型图/UI 设计稿
- 展示错误截图
- 分享架构图
文档（PDF、DOCX 等）
同样拖拽或点击附件添加。适合：
- 需求文档
- 接口规格说明
- 设计方案
六、多工程协作的最佳实践
| 场景 | 推荐做法 |
|---|---|
| 参考另一个项目的某类实现 | Add Folder to Workspace，然后让 Kiro 去搜索和阅读 |
| 只需参考 1-2 个文件 | 直接把文件内容拖入聊天更快 |
| 需要 Kiro 批量对比多个项目 | 将所有相关项目加入工作区 |
| 参考完毕不再需要 | 右键工作区中的文件夹 → Remove Folder from Workspace |
# 列表刷新不出来 |
Ctrl+Shift+P → Reload Window |
七、使用技巧汇总
- 先描述需求，再逐步补充细节：像对话一样，先发原型图，再发字段说明，最后确认技术方案。Kiro 会持续积累上下文。
- 让 Kiro 统一提问：描述完所有需求后再让 Kiro 提问，效率比边说边问高。
- 逐步确认再生成代码：不要一开始就让 Kiro 写代码，先确认表结构和方案，再动手。
- 利用多工作区做代码风格参考：Kiro 会自动匹配参考工程的命名风格、注解用法、依赖版本。
- 修改方案时直接说明变更：比如"把 RabbitMQ 改为线程池"，Kiro 能定向修改相关代码，不需要从头重写。
- 善用 Steering 文件固化规范 ：在
.kiro/steering/下放团队编码规范，这样每次 Kiro 写代码都会自动遵守，不需要重复说明。