代码库设计：深度模块设计指南
提供深度模块设计的共享词汇与原则，帮助定义接口、改进模块设计、提升可测试性和可导航性。
该技能仅提供概念框架和设计原则，不执行外部操作、不接触敏感数据、不产生不可逆副作用，因此信任风险低。未发现权限越权或隐蔽行为。但技能未明确要求用户确认或提供回滚机制（尽管其本质是指导性而非操作性的），且未提供可验证的来源归属，因此扣除部分分数。
技能指令在文本层面自洽，词汇表清晰，流程描述合理，可复现性依赖用户遵循。但未提供测试套件或自动化验证，关键路径在实际代码库上的表现未经验证；对异常输入（如无依赖场景）的处理缺乏明确指导，失败反馈机制不明确。鉴于静态审查，只给部分分数。
技能适用于设计或改进模块接口、寻找深化机会、决定接缝位置等场景，目标受众明确（软件工程师）。但能力边界和非适用场景仅部分阐述（如未说明何时不应使用），触发条件依赖用户自行判断，缺乏明确的门控。环境适配方面未考虑中文支持或大陆网络可达性，但核心功能不依赖海外服务，因此给中等分数。
文档结构良好，有词汇表、原则、示例（代码块）、关于进一步阅读的链接。许可证为MIT，版本化管理在仓库和package.json中体现，但技能本身未声明独立版本或变更日志。维护责任由作者承担，更新路径通过发布会自动进行。但缺少常见问题解答和已知限制的明确披露，因此给中等分数。
技能提供的框架和流程清晰，能指导用户完成模块设计改进，但输出形式是指导性建议而非直接可用的代码或文件，用户仍需自行应用。边际价值明显（避免重复发明概念），但成本效益比未量化。静态审查无法验证实际效果，因此给适中分数。
技能内容基于Ousterhout等外部原则，但未提供可验证的测试或案例研究。仓库有CI工作流，但未针对技能关键路径运行测试。因此只有少量可审计材料，给低分。
- 该技能仅提供概念框架，具体实施效果需用户自行验证。
- 技能未提供明确的失败处理和边界说明，在复杂代码库中可能误触发。
- 技能假设用户熟悉Ousterhout的深模块理论，新手可能难以直接应用。
- 仓库包含其他技能，但本技能未提供独立版本号或变更日志，维护追踪可能困难。
这个 Skill 能做什么，适合哪些场景？
这是一个面向软件工程师的模型调用技能，用于在设计和改进模块时统一使用“深度模块”的设计语言。它定义了模块、接口、实现、深度、接缝等核心词汇，并给出深度与浅度模块的对比、设计原则和可测试性建议。技能本身不执行具体命令，而是作为设计决策的参考框架。适合在需要定义接口、寻找深化机会、决定接缝位置或提升代码可测试性的场景中使用。
提供一个术语表，要求使用精确词汇（如模块、接口、深度）描述设计；展示深度与浅度模块的ASCII示意图；列举设计原则（如删除测试、接口即测试表面）；提供可测试性设计建议（接受依赖、返回结果、小表面积）；说明模块、接口、深度、接缝、适配器之间的关系；明确拒绝的框架（如以代码行数比衡量深度）。
- 当你想为某个模块设计或改进其接口时，使用此技能统一术语和原则。
- 当你要在一个大型代码库中寻找深化机会时，借助技能中的删除测试和深度定义来评估模块。
- 当决定在何处放置接缝时，参考技能中的接缝定义和适配器原则。
- 当编写单元测试时，依据技能中的可测试性设计建议来调整模块接口。
- 当其他技能需要引用深度模块词汇时，此技能作为共享语言的基础。
这个 Skill 有哪些优点和局限？
- 提供精确术语，减少沟通歧义。
- 基于成熟的软件设计原则（如深度模块）。
- 适用范围广，从函数到系统切片均可。
- 强调可测试性和可导航性，实用性强。
- 未附测试或示例代码，需自行验证概念。
- 仅提供框架，不自动评估代码，需人工应用。
- 术语可能与已有工作流冲突，需适应。
- 部分原则（如删除测试）需要判断力，可能不适用于所有场景。
如何安装这个 Skill？
此技能位于mattpocock/skills仓库的skills/engineering/codebase-design/目录。可通过skills.sh安装器安装整个技能集：npx skills@latest add mattpocock/skills，或作为Claude Code插件安装（/plugin marketplace add mattpocock/skills）。
如何使用这个 Skill？
将技能目录放入Agent的skills文件夹，或在支持Agent Skills标准的客户端中启用。当设计或审查代码时，引用技能中的术语和原则，例如在对话中询问“这个模块的深度如何？”。技能本身不提供命令，需结合具体设计任务使用。