出海助手-代码架构设计
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_9c953624/yimubiao-codebase-design。
技能介绍
要解决什么问题
出海或长期演进的项目里,模块往往越拆越碎:调用方要记一堆 API、改一处逻辑要牵 N 个文件,测试只能 mock 半天还测不到真行为。根因常不是「没分层」,而是接口太浅——复杂度和知识都摊在调用侧,而不是收在模块内部。
本技能沿用 Matt Pocock codebase-design 的术语与原则(Module / Interface / Seam / Depth),帮你在设计或重构时用同一套语言做决策:哪里该开接缝、接口该收多小、怎样用「删除测试」判断模块是否在干活。
技能如何工作
触发后,你会用自然语言描述当前库结构或目标(例如「划分支付与订单边界」「把 Postgres 访问收成 deep module」)。技能会按下列思路引导,而不是泛泛给分层图:
- 深度(Depth):优先「小接口 + 大实现」;设计接口时追问能否减方法、减参数、把细节藏进实现。
- 接缝(Seam):接口所在位置即可替换行为之处;一个 adapter 只是假想接缝,两个 adapter 才是真实接缝——避免为不变的东西硬切边界。
- 可测试性:依赖由外注入、结果返回值而非隐式副作用;接口即测试面,跨接口测试说明模块形状可能错了。
- 删除测试:想象删掉该模块——若复杂度消失则是透传;若复杂度回到 N 个调用方,说明模块在扛活。
更深话题会指向附带资源里的 DEEPENING.md(依赖分类、接缝纪律、replace-don't-layer 测试)与 DESIGN-IT-TWICE.md(并行设计多套 radically different 接口再比 depth / locality)。
适用边界与注意点
- 面向架构设计与重构讨论,不替你做语言/框架选型清单,也不自动改仓库代码。
- 本地化版核心逻辑与原版一致;需 Notion / Slack / GitHub 等外部集成时,须按原版说明自行配置凭证。
- 文中专业术语会保留英文原词(如 bounded context 相关表述用 seam 而非混用「边界」),以保持与原版技能、参考文档一致。
使用场景
- 出海单体服务要拆支付、订单与物流,需要用统一术语划清模块接缝与对外接口
- 遗留代码里大量透传 wrapper,想用删除测试判断哪些模块该加深接口、收拢实现
- 重构前要在对话里对比两套接口设计,按 depth 与 locality 选型而不是先画分层图
- 多团队协作边界模糊,需要把「调用方必须知道的一切」写进 interface 定义再定包结构
适合人员
- 负责出海业务后端的主程,要在不增调用复杂度的前提下划分订单与履约模块边界
- 刚接手六年老仓库的技术负责人,希望用接缝与 adapter 规则规划分期还技术债
- 写集成测试却总 mock 不完的工程师,想按「依赖外注、接口即测试面」收拢数据访问层
- 在 PR 评审里反复争论「该不该再包一层」的 Tech Lead,需要 depth 与 shallow 的共用评判标准