代码去味
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_56c01990/de-ai-code 并将其启用为当前会话可用技能。
技能介绍
识别并量化“AI 味”代码
当你把代码生成任务交给大模型时,产出的代码往往带着一股明显的“AI 味”。这通常表现为教程式的注释、过度解释的命名(比如 data/temp 或是丝般顺滑的 total_score_for_all_users_in_the_list)、被切得过于细碎的函数,以及在单个文件中混用 callback、.then、async 或 fetch、axios、XHR 的“精神分裂式”风格。此外,代码还充斥着冗余的防御性空值检查和零上下文的“死板”写法,完全看不到人类开发者惯用的 ?.、&& 或 reduce 等惰性惯用法。
四档口味与两阶段工作流
de-ai-code 通过内置的 scripts/smell_score.py 将这种“品味”量化为 0–100 的分数,分数越高代表 AI 味越重,并据此定义了四个渐进的去味等级:
- L0(完全 AI):原汁原味,不做任何转换。
- L1(大师调教):轻度清理,仅去除最明显的 AI 特征(目标 60–75 分)。
- L2(只是辅助):中度清理,让代码看起来像人类借助 AI 编写的(目标 20–35 分,默认等级)。
- L3(古法编程):重度清理,使其看起来像手工打造、符合仓库原生风格且高度惯用(目标 0–10 分)。
为了不过度干预已有代码,该技能采用严格的两阶段工作流。Phase A 只评估和预览:脚本会检测语言、读取项目风格配置(如 CLAUDE.md),运行评分器并展示当前分数与各等级的改动预览,然后停下等待你的选择。Phase B 才执行转化:当你明确指定了 L1 至 L3 的某一等级后,技能会加载对应的规则清单,应用重构并重新评分以验证结果是否落入目标区间。
适用边界与硬性约束
去味化是一项纯外观与结构调整,因此有一条不可逾越的红线:绝不改变代码行为,也绝不破坏现有测试。在 L3 级别,技能会刻意引入一些符合现实的人类“小瑕疵”(如偶尔的实用内联代码或上下文相关的 TODO),但绝不会引入 Bug 或死代码。在低级别操作时,Diff 会保持最小化,你随时可以升级到去味等级。对于完全干净的手工代码(如 AppHub 中的文件),该工具会自动保持现状,避免无意义的 churn。
使用场景
- 模型生成的函数碎裂、注释像教程,提交前想按 L2 去味,但必须先看评分与改动预览。
- 一个文件里同时出现 fetch/axios/XHR 和 callback,需用 L1 轻修,且不许改动现有测试结果。
- 中文业务项目收到满屏英文注释的生成代码,需求是转成有人味的中文注释并降低冗余空值检查。
- CI 想给新增源码跑气味评分,分数不达标时允许按档位改写,但禁止顺手重构行为。
适合人员
- 维护带单测的模型生成模块、希望去味不改行为的工程师
- 维护 CLAUDE.md/AGENTS.md/.editorconfig 并要求模型向仓库风格靠拢的团队
- 负责 Code Review 质量门禁、想把 AI 味变成可复现分数的检查者
- 接手中文项目却拿到英文 AI 注释代码、需要控制 diff 的维护者