code-groom摘要code-groom 是一个专注于代码结构梳理而非风格美化的工具。它通过五条判断原则单一数据源、单层抽象、封装、消冗余、状态找主人和七条操作规则谁产生谁持有、死代码清除等提供语言无关的代码结构自查框架帮助开发者识别冗余中间层、状态分散、函数职责过多等底层问题最终实现只改内部组织而不改变外部行为的代码优化。代码组织梳理不是风格美化。大多数代码审查工具关注命名、格式和 lint 规则。code-groom 关注更底层的问题冗余的中间层、散落在调用方身上的状态、一个函数干了好几层的事。它提供五条判断原则改不改加七条操作规则怎么改是一套语言无关的代码结构自查框架。当你觉得代码臃肿但说不上哪不对时用它过一遍。安装方式一通过 AI 安装推荐将以下提示词发送给你的 AI Agent请根据 https://skillhub.cn/install/skillhub.md安装 code-groom。方式二Git 克隆gitclone https://gitee.com/code-ape-hc/code-groom.git然后将code-groom目录放入你的 Agent 的 skills 目录WorkBuddy:~/.workbuddy/skills/code-groom/Claude Code:~/.claude/skills/code-groom/其他支持 SkillHub 的客户端: 见各自文档安装后对 Agent 说梳理代码或groom即可触发。核心方法五原则判断力 — 改不改原则一句话单一数据源同一份值有没有在多处重复定义→ 收归一处单层抽象一个函数做了超过一层的事→ 拆成编排层 细节函数封装外部能改这个模块的内部字段吗→ 加只读或私有消冗余方法体只有一行调另一个方法→ 内联删方法状态找主人内部状态散落在调用方身上→ 抽成类构造/dispose 收口七规则操作手法 — 怎么改规则自查动作R1 谁产生谁持有变量产生端自持不让外部传回来R2 死代码清除搜索引用数0 删1 考虑内联R3 纯转发删除方法体一行调同名方法 → 删R4 出口收进消费端仅内部用的公开接口 → 不公开R5 动态适配用接口不同场景不同行为 → 接口注入不写死实现R6 小文件合并同职责 50 行 → 合R7 重复模式抽方法同一结构 ≥ 2 次 → 抽执行流程扫描影响范围— 谁持有谁调用、谁监听谁发射、类型定义在哪过五原则— 逐条问我这个改动违反吗过七规则— 具体动手时逐条执行自验— 编译检查 竞态复核约束行为零变化只改内部组织不改外部行为不过度抽象拆出来 3 行且只被一处调用 → 不拆不扩大范围只改命中的点跨模块只记录不改与其他工具的区别code-groomlinter重构工具关注点结构骨架抽象层级、状态归属格式风格缩进、命名行为变更拆分模块、换算法语言绑定无特定语言特定语言输出改动清单 原因错误列表新代码