mcpField
C
code-simplifier

code-simplifier

github.com/caarlos0开发22563 次安装1 天前更新
代码仓库

关于 code-simplifier

用于精简已完成代码改动的技能,要求保持行为和公共接口不变。它引导按仓库规范及语言指南进行有针对性的清理。

主要功能

  1. 01对照基线检查改动
  2. 02保持行为和 API 不变
  3. 03移除不必要的抽象
  4. 04遵循仓库及语言指南
  5. 05避免无关清理

适用场景

  1. 01实现完成后精简代码
  2. 02移除改动遗留的孤立代码
  3. 03检查失实的注释和文档
  4. 04将重构限制在相关差异内

安装

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

$npx skills add https://github.com/caarlos0/dotfiles --skill code-simplifier

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

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

languages/
css.md
go.md
javascript.md
python.md
rust.md
typescript.md

详细介绍

代码简化

行为正确后再运行。仓库说明以及正确性或语言专家的要求优先;输出风格技能只影响呈现方式。

范围

只检查当前改动与其基准版本之间的差异。仅在需要移除因本次改动而成为孤立项的代码,或修正文中因本次改动而失实的内容时,才查看差异之外的引用。

阅读仓库说明以及 languages/ 下对应的指南:

  • TypeScript:languages/typescript.md
  • JavaScript:languages/javascript.md
  • Go:languages/go.md
  • Rust:languages/rust.md
  • Python:languages/python.md
  • CSS:languages/css.md

检查

  • 保留 API、签名、输出和行为。
  • 移除不必要的间接层、仅使用一次的抽象、重复分支,以及只是复述代码的注释。
  • 优先使用清晰的语句,而非巧妙的表达式。
  • 如果提取代码会掩盖行为,则保留少量有意的重复。
  • 使用标准库,不要添加依赖。
  • 除非调用方有需要,否则保持私有可见性。
  • 更新因本次改动而失实的注释、文档、错误信息和名称。
  • 绝不要添加解释改动内容的注释,例如说明删除、重命名或与之前做法不同之处。这些内容应写在提交说明或 PR 描述中。如有此类注释,应将其删除。
  • 注释应简短,且仅说明代码本身无法体现的内容,例如隐含约束或不明显的原因。不要解释一目了然的代码。
  • 删除看似未使用的代码前,先在仓库中搜索;检查测试、注册逻辑、反射、配置键和公共使用方。
  • 仅在合法重构后为保持覆盖率确有必要时才更新测试。不要削弱断言或更改预期行为。

不要重新排列导入,不要将无关清理混入差异,也不要重新设计可正常工作的 API。如果简化会大幅扩大差异,就保持代码不变,并说明原因。

使用实现阶段已运行的验证。只有当本轮检查修改了该验证未覆盖的内容时,才运行额外的针对性检查。绝不要暂存或提交。

评论

支持 Markdown