Agent Skills
返回列表
💻

出海助手-代码架构设计

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 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 的共用评判标准