메뉴
【强制调用】用户说"fix/修改bug/修复/修一下/解决报错/不工作/报错/异常/debug/not working/error"等任何表达修复意图时必须调用。先诊断根因，评估难度，简单Bug直接修复，复杂Bug出多方案供选择。全程分支隔离，自测验证，最小化对其他模块影响。不适用于PPT、文档等非代码任务。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
技术博客写作助手。根据用户提供的主题或素材，生成结构清晰、内容深度、可视化强的中文技术博客/文档。包含总览表格、机制详解、流程图、安装指南。用户说"写博客"、"写文档"、"整理成文章"、"输出技术文档"时调用。
为Hexo博客的Markdown笔记添加YAML front matter头部。当用户需要给博客文章添加Hexo格式的front matter时调用。
前端浏览器 QA 取证。用于真实浏览器视觉取证、Playwright 流程验证、动态点击输入、DOM 断言、表单/表格/弹窗/滚动/sticky 表头/响应式布局和用户截图反馈复现；截图用于视觉证据，动态交互优先用 Playwright 测试或 MCP 断言，不做最终产品业务验收。
前端代码审核。用于 UI 实现或修复后，检查数据映射、事件绑定、表单校验、异步状态、提交锁、可访问性、测试和回归风险。
前端开发规范。用于 UI 编码或修复前，约束组件复用、字段契约、表单、表格、弹窗、布局、样式、异步状态、分页和设计系统一致性。
前端契约同步。用于 UI 改动影响 API/schema、DTO、Mock、测试数据、校验规则、状态模型、页面展示字段或 PRD 字段说明时保持一致。
| name | bug-fix |
| description | 【强制调用】用户说"fix/修改bug/修复/修一下/解决报错/不工作/报错/异常/debug/not working/error"等任何表达修复意图时必须调用。先诊断根因，评估难度，简单Bug直接修复，复杂Bug出多方案供选择。全程分支隔离，自测验证，最小化对其他模块影响。不适用于PPT、文档等非代码任务。 |
systematic-debugging 完成根因分析，根因未确认前禁止动手using-git-worktrees 创建 fix/issue-<编号>-<描述> 分支，禁止在主分支直接改BUGFIX_LOG.md，完成后更新；同步写 memory 日志每次最多问 3 个问题：具体表现？预期行为？复现步骤？错误日志？必现还是偶发？安全类 Bug 追加追问数据泄露风险和外部触发可能。
使用 systematic-debugging：读错误 → 定位代码 → 追踪数据流 → 检查近期变更 → 确认根因。
🟢 简单 —— 跳过方案设计，直接修复： 拼写错误、字段未对齐、缺空值判断、逻辑符号反了、缺 await、配置遗漏、类型不匹配等，≤5 行、单文件改动。
🔴 复杂 —— 必须走方案设计： 其余所有情况。
产出 ≥2 个方案，每个方案评估对其他模块的影响：
方案 N：[名称]
- 思路：[一句话] | 修改范围：[文件清单]
- 优点：[2-3个] | 缺点/风险：[1-2个]
- 破坏性变更：[是/否] | 对其他模块的影响：[说明]
选最优并说明理由，难分优劣则交给用户选择。
## Bug 修复计划
Bug：[一句话] | 根因：[一句话] | 难度：[简单/复杂]
[复杂] 选定方案：[方案N] — 理由：[...]
修改文件：path/file — [改什么]
验证：1.模拟[...] 2.浏览器[...]
影响范围：[说明] | 预计行数：[...]
涉及 XSS、SQL 注入、权限绕过、敏感数据泄露等：不公开讨论细节、优先评估影响面、commit 用 fix(security): <描述>、修复方案本身不能降低安全标准。
🟡 代码细节 → 直接修，重新验证，最多 3 轮
🔴 方案根本错误 → 优先调整方向；实在不行 git reset --hard（仅兜底），换备选方案
⛔ 所有方案失败 → 回到根因分析；连续 3 次失败暂停，告知用户
<项目根目录>/BUGFIX_LOG.md修复前读取，完成后更新。格式：
## Bug 修复日志
### 2026-05-05：登录按钮点击无响应
- **根因：** 前端 onClick 绑定的事件名与后端接口路径不一致
- **难度：** 简单
- **方案：** 统一字段名为 `userLogin`
- **分支：** `fix/issue-1024-login-btn`
- **修改文件：** `src/api/auth.js`、`src/components/Login.vue`
同步记录到 memory（project 类型），用于跨会话追踪迭代过程：
| 轮次 | 方案 | 结果 | 失败原因/新bug |
|---|---|---|---|
| 1 | A | ❌ | 影响模块X，导致新bug |
| 2 | B | ✅ | - |
| ⛔ 禁止 | ✅ 正确 |
|---|---|
| 没找到根因就改代码 | 回到根因分析 |
| 在主分支直接改 | 必须建分支 |
| 改完不验证 | 先模拟再浏览器 |
| 凑合能用的方案 | 选最优，选不出交给用户 |
| 顺手重构无关代码 | 只修 Bug |
| 大改不告知用户 | 第一时间说明 |
| 不检查对其他模块的影响 | 修改前评估，引入新bug一并修 |