名称: 补丁 描述: 创建最小化的外科式补丁计划,用于针对性修复。适用于小规模、专注的更改,而不是完整的特性实现。 参数提示: [变更请求] [规格路径] 允许的工具: 读取、写入、Glob、Grep
创建专注的补丁计划
创建一个最小化的、外科式的补丁计划来解决特定问题。
变量
review_change_request: $1 - 要修复的问题的描述spec_path: $2 (可选) - 原始规格的路径
目的
创建一个补丁 - 最小范围、外科式修复、针对性更改。
“这是一个补丁 - 保持范围最小。只修复在 review_change_request 中描述的内容,不修其他。”
指令
1. 理解问题
解析 review_change_request:
- 具体什么是坏的?
- 预期的行为是什么?
- 存在什么证据(截图、错误)?
不要扩展范围超出这个特定问题。
2. 读取原始规格(如果提供)
如果提供了 spec_path,读取它以获取上下文:
- 原始需求
- 这个问题如何与规格相关
- 预期的行为是什么
3. 分析当前状态
# 查看当前更改
git diff --stat
# 查找相关文件
grep -r "相关术语" src/
4. 确定最小修复
问:“修复这个问题的最小更改是什么?”
- 优先 1-10 行更改
- 避免重构
- 不要修复无关问题
5. 创建补丁计划
写入:specs/patch/patch-{描述性名称}.md
计划格式
# 补丁: [简洁的补丁标题]
## 元数据
- 审查变更请求: [从输入]
- 规格路径: [如果提供]
## 问题总结
**问题**: [什么坏了 - 具体]
**解决方案**: [最小修复方法]
## 要修改的文件
[只需更改的文件 - 具体且最小]
- `路径/到/文件.ts`: [需要什么更改]
## 实现步骤
重要:按顺序从上到下执行每个步骤。
### 步骤 1: [具体操作]
[确切的代码更改需要]
### 步骤 2: [具体操作]
[确切的代码更改需要]
## 验证
执行每个命令以验证补丁完成:
- [特定测试命令]
- [手动验证步骤]
## 补丁范围
- **要更改的代码行数**: [估计]
- **风险级别**: [低/中/高]
- **所需测试**: [最小/标准/广泛]
输出
只返回创建的补丁计划文件的路径:
specs/patch/patch-fix-button-disabled-state.md
范围指南
保持最小:
- 只修复报告的问题
- 不要重构周围代码
- 不要添加无关改进
- 不要更新文档
风险评估:
| 行数 | 风险 |
|---|---|
| 1-10 | 低 |
| 10-50 | 中 |
| 50+ | 高 - 重新考虑范围 |
工作流集成
补丁通常跟随审查:
/审查 → 识别阻塞问题
↓
/补丁 → 创建外科式修复计划(此命令)
↓
/实现 → 执行补丁计划
↓
/审查 → 重新验证修复