mcpField
C
codebase-design

codebase-design

github.com/darknesskiller开发0100 次安装3 周前更新
代码仓库

关于 codebase-design

用于围绕清晰模块边界和显式请求流程组织代码的软件设计技能。它指导开发者划分处理器、服务、仓储和适配器的职责,并避免不必要的层次。

主要功能

  1. 01划分处理器、服务和仓储
  2. 02通过适配器隔离外部系统
  3. 03将规则放在调用方自然经过的位置
  4. 04优先采用显式流程而非隐藏行为
  5. 05删除推测性层次和无用配置

适用场景

  1. 01在代码变更中规划行为归属
  2. 02评估拟议的模块边界是否合理
  3. 03精简不变化或没有实际价值的层次

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/darknesskiller/skills --skill codebase-design

安装后在 Claude Code 中输入/codebase-design确认已加载。

附带文件agents/openai.yaml

详细介绍

代码库设计

优先采用深模块:在清晰的边界后封装有用的行为,并提供简洁的接口。

默认流程

处理器 → 服务 → 仓库。处理器负责转换协议相关内容(保持轻量)。服务负责业务规则和编排。仓库只负责持久化。适配器用于隔离外部系统。

规则

  1. 除非变更明确涉及调整边界,否则保留现有边界。
  2. 将规则放在所有调用方自然经过的位置。
  3. 优先采用明确的请求流程,而非隐藏的魔法。
  4. 删除推测性分层、仅使用一次的接口,以及针对永远不会变化的值的配置。
  5. 如果仓库中有 CONTEXT.md,则使用其中的词语为领域概念命名。

完成标准:每项变更后的行为都有明确且自然的归属,调用方会经过预期的边界,并且新边界比旧边界更易于测试。

评论

支持 Markdown