关于 code-simplifier
用于精简已完成代码改动的技能,要求保持行为和公共接口不变。它引导按仓库规范及语言指南进行有针对性的清理。
主要功能
- 01对照基线检查改动
- 02保持行为和 API 不变
- 03移除不必要的抽象
- 04遵循仓库及语言指南
- 05避免无关清理
适用场景
- 01实现完成后精简代码
- 02移除改动遗留的孤立代码
- 03检查失实的注释和文档
- 04将重构限制在相关差异内
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ caarlos0/ dotfiles --skill code-simplifier安装后在 Claude Code 中输入/code-simplifier确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
languages/css.mdgo.mdjavascript.mdpython.mdrust.mdtypescript.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