一句话解释
抽象屏障是上层和底层之间的稳定接口,让上层不需要知道底层怎么实现。
小白比喻
你按电梯按钮,不需要知道电机、钢缆和控制器怎么协作;按钮就是屏障。
第一性原理
屏障把可变实现隔离在内部,把稳定契约暴露给外部。
为什么 AI Coding 时代必须懂
给 AI 暴露太多底层 API,会让它误用权限、绕过校验、重复执行副作用操作。
商业项目事故
让模型直接调用 update_user_balance,结果它在退款重试时重复改余额。
指挥 Codex 时应该怎么问
请把这些底层接口重构成面向任务的工具接口,并标明参数、权限、副作用和失败路径。 任务卡里应该怎么写
只允许 Codex 调用稳定任务接口,不允许绕过业务校验直接改数据库。
验收标准怎么写
上层调用不依赖数据库表结构;底层实现替换后,上层测试仍通过。
错误指令
把所有数据库表和内部接口都给 AI,让它自己判断。
合格指令
只给 AI 暴露 createRefundRequest、checkRefundEligibility 这类面向任务的工具。