开发与工程

代码简化审查

在不改变行为的前提下,降低代码复杂度并提升可读性与可维护性。

57/ 100
谨慎使用

价值存在,但可靠性、证据或控制措施仍有明显缺口。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 107k
最近更新
13 天前
License
MIT
code-refactoringcode-reviewreadabilitytypescript
+3javascriptpythonreact

这个 Skill 能做什么,适合哪些场景?

这是一个面向 AI 编程代理的流程化代码简化技能,适用于代码已经可运行但难以理解、维护或扩展的情况。它要求代理先理解代码职责、调用关系、边界情况和历史背景,再逐步进行重构。核心目标是保持输入、输出、副作用、错误行为和边界情况不变。技能覆盖结构复杂度、命名、重复逻辑、过度抽象,以及 TypeScript、JavaScript、Python 和 React/JSX 的示例。

要求代理阅读项目约定和相邻代码,必要时检查测试与 git blame;识别深层嵌套、过长函数、嵌套三元表达式、布尔参数、重复条件、含义不明的命名、重复逻辑、死代码和无效抽象;一次实施一个简化并运行测试;最后检查构建、代码检查、格式化、行为保持、错误处理和差异范围。

适合
  • 团队成员在功能和测试完成后,想降低实现复杂度时使用。
  • 代码评审指出函数过长、嵌套过深或命名不清时使用。
  • 需要整理在时间压力下编写、逐渐变得难以维护的代码时使用。
  • 多个文件中散落着相关逻辑或重复实现时使用。
  • 合并变更后出现重复或不一致,需要进行范围受控的重构时使用。

如何安装这个 Skill?

使用前请注意
  • TypeScript 示例中使用 || 可能改变空字符串、0 或 false 等输入的行为;应改为语义等价的示例或明确适用前提。
  • 流程要求运行测试和回退,但未定义测试缺失、测试失败或无法理解代码时的具体停止与反馈格式。
  • 未明确 AI 代理在修改代码前何时必须获得用户确认,也未说明如何处理敏感代码、凭据或外部副作用。
  • 触发边界和输入输出契约较弱,中文支持及不同代理环境的适配未被说明。
开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 本地文件系统
需要预先安装
  • Git

安装整个仓库的技能集合:npx skills add addyosmani/agent-skills。只安装此技能:npx skills add addyosmani/agent-skills --skill code-simplification。README 说明该集合可安装到 Claude Code、Cursor、Codex、Copilot、Cline 等 70 多种代理中。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/addyosmani/agent-skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/code-simplification" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 请在不改变行为的前提下简化这段代码,先阅读项目约定和相关测试,逐项修改并在每次修改后运行测试。

在已安装该技能的 AI 编程代理中,提出明确的代码简化请求,例如:“请在不改变行为的前提下简化这段代码,先阅读项目约定和相关测试,逐项修改并在每次修改后运行测试。”不要在尚未理解代码时使用,也不要把功能开发与重构混在同一变更中。

这个 Skill 有哪些优点和局限?

优点
  • 明确要求保持行为、错误处理、副作用和边界情况。
  • 提供从理解代码、识别机会到增量验证的完整流程。
  • 强调遵循项目约定,避免为追求少写几行代码而牺牲可读性。
  • 包含结构、命名、冗余和过度抽象等具体识别信号。
  • 提供针对 TypeScript/JavaScript、Python 和 React/JSX 的示例。
局限
  • 依赖项目已有的测试、构建和代码规范来验证重构;技能本身不提供测试实现。
  • 要求代理理解代码历史和上下文,无法替代必要的人工判断。
  • 明确不适合性能关键代码、尚未理解的代码或即将整体重写的模块。
  • 提供的安装和平台集成说明属于整个 24 技能集合,单个技能的独立运行细节较少。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
代码简化审查 本页 57 · 谨慎使用 ★ 107k 13 天前 MIT
OpenChamber 变更纪律 52 · 谨慎使用 ★ 12k 12 天前 MIT
工具重命名兼容性检查 ✓ Microsoft · 官方 63 · 推荐 ★ 194k 12 天前 MIT
Workers 生产实践审查 57 · 谨慎使用 ★ 3.1k 12 天前 Apache-2.0
RenderCV PR 审查助手 55 · 谨慎使用 ★ 18k 7 个月前 MIT

SKILL.md 说明该技能受 Claude Code Simplifier 插件启发,并将其改编为面向任意 AI 编程代理的、与平台无关的流程。源材料没有提供两者的详细功能对比。

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
谨慎使用
57/ 100 五分制 2.9 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
1信任安全19 / 25 · 3.8/5

技能明确要求保持行为、错误处理、副作用和顺序,并建议增量修改、测试失败时回退、限制范围;同时提供来源归因链接。扣分原因是未明确用户确认、权限最小化、敏感数据处理或数据流披露,且发布者身份未被验证。

2可靠稳定8 / 20 · 2.0/5

流程步骤总体一致,包含理解、逐项修改、测试、失败回退和结果检查;但未提供针对该技能关键路径的专门测试或详细异常输入反馈。示例中的 TypeScript 使用 || 替换可能具有不同语义的写法,也削弱了“精确保留行为”的一致性。静态评估按上限保守扣分。

3适用触发11 / 15 · 3.7/5

目标受众、适用场景和不适用场景较清楚,且触发描述具体;但未说明输入输出格式、语义触发边界、不同代码库的环境要求或中文使用支持。核心能力不依赖海外服务。

4规范维护9 / 15 · 3.0/5

文档结构清晰,具有前置说明、适用范围、原则、步骤、语言示例、反合理化表、红旗和验证清单;仓库提供 MIT 许可证及维护者信息。扣分原因是该技能缺少自身版本、变更记录、明确维护责任和更新路径,且依赖项目约定文件但未说明缺失时的处理。

5有效结果6 / 15 · 2.0/5

技能为代码简化提供了可执行流程、识别信号和验证标准,能够覆盖核心目标;但静态材料没有证明代表性输出已实际验证,且结果仍依赖项目测试、人工审查和上下文理解,因此不能确认仅需轻量复核。

6证据核验4 / 10 · 2.0/5

仓库包含 CI、内容校验、评估运行器和验证清单,提供了一定可审计性;但给定测试文件并未覆盖 code-simplification 的关键路径,也没有该技能的独立执行结果或多源复核。静态评估不超过 5 分。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月20日 审查版本 2fbfa004a019 评估证据[1][2][3][4][5]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

这个技能会自动修改代码吗?
源文档描述的是代理应遵循的简化流程,包括逐项修改和运行测试;没有说明具体客户端如何自动执行或提交修改。
它是否保证重构后行为完全一致?
它把行为保持列为核心原则,并要求检查输入、输出、副作用、错误行为和边界情况;实际保证仍取决于代码理解和现有验证。
可以用它来优化性能吗?
不应默认用于性能优化。文档明确提醒,若简化版本会产生可测量的性能下降,或代码属于性能关键路径,应避免使用。
大规模重构应如何处理?
超过 500 行的重构应投入 codemod、sed 脚本或 AST 转换等自动化手段,而不是完全手工修改。

同仓库的其他 Skills

均来自 addyosmani/agent-skills

开发与工程

怀疑驱动开发

在非平凡决策落地前,用新上下文主动寻找错误。

★ 107k FS 52 谨慎使用 13 天前
开发与工程

合并前代码质量审查

在合并前从正确性、可读性、架构、安全性和性能五个维度审查代码变更。

★ 107k FS 49 谨慎使用 13 天前
开发与工程

稳定接口设计指南

帮助工程团队设计稳定、清晰且难以误用的 API 与模块接口。

★ 107k FS 50 谨慎使用 13 天前
开发与工程

测试驱动开发工作流

用可执行的测试先证明需求,再以最小改动实现、重构并验证行为。

★ 107k FS 57 谨慎使用 13 天前
开发与工程

规范驱动开发

在编码前把模糊需求转化为可验证的开发规范。

★ 107k FS 55 谨慎使用 13 天前
开发与工程

性能优化工程技能

通过测量、定位和验证,系统解决前端、后端、查询与数据库性能瓶颈。

★ 107k FS 54 谨慎使用 13 天前
开发与工程

系统弃用与迁移指南

帮助工程团队安全淘汰旧系统、迁移用户并验证移除结果。

★ 107k FS 48 谨慎使用 13 天前
开发与工程

浏览器 DevTools 测试

用真实浏览器运行数据验证、调试并测试网页应用。

★ 107k FS 59 推荐 13 天前
开发与工程

需求访谈助手

在规划或编码前,通过逐题访谈确认用户真正想解决的问题。

★ 107k FS 59 推荐 13 天前
开发与工程

Git 协作与版本发布规范

用可审查、可回滚的 Git 流程管理代码变更与版本发布。

★ 107k FS 54 谨慎使用 13 天前
开发与工程

规划与任务拆解

将明确需求拆分为有依赖顺序、可实现且可验证的工程任务。

★ 107k FS 54 谨慎使用 13 天前
开发与工程

架构决策与工程文档助手

帮助工程团队记录决策依据、维护文档并保留长期代码上下文。

★ 107k FS 53 谨慎使用 13 天前
设计与前端

生产级前端界面工程

帮助 AI 编码代理构建可访问、响应式且符合设计系统的生产级用户界面。

★ 107k FS 53 谨慎使用 13 天前
自动化与运维

生产可观测性工程

为生产代码建立日志、指标、追踪与告警,让系统行为可见且便于诊断。

★ 107k FS 53 谨慎使用 13 天前
开发与工程

增量实现

用可验证的小步迭代安全交付多文件工程变更。

★ 107k FS 52 谨慎使用 13 天前
自动化与运维

安全加固工程技能

帮助编码代理在处理不可信输入、身份验证、敏感数据和外部服务时建立系统化安全防线。

★ 107k FS 52 谨慎使用 13 天前
开发与工程

Idea Refine 创意打磨

把模糊想法转化为经过验证、可执行的产品方向。

★ 107k FS 51 谨慎使用 13 天前
开发与工程

官方文档驱动开发

让框架与库的实现决策基于当前官方文档,而不是过时记忆。

★ 107k FS 51 谨慎使用 13 天前
开发与工程

上下文工程指南

帮助编码代理在正确时间获取正确项目上下文,减少臆测并保持开发规范一致。

★ 107k FS 49 谨慎使用 13 天前
开发与工程

系统化调试与错误恢复

用结构化流程定位根因,修复错误并防止复发。

★ 107k FS 49 谨慎使用 13 天前

相关 Skills