codebase-design
用途概括提供深度模块设计的共享词汇和原则,帮助设计或改进模块接口、寻找深化机会、使代码更可测试和AI可导航。
业务领域
CodingDesign
技能形态
Style Guide
所需工具
—无
语言环境
—无强依赖
包管理器
—不涉及
Agent Skill 规格描述
Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.
使用场景
两种典型用法
场景 01
重构模块接口以提升可测试性
开发者在重构一个复杂模块时,发现其接口庞大且难以测试。使用该技能,Agent可以引导开发者应用深度模块原则,识别浅层接口,通过减少方法数量、简化参数、隐藏内部复杂性来深化模块,使接口成为自然的测试表面,提升代码的可测试性和维护性。
场景 02
设计新模块时确定接缝位置
架构师在设计一个新功能模块时,需要决定在哪里放置接缝(Seam)以实现灵活性和可替换性。Agent利用该技能的词汇和原则(如'一个适配器意味着假设的接缝,两个适配器意味着真实的接缝'),帮助分析依赖关系,选择正确的接缝位置,并设计深度接口,从而为调用者提供杠杆效应,为维护者提供局部性。
技能关系
我用了哪些 Skills · 哪些 skills 用了我
依赖关系读作“上一格指向下一格”。当前 Skill 位于第二格,上下分别是影响它与被它影响的 Skill。
第一层 · 这些 Skills 用了我
- 无显式依赖
第二层 · 当前 Skill
- codebase-designStyle Guide
第三层 · 我用了这些 Skills
技能文件
SKILL.md
SKILL.md从 GitHub 加载中…
目录结构
技能结构
- ▸skills/codebase-design/
- ▸root
- ·DEEPENING.md
- ·DESIGN-IT-TWICE.md
- ·SKILL.md
按 Agent Skills 规范,必需项仅 SKILL.md;其余目录均为可选的脚本 / 引用 / 资源扩展。
同集相关