一句话解释

抽象屏障是上层和底层之间的稳定接口,让上层不需要知道底层怎么实现。

小白比喻

你按电梯按钮,不需要知道电机、钢缆和控制器怎么协作;按钮就是屏障。

第一性原理

屏障把可变实现隔离在内部,把稳定契约暴露给外部。

为什么 AI Coding 时代必须懂

给 AI 暴露太多底层 API,会让它误用权限、绕过校验、重复执行副作用操作。

商业项目事故

让模型直接调用 update_user_balance,结果它在退款重试时重复改余额。

指挥 Codex 时应该怎么问

请把这些底层接口重构成面向任务的工具接口,并标明参数、权限、副作用和失败路径。

任务卡里应该怎么写

只允许 Codex 调用稳定任务接口,不允许绕过业务校验直接改数据库。

验收标准怎么写

上层调用不依赖数据库表结构;底层实现替换后,上层测试仍通过。

错误指令

把所有数据库表和内部接口都给 AI,让它自己判断。

合格指令

只给 AI 暴露 createRefundRequest、checkRefundEligibility 这类面向任务的工具。

哪些课程会用到它