mcpField
C
complexity-budget

complexity-budget

github.com/wilbeibi开发274 次安装1 周前更新
代码仓库

关于 complexity-budget

用于评估软件设计变更复杂度的开发技能,重点判断行为应由哪个层负责,以及新增机制是否值得其成本。适用于有争议的设计决策,而非日常修改流程。

主要功能

  1. 01定位不变量所属层
  2. 02优先组合已有函数、类型或配置
  3. 03评估复用与独立实现的取舍
  4. 04检查耦合和无效状态
  5. 05仅报告实质性权衡

适用场景

  1. 01评审新增抽象或机制是否合理
  2. 02判断重复逻辑应下沉到哪个层
  3. 03检查变更是否引入跨模块依赖

安装

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

$npx skills add https://github.com/wilbeibi/wilbeibi-skills --skill complexity-budget

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

附带文件agents/openai.yamlREFERENCE.md

详细介绍

complexity-budget

找出负责该行为的层,然后评估所提复杂性是否值得付出代价。 用这一视角审视有争议的设计选择;日常修改前无需走这套流程。

决策标准

  • 找出不变量是在哪一层确立的。在多个调用方重复修复的问题,可能应该由更底层的组件处理。
  • 在添加新机制之前,尝试组合现有函数、类型或配置。
  • 比较扩展现有行为与单独实现。合并可以减少重复,但跨越所有权或信任边界的耦合,代价可能高于少量重复代码。
  • 评估耦合和允许存在的无效状态,而非代码行数。在正确层级进行的较大改动,可能更简单。
  • 遵循项目惯用做法。在可行时,优先使用能防止无效状态的类型或构造函数。

审查拟议变更

留意新增的跨模块依赖、重复概念、共享可变状态,以及用于防范无效组合的分支。 通过将行为移至其所属层、复用基础组件、简化状态模型,或说明足以证明新增内容合理的具体结果,来解决相关问题。

只报告实质性的权衡或尚未解决的选择。不要要求逐条口头回答所有标准、采用固定的输出模板,或进行无关重构。

如需深入分析有争议的决策,请阅读 REFERENCE.md。

评论

支持 Markdown