S24-B01 · 认识 AI 编程工具：概念、四种入口与边界

适用读者：第一次给团队引入 AI 编程工具的人。本系列第一篇。
前置：S21-B01（Agent 定义）、S22-J03（项目模块）。
口径：工具迭代极快，本文只讲机制与判据，不写"某版本按钮在哪"。
覆盖旧文：133(386) 132(267) + 生态类 = 4,107 点。
覆盖扩展：E-S24-001（能力边界）、E-S24-002（四种入口取舍）。
下一篇：S24-B02 · 跑通第一个任务。

1. 一句话结论

AI 编程工具 = 一个受控的 Agent：它读你的代码、改文件、跑命令，但每一步都在你的权限与规则之内。看清"它能做什么"比记快捷键重要。

能力	有	无
读代码、跨文件理解	✅	—
改文件、跑测试	✅（需权限）	—
做业务决策	❌	需要你
保证正确	❌	需要测试与评审

2. 能力边界（E-S24-001）

它擅长	它不擅长
样板代码、重构、改名	判断"这个需求对不对"
按既有模式补实现	从零设计架构
解释陌生代码	保证跨模块一致性
写测试（按你的规范）	知道你没写下来的约束

判据："这活需要"知道为什么"吗？" 需要 → 你定方向；不需要 → 交给它。

"为什么边界这么重要"：误以为它能判断，就会出现"代码全对、方向全错"。

3. 四种入口的取舍（E-S24-002）

入口	适合	代价
CLI	脚本化、CI、批量	学习成本
IDE 扩展	边写边改、上下文近	受编辑器限制
桌面 App	非工程师、演示	集成弱
云端	长任务、不占本地	代码上传（合规）

判据："这段代码允许离开本机吗？" 不允许 → CLI/本地；允许且任务长 → 云端。

4. 与 S21 的对应关系

工具里的概念	S21 的对应
子代理（Subagents）	多 Agent（S21-J02）
规则与钩子（Rules & Hooks）	系统提示 + 拦截器（S22-B03）
MCP 接外部	MCP 协议（S21-B05）
权限/沙箱/审批	Harness 三件套（S21-J01）
记忆（Memories）	记忆分层（S21-B06）

"看懂这张表，就不需要重新学一遍概念"——AI 编程工具是 Agent 工程的一个具体产品形态。

5. 五个误区

误区	真相
"AI 编程 = 自动写代码"	是"受控的代码协作者"
"工具越新越好"	机制稳定，界面常变
"能跑就行，不用测试"	它不保证正确
"云端一定更方便"	代码出境/合规风险
"规则文件是形式主义"	它把要求固化成可复用约束

6. 自检

AI 编程工具的四项能力与两项"不能"？
能力边界为什么重要？
四种入口怎么选？
工具概念与 S21 的对应关系？
为什么"规则文件"不是形式主义？

7. 下一篇

S24-B02 · 跑通第一个任务：安装、CLI/IDE/桌面/云端

概念讲完，下一篇按"最快跑通"的顺序走一遍四条路。

本篇属于系列《S24 · AI 编程工具》。旧文来源：A-133/132 + 生态类卡；扩展点 E-S24-001/002。