My Knowledge Tree
我对「抽象屏障」的掌握
还没有本地学习记录。
双语术语 / Bilingual Term
- 中文
- 抽象屏障
- English
- Abstraction Barrier
- Aliases
- Interface Boundary
一句话解释
抽象屏障是上层和底层之间的稳定接口，让上层不需要知道底层怎么实现。
小白比喻
你按电梯按钮，不需要知道电机、钢缆和控制器怎么协作；按钮就是屏障。
具体例子 / Concrete Example
退款页面不应该直接改订单表、余额表、积分表。它只调用 requestRefund(orderId, reason)。这个接口内部负责检查资格、写退款单、通知支付渠道。页面不知道底层细节，底层也可以安全演进。
第一性原理
屏障把可变实现隔离在内部，把稳定契约暴露给外部。
为什么 AI Coding 时代必须懂
给 AI 暴露太多底层 API，会让它误用权限、绕过校验、重复执行副作用操作。
商业项目事故
让模型直接调用 update_user_balance，结果它在退款重试时重复改余额。
指挥 Codex 时应该怎么问
请把这些底层接口重构成面向任务的工具接口，并标明参数、权限、副作用和失败路径。任务卡里应该怎么写
只允许 Codex 调用稳定任务接口，不允许绕过业务校验直接改数据库。
验收标准怎么写
上层调用不依赖数据库表结构；底层实现替换后，上层测试仍通过。
错误指令
把所有数据库表和内部接口都给 AI，让它自己判断。
合格指令
只给 AI 暴露 createRefundRequest、checkRefundEligibility 这类面向任务的工具。