关于 codebase-design
用于围绕清晰模块边界和显式请求流程组织代码的软件设计技能。它指导开发者划分处理器、服务、仓储和适配器的职责,并避免不必要的层次。
主要功能
- 01划分处理器、服务和仓储
- 02通过适配器隔离外部系统
- 03将规则放在调用方自然经过的位置
- 04优先采用显式流程而非隐藏行为
- 05删除推测性层次和无用配置
适用场景
- 01在代码变更中规划行为归属
- 02评估拟议的模块边界是否合理
- 03精简不变化或没有实际价值的层次
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ darknesskiller/ skills --skill codebase-design安装后在 Claude Code 中输入/codebase-design确认已加载。
附带文件agents/openai.yaml
详细介绍
代码库设计
优先采用深模块:在清晰的边界后封装有用的行为,并提供简洁的接口。
默认流程
处理器 → 服务 → 仓库。处理器负责转换协议相关内容(保持轻量)。服务负责业务规则和编排。仓库只负责持久化。适配器用于隔离外部系统。
规则
- 除非变更明确涉及调整边界,否则保留现有边界。
- 将规则放在所有调用方自然经过的位置。
- 优先采用明确的请求流程,而非隐藏的魔法。
- 删除推测性分层、仅使用一次的接口,以及针对永远不会变化的值的配置。
- 如果仓库中有
CONTEXT.md,则使用其中的词语为领域概念命名。
完成标准:每项变更后的行为都有明确且自然的归属,调用方会经过预期的边界,并且新边界比旧边界更易于测试。
评论
支持 Markdown