亚马逊推出的规格驱动开发 AI IDE——这是 Kiro 最主要的用途,也是本文讨论的前提。

下面按「现象 → 可能原因 → 处理办法」整理常见问题。

排查表

现象处理办法
AI 改动范围过大要求先给计划和文件清单,限定只改指定文件。
生成的代码引用了不存在的函数让它先搜索代码库确认 API,再写实现;运行测试验证。
越改越乱回滚到上一个可用提交,把需求拆小后重新开始。
泄露密钥的风险把密钥放在环境变量,规则文件中禁止读取 .env 等敏感文件。
测试全绿但功能不对人工补充关键用例,检查测试是否真正断言了结果。

通用排查顺序

  1. 确认账号、额度和网络状态正常。
  2. 用一份简单材料复现问题,排除材料本身的干扰。
  3. 检查设置是否被改动(模型、语言、格式等)
  4. 查看官方状态页或更新日志。
  5. 仍无法解决时整理复现步骤联系官方支持。

用标准任务做对照测试

读懂陌生代码库

输入:一个刚接手的项目仓库。

先不要改任何代码。请阅读这个仓库,输出:1)目录结构说明;2)主要模块之间的调用关系;3)本地运行步骤;4)你认为最脆弱的 3 个地方。

交付前确认:运行步骤能实际跑通。

补充练习

小功能开发

准备材料:一个清晰的需求描述。

实现以下需求:【需求】。要求:先给出实现计划和要改动的文件列表,等我确认后再写代码;遵循现有代码风格;补充必要的测试。

交付前确认:先有计划再动手。

代码审查

准备材料:一个 Pull Request 的改动。

审查这个改动,按「必须修改 / 建议修改 / 可以忽略」三级列出问题,每条附上文件和行号,重点关注安全、并发和错误处理。

交付前确认:问题定位到行。

写技术文档

适用情况:手头有一个模块的源码时。

根据源码为这个模块写 README:用途、安装、最小示例、配置项表格和常见问题。示例代码必须能直接运行。

交付前确认:示例代码可运行。

常见问题:越改越乱

回滚到上一个可用提交,把需求拆小后重新开始。

常见问题:测试全绿但功能不对

人工补充关键用例,检查测试是否真正断言了结果。

常见问题:泄露密钥的风险

把密钥放在环境变量,规则文件中禁止读取 .env 等敏感文件。

概念补充:补全(Completion)

在光标处预测下一段代码,速度快但上下文有限。

概念补充:差异审阅

在接受 AI 修改前逐个查看 diff,是最重要的安全习惯。

适合人群:设计师

设计师可以用 Kiro 处理灵感与草图、多尺寸物料适配等工作。需要注意:确认生成素材与字体的商用授权,客户未公开的项目不要上传。

适合人群:科研人员

科研人员可以用 Kiro 处理文献检索与阅读、实验记录与数据整理等工作。需要注意:遵守期刊和机构关于 AI 使用的披露要求,引用逐条核对。

适合人群:软件工程师

软件工程师可以用 Kiro 处理代码阅读与重构、测试与排错等工作。需要注意:不要把密钥和未开源代码上传到未授权工具,合并前审阅每处改动。

写在最后

本文基于 Kiro 公开的定位与通用用法编写,具体功能、套餐与可用地区以官方页面为准,产品更新后界面和名称可能变化。

所有示例输出均为示意,不代表真实统计或效果承诺;请以自己的测试结果为准。

延伸阅读