Agent Skills
返回列表
保守式代码编辑

保守式代码编辑

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_6246a812/conservative-code-edits。

技能介绍

要解决什么问题

让 AI 或协作者在改代码时,默认只做与任务直接相关的 diff,而不是顺手重构、全文件格式化或「顺便优化」。很多线上问题来自无关改动:公共组件被改坏、状态流转被悄悄换掉、深色主题里又写死 #FFFFFF。这类技能把最小必要改动和改前先问写成可执行的约束,而不是口头提醒。

技能如何约束改动

编码原则层面:保持现有架构、交互逻辑、状态流转、模块职责、命名与实现模式;不做无关重构、格式化、优化或清理,也不删除改动前已存在、但与本次任务无关的旧代码。改之前先想影响面,改之后尽量验证;实现上简洁优先,只在关键位置加通俗注释。

项目硬性规则层面:若要动架构、交互、状态、模块职责或核心实现风格,必须先说明原因、影响范围与风险,并等待确认。若要改公共基础代码(基类、公共 UI、工具类、网络/存储/路由、日志、埋点、权限、主题等),必须先列出影响范围并等待确认。项目已支持深色模式时,禁止硬编码固定 UI 色值,须动态适配并优先用现有颜色资源。

优先级为:用户明确要求 > 项目硬性规则 > 编码原则。

适用边界

它规范的是「怎么改」,不替代需求澄清或测试策略。用户若明确要求大范围重构或改公共层,在说明风险并确认后仍可执行;技能目的是避免默认越界,而非禁止所有结构性变更。

使用场景

  • 在单票 bugfix 分支上让 AI 改逻辑,要求 diff 仅限该缺陷相关文件,不顺手重构邻近模块或全文件格式化
  • 项目已有深色模式时,让助手调整 UI 细节,禁止在 patch 里写死 `#FFFFFF` 等色值,必须复用现有主题/颜色资源
  • 计划调整网络层、路由或公共工具类前,先要求助手列出受影响页面与调用链,经你确认后再动代码
  • 小功能迭代中需要助手加注释或改交互,但不得删除本次任务范围外、历史上就存在的「冗余」代码

适合人员

  • 维护 monorepo 且内置公共 UI/网络层的 Tech Lead,需要给 Cursor 等助手写「动共享代码须先确认」的默认规则
  • 长期负责遗留代码库的 Senior,典型诉求是修一个接口问题时 PR 不要顺带改半个模块的命名与结构
  • 设计系统或主题已支持深浅色切换的前端,要防止 AI 在局部 patch 里硬编码固定颜色
  • Code Review 强调「一 ticket 一范围」的 Team Lead,希望助手默认遵守最小必要改动而非扩大 diff