Pdlc fix

Skill kanfu-panda/pdlc-skills/skills/pdlc-fix

36 slash commands that turn Claude Code into a real PDLC workflow — PRD → TDD → implement → review → ship. Hard contracts force AI to persist artifacts, write failing tests first, and run self-checks. No more "looks done" in chat.

Install

npx -y skills add kanfu-panda/pdlc-skills --skill pdlc-fix

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

9 stars9 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

全自动 Bug 修复（定位→复现→修复→测试→文档）

SKILL.md

4.8 KB, as published. Nobody here has run it

全自动 Bug 修复

接收一句话 Bug 描述，全自动完成定位、复现、修复、测试、文档更新，中途不暂停、不询问用户。

执行规则

全程自动：不在任何步骤暂停等待确认，遇到歧义自行做合理假设并在最终报告中说明
严格顺序：必须按阶段一→二→三→四→五顺序执行，不得跳过
最小改动原则：只修复 Bug 本身，不顺手重构或优化不相关代码
测试验证才结束：全量测试通过后才输出最终报告

阶段一：问题定位

根据 Bug 描述，搜索相关代码文件，阅读并理解涉及的逻辑
查阅 docs/02_design/ 对应子目录下的设计文档，确认预期正确行为
明确根因：
- 是代码逻辑错误、边界未处理、还是设计文档遗漏？
- 影响范围：哪些模块/接口/数据受影响？
若 Bug 描述不足以定位，根据描述做最合理推断，在报告中说明

阶段二：回归测试（红灯）

在对应服务/应用的测试目录下，编写一个能精确复现该 Bug 的测试用例
- 后端 Java：backend/services/<服务名>/src/test/
- 前端：frontend/web/<应用名>/src/__tests__/
测试命名格式：应该_当<触发条件>时_<预期行为>
运行该测试，确认测试失败（红灯），记录失败输出
若已有相关测试但未覆盖该场景，在原测试文件中追加用例

阶段三：代码修复（绿灯）

用最小改动修复 Bug，不改动与 Bug 无关的代码
运行步骤二编写的回归测试，确认通过（绿灯）
若修复过程中发现设计文档有遗漏或错误，同步更新对应设计文档

阶段四：全量测试验证

运行该服务/应用的完整测试套件，确认没有引入新的失败
若有 E2E 测试，运行相关 E2E 用例验证端到端行为正常
如有测试因本次修复而需要更新（如快照测试、预期值变更），同步更新

阶段五：文档更新与最终报告

⚠️ 必须创建文件，不可仅在对话中输出。 以下每份文档都必须作为实际文件写入磁盘。

更新对应服务的 CHANGELOG.md，在 [未发布] 下新增 fix 条目：
- 格式：- 修复 <简要描述>（<触发条件>）
若涉及设计文档变更，同步更新 docs/02_design/ 下对应文档
【必须创建文件】 在 docs/04_testing/defects/ 下创建缺陷记录：<缺陷ID>-<功能名>-defect.md
- 文档顶部必须包含 PDLC 追溯头（格式见下方片段）：

记录：根因分析、影响范围、修复方案、回归测试覆盖情况
创建后验证：确认文件已存在于 docs/04_testing/defects/ 目录

输出最终报告（同时在对话中显示，但报告内容必须已落盘到上述文件中）：

## Bug 修复报告：<简要描述>（<缺陷ID>）

### 根因分析
<一段话描述根本原因>

### 影响范围
- 涉及文件：
- 涉及接口/功能：

### 修复方案
<描述做了什么改动，为什么这样改>

### 测试结果
- 回归测试：通过
- 全量测试：X 个通过 / 0 个失败

### 文档变更
- CHANGELOG.md：已更新
- 设计文档：已更新 / 无需更新

### 假设与说明
（记录执行过程中自行做出的关键假设）

### 上线前待办
（如有需要人工处理的事项，如数据修复脚本、缓存清理等）

产出物清单（每项必须作为文件创建）

产出物	路径	必须
缺陷记录	`docs/04_testing/defects/<缺陷ID>-<功能名>-defect.md`	✅ 必须
回归测试	对应服务测试目录	✅ 必须
CHANGELOG	对应服务 `CHANGELOG.md`	✅ 必须
设计文档更新	`docs/02_design/` 下对应文档	按需

文件落盘规则：所有带编号（缺陷ID）的文档必须作为实际文件写入，不可仅在对话中显示。最终报告完成前，必须确认上述文件均已创建。

要求

只修复 Bug，不做额外优化或重构
回归测试用例必须保留在代码库中，不得删除
日期使用执行当天实际日期，格式 YYYYMMDD

Bug 描述: $ARGUMENTS