Skip to content

Kiro CLI Git 文件选择会让 /context add 的 fuzzy finder 感知当前仓库状态。它能显示 modified、added、untracked 等 Git 标记,并根据仓库历史优先展示相关文件,适合快速把本轮改动加入 AI 编程上下文。

Kiro CLI Git 文件选择:用仓库状态快速加入上下文

在 Git 仓库中使用 Kiro CLI 时,/context add 的文件选择器会带有 Git-aware 能力。它不只是列文件名,还会结合 Git tracked files、status indicators 和历史修改记录,帮助你更快选中和当前任务有关的文件。

这对于 AI 编程很实用:当你刚改完一组文件,希望让 agent 基于这些变更继续分析或修复时,不需要手动回忆所有路径。

Git-aware selection 怎么工作

Kiro CLI 的 fuzzy finder 会读取仓库信息,并提供增强选择能力:

  • 识别仓库中 Git-tracked files。
  • 在文件旁显示 Git status indicators。
  • 根据 Git 历史和最近修改优先展示更相关的文件。

它不是替代 Git 命令,而是把 Git 状态融入上下文选择流程。

使用方式

进入 Git 仓库目录后,在 Kiro CLI chat 中运行:

text
/context add

随后会打开 fuzzy finder。文件旁可能出现这些状态标记:

标记含义
MModified files,已修改文件
AAdded files,新增到 Git 的文件
?Untracked files,未跟踪文件

你可以输入文件名、路径片段,甚至结合 Git 状态标记过滤结果。用方向键移动,按 Enter 选择要加入 context 的文件。

使用建议

  • 想审查本轮修改时,优先搜索 M
  • 想让 agent 看到新建文件时,关注 A?
  • fuzzy finder 会优先展示 Git 历史中最近相关的文件。
  • .gitignore 忽略的文件仍可能可选,但会在结果中降低优先级。

如果你只是临时引用一个文件,也可以用 File References@path。如果后续多轮都需要这些文件,再用 /context add 更合适。

和普通文件选择的差异

普通文件选择只基于路径和名称。Git-aware selection 会额外利用仓库状态,因此更适合这些场景:

  • 修复当前工作区改动引入的问题。
  • 让 agent 总结本轮修改。
  • 在 code review 前补充上下文。
  • 快速定位未跟踪的新文件。

对已经很大的仓库来说,这比手动浏览目录更快,也更不容易漏掉刚改过的文件。

常见问题

Q: Kiro CLI 会自动把所有 Git 修改加入 context 吗?

A: 不会。Git-aware fuzzy finder 只是帮助你选择文件,仍需要你在 /context add 中确认要加入哪些内容。

Q: .gitignore 里的文件还能选吗?

A: 官方说明忽略文件仍可出现,但会被降低优先级。敏感文件不应加入 context。

Q: Git-aware selection 适合什么时候用?

A: 适合你已经有一批本地改动,想让 Kiro 基于这些改动继续分析、修复或总结时使用。