Agent Skills
返回列表
💻

社区代码简化最佳实践

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/pproenca-dot-skills。

技能介绍

问题在哪

让 AI 做「代码简化」时,常见翻车点不是语法不熟,而是没先摸清项目约定就套用通用风格,或在改写法时悄悄改了返回值、错误类型或副作用。范围也容易失控:一次 PR 里顺带做全局重构,diff 不可审。团队真正需要的是一套可执行的优先级——先保住行为,再收拢最近改动的复杂度。

技能如何工作

本技能把简化拆成 8 类、47 条带前缀的规则(如 ctx-read-claude-md、behave-preserve-api、flow-early-return),并按影响从高到低排序:上下文发现与行为保持为 CRITICAL,其次是范围管理、控制流,再到命名、去重、死代码与语言惯用法。

推荐工作流是:

  1. 发现上下文:读 CLAUDE.md、lint/格式化配置,对齐文件内现有风格
  2. 锁定范围:只处理近期修改代码,保持 diff 小而可审
  3. 按优先级变形:先满足 behave-*(输出、错误、公开 API、副作用不变),再应用 flow-*、name-* 等
  4. 验证行为:提交前确认语义未变

每条规则配有错误/正确对照示例与影响说明,便于在 agent 提示里引用具体规则 ID,而不是泛称「写干净一点」。

边界与注意点

  • 默认不改变对外行为;若需要语义变更,应单独说明,不能借「简化」偷换逻辑
  • 项目约定优先于通用最佳实践(ctx-project-over-generic)
  • 去重与抽象遵循「清晰度优先」:反对为去重而造单次使用的 helper,也反对过早抽象
  • TypeScript / Rust / Python / Go 等惯用法条目标注为增量优化,不应压过行为校验

使用场景

  • 功能分支合并前,要把刚改动的多层嵌套改成早返回,但不能动公开函数签名与错误类型
  • 让助手只清理本次 diff 里的重复条件分支,并删除未使用变量,禁止顺带重写整个模块
  • 接手他人 PR 时,按 ctx-/behave- 规则核对 AI 简化建议是否读过项目 lint 与 CLAUDE.md
  • 在 TypeScript 服务里把 any 收紧、用可选链收拢空值判断,同时要求日志与返回值与改前一致

适合人员

  • 维护大型单体服务的工程师,经常把「整理刚提交的补丁」交给 Claude/Cursor,需要硬性行为不变约束
  • 负责 Code Review 的 Tech Lead,要评估 AI 重构建议是否越界改了 API 或副作用
  • 开源协作者,仓库里有 CLAUDE.md 与 ESLint/Prettier,希望 agent 简化时跟项目风格一致
  • 在多语言栈(TS/Rust/Go/Python)里写胶水代码的全栈,只想在语言惯用法层做小幅可读性优化