# code_validata_bugfix

**Repository Path**: du_xiang/code_validata_bugfix

## Basic Information

- **Project Name**: code_validata_bugfix
- **Description**: 自动化修复code-rationality-and-risk-review扫描出来得bug
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-09
- **Last Updated**: 2026-05-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# code_validata_bugfix

Cursor **个人技能**：编排「先检验、再（经确认后）修复稳定复现项」的一键工作流。完整规则见同目录 **[SKILL.md](SKILL.md)**。

---

## 本技能做什么

| 阶段 | 子技能 | 作用简述 |
|------|--------|----------|
| 阶段一 | `code-rationality-and-risk-review` | **只读**检验，报告写入工作区 **`codevalidate/*.md`**，默认不改业务源码。 |
| 阶段二 | `code-bugfix` | 仅处理报告中 **可稳定复现** 的条目；**列拟修清单 → 用户确认** 后才改代码；不修弱网/抓包破解类；修复后须在**同一份** `codevalidate` 报告内 **追加「修复回执」**（或等效更新主清单状态），与代码现状对齐。 |

**与 `frontend-design` 的关系**：**不在本编排仓库内重复写规则**。阶段一执行 **`code-rationality-and-risk-review`** 时，已在其 **`SKILL.md`** 中约定——校验**前端页面**时须默认 Read 个人技能 **`frontend-design`**，并把「视觉与体验」维度写入 `codevalidate` 报告（仍只读、不落业务代码）。本编排**无需**为 `frontend-design` 增加第三个「必克隆」仓库；但若本机未安装 `frontend-design`，页面级检验时可能无法完成该步骤，请自行从 Cursor 技能市场或既有来源安装到 `~/.cursor/skills/frontend-design/`。

本仓库只包含**编排**逻辑；**不包含**上述两个子技能的规则正文，须与本机或 Gitee 上的子技能仓库**并列安装**。

---

## 配套仓库（Gitee）

| 用途 | 仓库地址 | 克隆到个人技能目录下的文件夹名 |
|------|----------|--------------------------------|
| 本编排技能（当前仓库） | https://gitee.com/du_xiang/code_validata_bugfix.git | `code_validata_bugfix` |
| 检验技能 | https://gitee.com/du_xiang/code-rationality-and-risk-review.git | `code-rationality-and-risk-review` |
| 修复技能 | https://gitee.com/du_xiang/code-bugfix.git | `code-bugfix` |

**个人技能根目录**：

- Windows：`%USERPROFILE%\.cursor\skills`
- macOS / Linux：`~/.cursor/skills`

若该目录不存在，请先创建再克隆。

---

## 安装注意事项

1. **三个目录并列**：将三个仓库分别 clone 到上述 `skills` 目录，且**文件夹名必须与上表一致**，每个仓库根目录下须有 **`SKILL.md`**（本仓库与两个子技能均满足）。
2. **克隆即安装（子技能）**：对 `code-rationality-and-risk-review` 与 `code-bugfix` 而言，按上表路径 clone 完成后即符合 Cursor 对个人技能的约定，**一般无需再执行额外「安装」程序**。
3. **仅 clone 本仓库不够**：使用编排前，本机必须**同时具备**两个子技能；若缺失，Agent 会按 `SKILL.md` **停止编排**，说明用途并给出 Gitee 地址与 clone 命令，**征得你明确同意**后才会执行 `git clone`（不得擅自下载）。
4. **IDE 未识别新技能**：可 **重载窗口** 或 **新开对话** 后再 `@code_validata_bugfix`。
5. **克隆后是否马上能用编排**：两个子技能就位且能读取 `SKILL.md` 后，**同一轮或下一轮对话**即可继续走编排（仍会执行下文中的**两轮确认**，不会跳过）。

---

## 使用时的确认门禁（必读）

本编排**全程强制两轮停等**，**不因**你在消息里写「直接修复」而减免（若希望少确认，请单独使用 **code-bugfix** 并阅读其 `SKILL.md` 中的「直接修复」例外）。

1. **门禁 ①**：阶段一报告落盘并给出路径后，须等你明确同意**进入修复阶段**（如「进入修复」「确认修复阶段」）。
2. **门禁 ②**：列出**拟修复清单**后，须等你明确同意**按清单修改代码**（如「确认按清单修复」）。

仅检验、不修复时，请在同一条用户消息中写明「**仅检验**」「**不修复**」等，则只执行阶段一。

---

## 与「仅修复」场景的区别

若你**已有** `codevalidate` 报告、只想修 bug、**不要**重新跑检验，请直接使用 **`code-bugfix`** 并带上报告路径，不必使用本编排技能。

---

## 文档索引

- 编排规则（Agent 执行依据）：[SKILL.md](SKILL.md)
- 检验技能详情：克隆后的 `code-rationality-and-risk-review/SKILL.md`
- 修复技能详情：克隆后的 `code-bugfix/SKILL.md`

---

## 许可证与贡献

若各仓库单独提供 LICENSE，以其仓库为准；本 README 仅作安装与使用说明。