补丁设计

技能文档

---
name: majiayu000-patch-design
title: 补丁设计
category: 开发工具
description: 创建最小化、针对性的补丁计划，用于精准修复特定问题。当用户需要根据审查意见修复具体问题、创建聚焦的缺陷补丁、或要求避免修复过程中的范围蔓延时触发。触发词：补丁计划、精准修复、缺陷修复、范围控制。
---

# 补丁设计技能

为针对性修复创建最小化、外科手术式的补丁计划。

## 适用场景

- 根据审查意见修复特定问题
- 创建聚焦的缺陷修复
- 在不扩大范围的前提下处理阻塞问题
- 进行有针对性的小步改进

## 核心原则

> 「这是一个补丁（PATCH）——保持范围最小。只修复问题中描述的内容，不做任何多余改动。」

## 技能工作流

### 步骤1：理解具体问题

清晰地解析问题：

- **哪里坏了？**（具体行为）
- **应该怎样工作？**（期望行为）
- **有哪些证据？**（截图、报错信息）

不要把范围扩大到已报告问题之外。

### 步骤2：分析当前状态

审查相关代码：

```bash
# 查找相关文件
git diff --stat
grep -r "related_function" src/

# 阅读具体代码
cat src/component/file.ts
```

### 步骤3：确定最小修复方案

自问：「修复此问题所需的最小改动是什么？」

| 方案 | 行数 | 风险 |
| --- | --- | --- |
| 外科手术式修复 | 1-10 | 低 |
| 定向修复 | 10-50 | 中 |
| 重构 | 50+ | 高 |

补丁场景下**始终优先选择外科手术式修复**。

### 步骤4：编写补丁计划

将精确的修复方案文档化：

```markdown
# 补丁：[简明标题]

## 问题概述
**问题**：[哪里坏了]
**方案**：[最小修复]

## 待修改文件
- `path/to/file.ts`: [具体改动]

## 实施步骤

### 步骤1：[具体动作]
[确切的代码改动]

### 步骤2：[具体动作]
[确切的代码改动]

## 验证
- [验证修复的命令]
- [如何确认成功]

## 补丁范围
- 代码行数：约 X
- 风险等级：低
- 测试：[最小/标准]
```

### 步骤5：定义验证方式

每个补丁都需要可执行的验证：

```markdown
## 验证

1. 运行指定测试：`npm test path/to/test`
2. 人工验证：[步骤]
3. 视觉检查：[如适用]
```

## 补丁计划模板

```markdown
# 补丁：[简要描述]

## 元信息
- 来源问题：[本次补丁请求的来源]
- 严重程度：[blocker/tech_debt]

## 问题概述
**原始规格**：[如有则附链接]
**问题**：[对错误之处的简要描述]
**方案**：[对修复方式的简要描述]

## 待修改文件
[只列出需要改动的文件——务必具体]

- `src/component/Button.tsx`: 修复禁用状态

## 实施步骤

重要：按顺序执行每一步。

### 步骤1：[具体改动]

<!-- markdownlint-disable MD033 -->

```jsx
// Before
<button onClick={handleClick}>

// After
<button onClick={handleClick} disabled={isLoading}>
```

<!-- markdownlint-enable MD033 -->

### 步骤2：[如需后续改动]

[细节]

## 验证

执行以下操作确认补丁完成：

- `npm test src/component/Button.test.tsx`
- 人工验证：点击按钮，确认加载期间处于禁用状态

## 补丁范围

- **改动行数**：约 5
- **风险等级**：低
- **测试**：运行组件测试

## 应避免的反模式

### 范围蔓延

```markdown
# 错误示范：扩大范围
在修复按钮时，我发现表单可以重构，所以我还要
更新校验逻辑、改进错误提示，并给所有其他按钮
加上加载状态。
```

### 改动模糊

```markdown
# 错误示范：计划模糊
## 实施
- 修复按钮问题
- 让它正常工作
- 测试确认
```

### 缺少验证

```markdown
# 错误示范：没有验证
## 实施
1. 改代码
2. 完成
```

## 最佳实践

1. **一个问题，一个补丁**：不要捆绑多个修复
2. **最小范围**：只改动必要的部分
3. **步骤具体**：给出确切的代码改动
4. **验证清晰**：说明如何确认修复成功
5. **风险评估**：改动行数、所需测试

使用说明

# 补丁设计

为特定问题创建最小化、外科手术式的补丁计划，避免修复过程中的范围蔓延。

## 使用

```text
用户：帮我为「按钮在加载时仍可点击」这个问题设计一个补丁。
```

技能将输出一份补丁计划，包含问题概述、待修改文件、逐步实施步骤、验证命令与补丁范围（行数、风险等级）。

## 工作原理

技能遵循「一个问题，一个补丁」原则：先解析具体问题，再分析相关代码现状，确定最小修复方案，最后生成包含精确代码改动与验证方式的补丁计划文档，确保只修复问题本身，不做多余改动。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。