Individual skill

forge-bugfix

系统性 Bug 修复流水线（P0-P8）：一次修一个，强制根因分析、独立 worktree、TDD、双层验收报告、forge-qa 回归；多会话经 .forge/active.md 防撞车。铁律：不做根因分析不写代码；新发现禁止顺手修；没有用户最终结论不合并。触发方式：用户说"bugfix"、"反馈个问题"、"修这个 bug"、"这里有问题"、"为什么不对"、"排查一下"、"investigate"、"forge-bugfix"，或报告错误、异常行为、功能失效时。

skills/forge-bugfix/SKILL.md

Read pinned source

Source commit 0955ca04f426153893fe92825d99e02c7dd6bc74

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: No
Repository scan complete: No
Skill scan complete: Yes
Observed behavior: Not checked yet
Last checked: Nov 5, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings): 15
Repository last updated: Oct 26, 2026
License: MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

agent-skills Repository topic
ai-development Repository topic
claude-code Repository topic
forge Repository topic
skill-md Repository topic
skillsmp Repository topic
testing Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

README.mddoc · 4,599 bytes
SKILL.mdcore · 12,711 bytes
references/p0-p1-session-setup.mddoc · 9,100 bytes
references/p2-scoping.mddoc · 6,163 bytes
references/p3-p5-fix-loop.mddoc · 17,166 bytes
references/p6-p7-acceptance.mddoc · 20,485 bytes
scripts/get-session-id.shruns · 1,700 bytes
scripts/validate-bugfix-report.pyruns · 7,119 bytes
templates/active.mddoc · 3,392 bytes
templates/backlog.mddoc · 5,689 bytes
templates/review-checklist.mddoc · 9,269 bytes

Read excerpt


> **文档落地路径**：遵循 forge-doc-policy 规范。完整白名单 + frontmatter schema 见
> `~/.claude/skills/forge-doc-policy/doc-paths.md`。
> **当前文档加载顺序**：先读项目 `CLAUDE.md`、`docs/README.md`、`docs/INDEX.md`、
> `docs/QA.md` / `docs/ENGINEERING.md` 相关当前真相源，再读活跃 BF 报告和 backlog。
> 历史 BF 报告在 `docs/archive/raw/bugfix-reviews/`，只作追溯证据。
> 详细规则见 `~/.claude/skills/_shared/current-doc-loading.md`。

# /forge-bugfix：一次一 bug + Bug 修复验收报告

## 设计哲学

**短会话、单 bug 隔离、结构化证据、可追溯、可丢弃。**

核心机制：