[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79FZP4E4YZMVT06YGMY6C9N":3,"skill-same:01M79FZP4E4YZMVT06YGMY6C9N":60},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M79FZP4E4YZMVT06YGMY6C9N","codebase-design",null,"用于设计深模块的共享词汇。用户希望设计或改进模块接口、寻找深化机会、决定接缝位置、提高代码的可测试性或 AI 可导航性，或其他技能需要深模块词汇时使用。","15102045545\u002Fskills-cn","15102045545","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F168414493?v=4","01M79FZ671W8T1KPST7GRYEG3T","xiaokeer","01M79FZ67MMMDE1RZYSQGCPWK9",1,"MIT","https:\u002F\u002Fgithub.com\u002F15102045545\u002Fskills-cn\u002Fblob\u002Fmaster\u002Fskills\u002Fengineering\u002Fcodebase-design\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: codebase-design\ndescription: 用于设计深模块的共享词汇。用户希望设计或改进模块接口、寻找深化机会、决定接缝位置、提高代码的可测试性或 AI 可导航性，或其他技能需要深模块词汇时使用。\n---\n\n# 代码库设计\n\n设计**深模块**：在清晰的接缝处，以小接口承载大量行为，并可通过该接口进行测试。凡是设计或重构代码，都应使用这套语言和原则。目标是让调用方获得杠杆效应，让维护者获得局部性，并让所有人都获得可测试性。\n\n## 术语表\n\n必须准确使用这些术语——不得替换为“component”“service”“API”或“boundary”。这套方法的核心正是保持语言一致。\n\n**模块（Module）**——任何具有接口和实现的事物。刻意不限定规模：可以是函数、类、包，也可以是跨层切片。_避免使用_：unit、component、service。\n\n**接口（Interface）**——调用方为正确使用模块而必须知道的一切：不仅包括类型签名，还包括不变量、顺序约束、错误模式、必需配置和性能特征。_避免使用_：API、signature（范围过窄——它们仅指类型层面的表面）。\n\n**实现（Implementation）**——模块内部的内容，即其代码主体。它不同于**适配器（Adapter）**：一个事物可以是实现很大的小型适配器（Postgres 仓库），也可以是实现很小的大型适配器（内存假对象）。讨论接缝时使用“适配器”，其他情况下使用“实现”。\n\n**深度（Depth）**——接口处的杠杆效应：调用方（或测试）每学习一个单位的接口，便可运用多少行为。当大量行为位于小接口之后时，模块是**深的**；当接口几乎与实现一样复杂时，模块是**浅的**。\n\n**接缝（Seam）** _（Michael Feathers）_——无需在某处直接编辑就能改变行为的位置；即模块接口所在的*位置*。接缝放在哪里本身就是一项设计决策，与接缝之后放什么不同。_避免使用_：boundary（与 DDD 的限界上下文含义重叠）。\n\n**适配器（Adapter）**——在接缝处满足接口的具体事物。它描述的是*角色*（填补哪个位置），而非实质（内部有什么）。\n\n**杠杆效应（Leverage）**——调用方从深度中获得的收益：每学习一个单位的接口，就能获得更多能力。一份实现可惠及 N 个调用点和 M 项测试。\n\n**局部性（Locality）**——维护者从深度中获得的收益：变更、缺陷、知识和验证集中在一处，而不是散布于各调用方。修复一次，处处生效。\n\n## 深与浅\n\n**深模块** = 小接口 + 大量实现：\n\n```\n┌─────────────────────┐\n│      小型接口       │  ← 方法少，参数简单\n├─────────────────────┤\n│                     │\n│      大量实现       │  ← 隐藏复杂逻辑\n│                     │\n└─────────────────────┘\n```\n\n**浅模块** = 大接口 + 少量实现（应避免）：\n\n```\n┌─────────────────────────────────┐\n│            大型接口             │  ← 方法多，参数复杂\n├─────────────────────────────────┤\n│            少量实现             │  ← 仅作透传\n└─────────────────────────────────┘\n```\n\n设计接口时，问自己：\n\n- 能否减少方法数量？\n- 能否简化参数？\n- 能否在内部隐藏更多复杂性？\n\n## 原则\n\n- **深度是接口的属性，而非实现的属性。** 深模块内部可以由小型、可模拟、可替换的部件组成——只是这些部件不属于接口。模块既可以有**内部接缝**（实现私有，供自身测试使用），也可以在接口处有**外部接缝**。\n- **删除测试。** 想象一下删除该模块。如果复杂性消失了，它只是透传层；如果复杂性重新出现在 N 个调用方中，说明它确实物有所值。\n- **接口就是测试表面。** 调用方和测试跨越同一个接缝。如果你想*越过*接口深入测试，模块的形态很可能有误。\n- **一个适配器意味着假想接缝，两个适配器才意味着真实接缝。** 除非确实有某些内容会跨接缝变化，否则不要引入接缝。\n\n## 为可测试性而设计\n\n良好的接口让测试自然而然：\n\n1. **接收依赖，不要创建依赖。**\n\n   ```typescript\n   \u002F\u002F 可测试\n   function processOrder(order, paymentGateway) {}\n\n   \u002F\u002F 难以测试\n   function processOrder(order) {\n     const gateway = new StripeGateway();\n   }\n   ```\n\n2. **返回结果，不要产生副作用。**\n\n   ```typescript\n   \u002F\u002F 可测试\n   function calculateDiscount(cart): Discount {}\n\n   \u002F\u002F 难以测试\n   function applyDiscount(cart): void {\n     cart.total -= discount;\n   }\n   ```\n\n3. **表面积要小。** 方法越少 = 所需测试越少。参数越少 = 测试设置越简单。\n\n## 关系\n\n- 一个**模块**恰好有一个**接口**（它向调用方和测试呈现的表面）。\n- **深度**是**模块**的属性，依据其**接口**衡量。\n- **接缝**是**模块**的**接口**所在之处。\n- **适配器**位于**接缝**处，并满足**接口**。\n- **深度**为调用方带来**杠杆效应**，为维护者带来**局部性**。\n\n## 不采用的表述方式\n\n- **把深度视为实现行数与接口行数之比**（Ousterhout）：这会奖励填充实现。我们改用“深度即杠杆效应”。\n- **把“接口”理解为 TypeScript 的 `interface` 关键字或类的公共方法**：范围过窄——这里的接口包括调用方必须知道的每项事实。\n- **“边界”**：与 DDD 的限界上下文含义重叠。应使用**接缝**或**接口**。\n\n## 继续深入\n\n- **根据依赖深化模块簇**——参见 [DEEPENING.md](DEEPENING.md)：依赖类别、接缝纪律，以及“替换而非叠加”的测试策略。\n- **探索备选接口**——参见 [DESIGN-IT-TWICE.md](DESIGN-IT-TWICE.md)：启动并行子智能体，以若干种截然不同的方式设计接口，然后比较深度、局部性和接缝位置。\n","# 代码库设计\n\n设计**深模块**：在清晰的接缝处，以小接口承载大量行为，并可通过该接口进行测试。凡是设计或重构代码，都应使用这套语言和原则。目标是让调用方获得杠杆效应，让维护者获得局部性，并让所有人都获得可测试性。\n\n## 术语表\n\n必须准确使用这些术语——不得替换为“component”“service”“API”或“boundary”。这套方法的核心正是保持语言一致。\n\n**模块（Module）**——任何具有接口和实现的事物。刻意不限定规模：可以是函数、类、包，也可以是跨层切片。_避免使用_：unit、component、service。\n\n**接口（Interface）**——调用方为正确使用模块而必须知道的一切：不仅包括类型签名，还包括不变量、顺序约束、错误模式、必需配置和性能特征。_避免使用_：API、signature（范围过窄——它们仅指类型层面的表面）。\n\n**实现（Implementation）**——模块内部的内容，即其代码主体。它不同于**适配器（Adapter）**：一个事物可以是实现很大的小型适配器（Postgres 仓库），也可以是实现很小的大型适配器（内存假对象）。讨论接缝时使用“适配器”，其他情况下使用“实现”。\n\n**深度（Depth）**——接口处的杠杆效应：调用方（或测试）每学习一个单位的接口，便可运用多少行为。当大量行为位于小接口之后时，模块是**深的**；当接口几乎与实现一样复杂时，模块是**浅的**。\n\n**接缝（Seam）** _（Michael Feathers）_——无需在某处直接编辑就能改变行为的位置；即模块接口所在的*位置*。接缝放在哪里本身就是一项设计决策，与接缝之后放什么不同。_避免使用_：boundary（与 DDD 的限界上下文含义重叠）。\n\n**适配器（Adapter）**——在接缝处满足接口的具体事物。它描述的是*角色*（填补哪个位置），而非实质（内部有什么）。\n\n**杠杆效应（Leverage）**——调用方从深度中获得的收益：每学习一个单位的接口，就能获得更多能力。一份实现可惠及 N 个调用点和 M 项测试。\n\n**局部性（Locality）**——维护者从深度中获得的收益：变更、缺陷、知识和验证集中在一处，而不是散布于各调用方。修复一次，处处生效。\n\n## 深与浅\n\n**深模块** = 小接口 + 大量实现：\n\n```\n┌─────────────────────┐\n│      小型接口       │  ← 方法少，参数简单\n├─────────────────────┤\n│                     │\n│      大量实现       │  ← 隐藏复杂逻辑\n│                     │\n└─────────────────────┘\n```\n\n**浅模块** = 大接口 + 少量实现（应避免）：\n\n```\n┌─────────────────────────────────┐\n│            大型接口             │  ← 方法多，参数复杂\n├─────────────────────────────────┤\n│            少量实现             │  ← 仅作透传\n└─────────────────────────────────┘\n```\n\n设计接口时，问自己：\n\n- 能否减少方法数量？\n- 能否简化参数？\n- 能否在内部隐藏更多复杂性？\n\n## 原则\n\n- **深度是接口的属性，而非实现的属性。** 深模块内部可以由小型、可模拟、可替换的部件组成——只是这些部件不属于接口。模块既可以有**内部接缝**（实现私有，供自身测试使用），也可以在接口处有**外部接缝**。\n- **删除测试。** 想象一下删除该模块。如果复杂性消失了，它只是透传层；如果复杂性重新出现在 N 个调用方中，说明它确实物有所值。\n- **接口就是测试表面。** 调用方和测试跨越同一个接缝。如果你想*越过*接口深入测试，模块的形态很可能有误。\n- **一个适配器意味着假想接缝，两个适配器才意味着真实接缝。** 除非确实有某些内容会跨接缝变化，否则不要引入接缝。\n\n## 为可测试性而设计\n\n良好的接口让测试自然而然：\n\n1. **接收依赖，不要创建依赖。**\n\n   ```typescript\n   \u002F\u002F 可测试\n   function processOrder(order, paymentGateway) {}\n\n   \u002F\u002F 难以测试\n   function processOrder(order) {\n     const gateway = new StripeGateway();\n   }\n   ```\n\n2. **返回结果，不要产生副作用。**\n\n   ```typescript\n   \u002F\u002F 可测试\n   function calculateDiscount(cart): Discount {}\n\n   \u002F\u002F 难以测试\n   function applyDiscount(cart): void {\n     cart.total -= discount;\n   }\n   ```\n\n3. **表面积要小。** 方法越少 = 所需测试越少。参数越少 = 测试设置越简单。\n\n## 关系\n\n- 一个**模块**恰好有一个**接口**（它向调用方和测试呈现的表面）。\n- **深度**是**模块**的属性，依据其**接口**衡量。\n- **接缝**是**模块**的**接口**所在之处。\n- **适配器**位于**接缝**处，并满足**接口**。\n- **深度**为调用方带来**杠杆效应**，为维护者带来**局部性**。\n\n## 不采用的表述方式\n\n- **把深度视为实现行数与接口行数之比**（Ousterhout）：这会奖励填充实现。我们改用“深度即杠杆效应”。\n- **把“接口”理解为 TypeScript 的 `interface` 关键字或类的公共方法**：范围过窄——这里的接口包括调用方必须知道的每项事实。\n- **“边界”**：与 DDD 的限界上下文含义重叠。应使用**接缝**或**接口**。\n\n## 继续深入\n\n- **根据依赖深化模块簇**——参见 [DEEPENING.md](DEEPENING.md)：依赖类别、接缝纪律，以及“替换而非叠加”的测试策略。\n- **探索备选接口**——参见 [DESIGN-IT-TWICE.md](DESIGN-IT-TWICE.md)：启动并行子智能体，以若干种截然不同的方式设计接口，然后比较深度、局部性和接缝位置。\n",{"name":5,"description":7},"master","a7a44e6effe5a404eb8b622483896d79904f0c69","skills\u002Fengineering\u002Fcodebase-design",0,"https:\u002F\u002Fgithub.com\u002F15102045545\u002Fskills-cn","https:\u002F\u002Fgithub.com\u002F15102045545","软件开发工程师","2026-07-23 11:44:15",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add 15102045545\u002Fskills-cn --skill codebase-design",{"tool":38,"command":39},"bunx","bunx skills add 15102045545\u002Fskills-cn --skill codebase-design",{"tool":41,"command":42},"pnpm","pnpm dlx skills add 15102045545\u002Fskills-cn --skill codebase-design","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002F15102045545\u002Fskills-cn\u002Fblob\u002Fmaster\u002Fskills\u002Fengineering\u002Fcodebase-design\u002FSKILL.md",true,[46,52,56],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"agents\u002Fopenai.yaml","REFERENCE","参考文档",90,"https:\u002F\u002Fgithub.com\u002F15102045545\u002Fskills-cn\u002Fblob\u002Fmaster\u002Fskills\u002Fengineering\u002Fcodebase-design\u002Fagents\u002Fopenai.yaml",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"DEEPENING.md",2446,"https:\u002F\u002Fgithub.com\u002F15102045545\u002Fskills-cn\u002Fblob\u002Fmaster\u002Fskills\u002Fengineering\u002Fcodebase-design\u002FDEEPENING.md",{"path":57,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":58,"sourceHtmlUrl":59},"DESIGN-IT-TWICE.md",2705,"https:\u002F\u002Fgithub.com\u002F15102045545\u002Fskills-cn\u002Fblob\u002Fmaster\u002Fskills\u002Fengineering\u002Fcodebase-design\u002FDESIGN-IT-TWICE.md",[61,68,75,82,89,96],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M79G19FBV713ADE9Q95Y4D8E","writing-great-skills","出色编写和编辑技能的参考资料——让技能具备可预测性的词汇与原则。","https:\u002F\u002Fgithub.com\u002F15102045545\u002Fskills-cn\u002Fblob\u002Fmaster\u002Fskills\u002Fproductivity\u002Fwriting-great-skills\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M79G1888W4AQP8N9D2X0XYV4","teach","在此工作区内向用户教授新的技能或概念。","https:\u002F\u002Fgithub.com\u002F15102045545\u002Fskills-cn\u002Fblob\u002Fmaster\u002Fskills\u002Fproductivity\u002Fteach\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M79G15Z3NX0EJBP03A6VC3GJ","handoff","将当前对话压缩成交接文档，以便另一个智能体接手。","https:\u002F\u002Fgithub.com\u002F15102045545\u002Fskills-cn\u002Fblob\u002Fmaster\u002Fskills\u002Fproductivity\u002Fhandoff\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M79G14SKDFSWTADQZMQSCN9Q","grilling","围绕计划、决策或想法对用户进行不留情面的深度追问。当用户想对自己的思路进行压力测试，或使用任何“深度追问”触发措辞时使用。","https:\u002F\u002Fgithub.com\u002F15102045545\u002Fskills-cn\u002Fblob\u002Fmaster\u002Fskills\u002Fproductivity\u002Fgrilling\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M79G12NEZDVFGG45SP50P37Q","grill-me","通过不留情面的深度追问打磨计划或设计。","https:\u002F\u002Fgithub.com\u002F15102045545\u002Fskills-cn\u002Fblob\u002Fmaster\u002Fskills\u002Fproductivity\u002Fgrill-me\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":19},"01M79G1198KAG4PE1YADT2G30R","obsidian-vault","使用 wikilink 和索引笔记搜索、创建和管理 Obsidian 仓库中的笔记。当用户想要在 Obsidian 中查找、创建或整理笔记时使用。","https:\u002F\u002Fgithub.com\u002F15102045545\u002Fskills-cn\u002Fblob\u002Fmaster\u002Fskills\u002Fpersonal\u002Fobsidian-vault\u002FSKILL.md",[],[]]