终端编程智能体（CLI Coding Agent）

终端编程智能体（CLI Coding Agent）是运行在命令行环境里的编程助手。它直接在当前项目目录中读取与修改文件、执行命令、运行测试，并根据输出结果不断调整下一步动作，直到任务完成。相比只在对话里给出代码片段的助手，它更接近一个能动手推进工作的协作者，减少了人工复制与来回验证的环节，也让「改完就跑一遍」成为默认动作。

与对话式助手的区别

对话式助手只能看到被粘贴进去的片段，缺少项目全貌，也难以确认真实运行结果。终端智能体拥有工作目录的访问权，可以自行检索符号、查看依赖声明、读懂项目约定，再用命令验证自己的判断。区别的关键不在于模型更强，而在于它形成了「观察—行动—验证」的闭环：每一步都能拿到环境反馈，因而能在报错中自我修正，而不是把不确定的猜测留给使用者去试。

典型能力

• 代码读写：在项目中检索文件、按需修改代码并尽量保持改动范围最小。
• 命令执行：直接运行构建、测试与脚本，用真实输出替代主观猜测。
• 循环迭代：根据报错与测试结果自行修正，而不是一次作答就结束。
• 任务拆解：把较大需求拆成若干步骤，边做边同步进度与结论。
• 上下文维护：在多轮交互中保留项目约定与已确认的决策，避免反复确认同一件事。

实践要点

• 先做版本控制：改动前保证有可回退的基线，出现意外时能一键还原。
• 限定作用范围：明确允许它接触的目录与命令，避免误删或改动无关模块。
• 把约定写进文件：项目规则、构建方式与代码风格放进仓库内的说明文件，比每次口头交代更稳定。
• 分阶段交付：大需求拆成可验证的小步，每步都要求它跑通测试或给出验证证据。
• 关键决策留人确认：涉及架构、依赖引入与数据变更的判断应由人拍板。

常见误区

常见误区之一是把它当作能自动完成一切的替身，需求描述含糊时它只能在模糊空间里反复试探，产出看似完整却与预期偏离。之二是只看它给出的总结说明，不检查实际改动，遗漏了隐藏的破坏性修改。之三是把所有重复劳动与所有关键决策一并交出，既失去了把关，也失去了对系统的理解。合理分工是让重复的检索、修改与验证交给它，把取舍与验收留在自己手里。