Skip to main content
ClaudeWave
Slash Command1k repo starsupdated 11d ago

fix

问题修复(fix 快速修复 / debug 系统化调试)

Install in Claude Code
Copy
mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/doccker/cc-use-exp/HEAD/.claude/commands/fix.md -o ~/.claude/commands/fix.md
Then start a new Claude Code session; the slash command loads automatically.

fix.md

> **流程主权声明**:本命令是用户显式调用的修复/调试工作流,已内置「快速修复」(模式 1) 和「debug 系统化调试」(模式 2) 两套独立流程。
> 禁止在本流程执行期间调用 `superpowers:systematic-debugging`、`superpowers:brainstorming`、`superpowers:writing-plans` 或任何会接管修复/调试流程的外部 skill;本命令自己就是调试流程,无需再嵌套一层。
> 业务领域类 skill(如 `redis-safety`、`api-contract-safety`、`payment-callback-safety`、`time-zone-safety` 等触发条件匹配的安全/规范类技能)正常按需加载,仅作防御性参考,不接管流程。
> 本声明依据 superpowers 自身的优先级规则:用户显式指令 > superpowers skills。

根据参数选择模式:

- `/fix [问题描述]` → 快速修复(定位 → 修复 → 验证)
- `/fix debug [问题描述]` → 系统化调试(复现 → 假设 → 验证 → 报告,不直接改代码)

参数值:「$ARGUMENTS」

---

## 模式 1:快速修复(默认)

快速修复问题,一条龙服务。

### ⚠️ 来自 code-review 的变更范围约束

**当输入以 `[code-review]` 开头时**,必须遵循以下强制规则:

| 规则 | 说明 |
|------|------|
| 只改变更范围内的文件 | 仅修改 `git diff` 涉及的文件,禁止修改未变更的代码 |
| 禁止重构 | 不做代码风格调整、不重命名变量、不提取函数 |
| 禁止改变现有行为 | 修复不能导致原有正常功能不可用 |
| 最小修改 | 每个问题用最少的代码改动解决,不做额外"顺手"优化 |

### 流程

#### 1. 定位问题

根据描述搜索相关代码,找到问题根源。

#### 2. 修复

直接修复,不需要确认(除非有多个方案)。

#### 3. 验证

如果有相关测试,运行测试验证。

#### 4. 输出

```
## 问题
[问题描述]

## 原因
[根因分析]

## 修复
[修改的文件和内容]

## 验证
✅ 测试通过 / ⚠️ 需手动验证
```

---

## 模式 2:debug(系统化调试)

系统化调试问题,遵循科学调试方法。**本模式仅分析,不修改代码。**

### 流程

#### 1. 复现问题

- 确定最小复现步骤
- 记录错误信息和上下文
- 确认问题可稳定复现

#### 2. 收集线索

- 搜索相关代码
- 查看最近的变更(git diff/log)
- 检查日志和错误信息

#### 3. 提出假设

列出 2-3 个可能的原因,按可能性排序:

```
假设 1: [最可能的原因]
假设 2: [次可能的原因]
假设 3: [其他可能]
```

#### 4. 验证假设

- 一次只改一个变量
- 记录每次验证的结果
- 直到定位根因

#### 5. 输出报告

```markdown
## 问题描述
[问题的具体表现]

## 根因分析
[问题的根本原因]

## 调试过程
1. [假设 1] → [验证结果]
2. [假设 2] → [验证结果]

## 建议修复
[修复方案,但不直接修改代码]

## 预防措施
[如何避免类似问题]
```

### 注意事项

- 本模式仅用于调试分析,不修改代码
- 如需修复,请使用 `/fix [问题描述]`
- 对于复杂问题,可能需要多轮调试
api-design-safetySkill

当设计或修改 REST API 响应结构、处理 API 返回值,或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义,以及生成产物时关键字段缺失但静默成功的问题。

api-proxy-safetySkill

网关/代理/WAF/CDN 中间件的安全关键词匹配实现规范,防止纯子串匹配误判正常响应内容中的技术术语(如 Cloudflare、502、error)

async-task-patternSkill

当 API/任务可能执行超过 10 秒(批量数据处理、远程 API 批量调用、全表扫描、跨租户聚合)时触发。防止同步接口被网关 30s 超时切断、用户重复点击触发并发、状态缓存内存泄漏等问题。提供异步任务状态机标准模板。

bash-styleSkill

当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件,或在 Markdown 中编写 bash 代码块时触发。提供 Bash 编写规范。

code-quality-principlesSkill

当编写新模块、设计接口、重构代码或代码审查时触发。提供经典模块化六原则检查清单(大小适中/调用深度/扇入扇出/边界清晰/作用域内聚/可预测性),适用于 PR/Review/新模块设计场景。

external-system-debuggingSkill

涉及浏览器、编辑器、CDN/WAF、IM 平台、操作系统剪贴板、第三方 SaaS 等"外部黑盒系统"的代码编写或 bug 调试时触发。强制先抓真实环境数据再推理,避免连续 2 轮"凭代码推理"的修复 no-op。关键词:粘贴/复制异常、跨平台显示不一致、第三方 API 怪结果、CDN/WAF 拦截、本地复现失败、HTML→MD 转换丢属性。

field-mapping-safetySkill

当重构涉及字段映射(dataIndex、枚举映射、类型转换)时触发。防止字段名推测错误,确保字段映射的正确性。

frontend-devSkill

前端开发规范,包含 Vue 3 编码规范、UI 风格约束、TypeScript 规范等