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

在 GitHub 打开 ↗
SKILL.md从 GitHub 加载中…

目录结构

技能结构

在 GitHub 打开 ↗
  • skills/codebase-design/
  • root
    • ·DEEPENING.md
    • ·DESIGN-IT-TWICE.md
    • ·SKILL.md

按 Agent Skills 规范,必需项仅 SKILL.md;其余目录均为可选的脚本 / 引用 / 资源扩展。