Agent Skills
返回列表
软件开发规范与代码质量守卫

软件开发规范与代码质量守卫

开发编程 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_9608010a/dev-discipline。

技能介绍

要解决的问题

AI 改代码常见风险不是语法错误,而是理解偏差、越界修改和表面修复。一个 bug 可能触发无关函数调整,一个需求可能跳过确认直接改核心逻辑,最后难以审查、难以回滚。这个技能把代码变更约束成可确认、可验证、可回溯的工程流程。

工作方式与适用边界

它围绕 协作规范 和 代码质量 两条线工作:

  • 先确认再执行:复述需求、列出影响范围、拆解任务、识别风险;用户未确认前不写代码。
  • 控制修改边界:只改任务内代码和必要连带修改;发现额外问题只记录,不顺手重构。
  • 关键操作备份:涉及支付、订单、认证、数据库结构或一次改多个文件时,先备份到 _backup/日期_任务描述/。
  • 根因优先:追踪调用链,避免用补丁掩盖抽象错误;必要时提取公共函数、拆分职责过大的模块。
  • 保持全站一致:沿用现有命名、错误处理和安全方案,不随意新增依赖。

适用于写代码、修 bug、加功能、重构和修改源文件。单行修复、纯配置键值、紧急 bug 先修后报,或用户明确说“直接改”时可放宽确认,但仍应做最小修改和 REVIEW 自查。

使用场景

  • 修订单 bug 前,要求先确认影响范围、备份核心文件,再按调用链修根因而不是加补丁。
  • 给现有 SaaS 增加列表分页、批量超时和索引方案,避免一次性拉全量导致不可扩容。
  • 重构 500 行以上的订单模块,按职责拆分并统一错误处理,不顺手改无关页面样式。
  • 用户催改代码时,先声明风险并列出任务清单,经确认后才执行且记录额外问题。

适合人员

  • 维护支付、订单、认证逻辑的后端工程师,要求改动前确认并备份核心文件。
  • 把 AI 接入遗留代码库的技术负责人,要求限制越界修改和随意新增依赖。
  • 修 bug 与重构并行的全栈工程师,要求先查根因、统一错误处理再提交。
  • 审查 AI 产出代码的工程经理,要求关键节点透明、完成前做自查清单。