Agent Skills
返回列表
💻

简化与加固

开发编程 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/pskoett-pskoett-ai-skills-simplify-and-harden。

技能介绍

问题从哪来

多数编码智能体在 ticket「做完」就停:exit 0、PR 可提交通常意味着结束。此时它对本次改动的动机、取舍和边角假设还最清楚,但下一轮任务会立刻冲掉这层上下文。结果就是迭代留下的 debug 日志、临时命名、未校验的外部输入,往往要等到 Code Review 或线上事故才被揪出来。

Simplify & Harden 把「完成」改成「完成前的有界自检」:在智能体仍记得每一处改动原因时,对本任务 diff 内的代码做两轮审查,再补一个极轻的决策注释微 pass。

技能如何工作

触发需同时满足:主任务成功结束、diff 含非平凡代码变更(可执行源文件 + 至少 10 行有效改动或一项高影响逻辑变更),且本任务未重复跑过。纯文档、纯测试、纯生成物或 --no-review 不会激活。

Pass 1 — Simplify:以「fresh eyes」重读新增与修改代码,优先做化妆品级清理:死代码与脚手架、命名、控制流扁平化、缩小 API 可见面;重构类改动需逐项人工批准(Refactor Stop Hook)。

Pass 2 — Harden:按清单查输入校验、错误处理、注入面、鉴权、密钥泄露、数据暴露、依赖与并发竞态;小补丁可自动应用,安全重构必须人工确认。

Pass 3 — Document:对非显然逻辑最多加 5 条单行注释,记录 workaround 与性能取舍,不是文档大修。

硬约束:不得动 diff 外代码;额外改动不超过原 diff 约 20% 行数,执行约 60 秒(可配);超限则带 budget_exceeded 收束。产出结构化摘要,未决发现时 review_followup_required 为 true。重复模式可经 learning loop 交给 self-improvement 沉淀为规则。

边界与配合方式

这是完工后自审,不替代独立 Code Review。推荐流程:实现 → 本技能 → 独立评审 → 两者都处理后再合并;若结论冲突,以外部评审为闸门。

它不是大范围重构工具:adjacent「顺手改一改」、新依赖与架构漂移均被禁止;越界顾虑应写在摘要里而非直接改代码。

使用场景

  • 智能体刚改完鉴权或输入校验逻辑,需要在提 PR 前自动扫一轮注入面与权限遗漏
  • 一次功能开发 diff 超过 10 行可执行代码,想清掉迭代留下的 debug 日志和无用 import
  • PR 就绪前希望在本任务改动范围内做小补丁式加固,而不是顺手重构整个模块
  • 想将反复出现的命名混乱、校验缺失等模式交给 self-improvement 做跨任务规则沉淀

适合人员

  • 维护高变更频率微服务的后端工程师,希望 agent 在上下文峰值的收尾阶段补上校验与错误处理
  • 在 CI 里用编码 agent 自动提 PR 的平台工程师,需要完工钩子控制改动范围与 20% 预算上限
  • 负责安全评审的工程师,想把 agent 自审与独立 severity 评审组成双道闸门再合并
  • 自托管 Claude/Copilot 类 agent 的维护者,需要重构类改动逐项人工批准而非静默改结构