forge-bugfix SKILL.md skillA

This file is byte-identical to the first copy the registry indexed. Same content hash, so the same checks give both the same grade.

forge-bugfix from antonailog/forge-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add antonailog/forge-skills/forge-bugfix@git:20261010.1c72700

Pins git:20261010.1c72700 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
antonailog/forge-skills
Path
_archive/snapshots/2026-10-10-feature-doc/forge-bugfix/SKILL.md
Versions recorded
1
Latest version
git:20261010.1c72700, committed Oct 10, 2026
Size
12,505 bytes
Repository stars
13
License
MIT

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

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

> **文档落地路径**:遵循 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 隔离、结构化证据、可追溯、可丢弃。**

核心机制:

- **Bug 修复验收报告**:每个 bug 从登记/领取开始就创建活跃报告 `docs/bugfix/reviews/BF-XX.md`(`status: draft`)
  - 发现时:记录来源、现象、初始截图/日志、关联 Feature Spec
  - 修复时:记录 worktree、TDD 红绿证据、根因、commit、涉及文件
  - QA 时:forge-qa 回填前后端地址、环境身份校验、逐步截图、深度断言
  - 人工验收时:用户只看"人工验收指南"和同一组验收地址,填最终结论
  - 结案后:移动到 `docs/archive/raw/bugfix-reviews/`(`status: archive`),backlog 保留链接
- **两种验收节奏**:
  - **单 bug 模式**:QA 全过后立即进入 P6.5,等用户验收该 bug
  - **QA 自动闭环 / 批量模式**:单 bug QA 通过后标记 `qa-pass-pending-final-review`,最后由批次汇总统一交给用户验收
- **新发现必须分流**(禁止顺手修):
  - 原 bug 未 Pass 前:只记录为“待确认新发现”,不进入当前修复
  - 原 bug 已 Pass 后:先明确告知用户“本次 bug 修复已完成”,再询问是否写入文档
  - 用户确认后,独立 bug → `docs/bugfix/backlog.md` 的待修区,分配 BF-XX 编号
  - 用户确认后,新需求 → `docs/bugfix/backlog.md` 的新需求区,建议 /forge-prd 立项
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add antonailog/forge-skills/forge-bugfix@sha256:ecf30f23caf1f43e

The line at the top of this page pins the label git:20261010.1c72700, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_x2jz27lgst3gmhzg.svg)](https://markdownregistry.com/a/art_x2jz27lgst3gmhzg)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 10, 2026.

versioncommittedcommitsizeaudit
git:20261010.1c72700 latest2026-10-10 1c72700 12,505 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (12505 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

antonailog/forge-skills · 13 stars · license MIT · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_x2jz27lgst3gmhzg
GET https://markdownregistry.com/api/v1/resolve?ref=antonailog/forge-skills/forge-bugfix
GET https://markdownregistry.com/api/v1/blob/ecf30f23caf1f43e609d73460c9146345dd269e2ea5701fda75c9d51d6aadf8f

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from antonailog/forge-skills

forge SKILL.md skill
antonailog/forge-skills · SKILL.md · Forge 工作流总入口。只读检测项目状态,推荐下一步该用哪个 skill,自己不干活。触发方式:用户说"forge"、"下一步"、"接下来做什么"。
git:20261010.1c72700 · audit A · 13 stars
forge-deliver SKILL.md skill
antonailog/forge-skills · _archive/2026-07-04-forge-deliver-retired/SKILL.md · 端到端交付纯编排层:调用 forge-* 子 skill 从需求一路编排到发布和文档,.deliver/state.json 检查点,支持 --auto /…
git:20260704.cb84167 · audit A · 13 stars
forge-design-lab SKILL.md skill
antonailog/forge-skills · _archive/snapshots/2026-10-10-feature-doc/forge-design-lab/SKILL.md · 在真实 token、真实像素的 HTML 骨架上做页面与组件的设计决策:生成可点、可改、可存的设计工作台,按七层逐节点审查,保存即导出 token 与 CSS 并回写 DESIGN.md 的 token…
git:20261010.1c72700 · audit B · 13 stars
forge-design SKILL.md skill
antonailog/forge-skills · _archive/snapshots/2026-10-10-feature-doc/forge-design/SKILL.md · 全栈设计规划:分级门控管理 DESIGN.md 与 DESIGN-CHANGELOG,内置可检索设计规则库(UX 规则/配色/字体),三层 Token、forge-design-lab 工作台门禁(布局/比例/密度在真 token…
git:20261010.1c72700 · audit A · 13 stars
forge-eng SKILL.md skill
antonailog/forge-skills · _archive/snapshots/2026-10-10-feature-doc/forge-eng/SKILL.md · 工程实现主力:管理 ENGINEERING.md,完整/轻量两模式;worktree 会话隔离、分级 TDD、验证门(证据先于断言)、任务原子化 Wave 并行、独立…
git:20261010.1c72700 · audit A · 13 stars
forge-prd SKILL.md skill
antonailog/forge-skills · _archive/snapshots/2026-10-10-feature-doc/forge-prd/SKILL.md · 产品诊断与 PRD 迭代:诊断根因(设计缺陷/实现偏离/PRD 遗漏),必要时反驳需求,更新 PRD 并生成带异常态门禁的 Feature Spec。 触发方式:用户说"更新PRD"、"调整需求"、"迭代PRD"、"forge-prd"、描…
git:20261010.1c72700 · audit A · 13 stars
forge-review SKILL.md skill
antonailog/forge-skills · _archive/snapshots/2026-10-10-feature-doc/forge-review/SKILL.md · 上线前 PR 审查。分析当前分支与基础分支的 diff,检查 SQL 安全、竞态条件、 LLM 信任边界、枚举完整性等测试捕获不到的结构性问题。发现问题直接修复。 触发方式:用户说"review"、"审查代码"、"上线前检查"、"forge…
git:20261010.1c72700 · audit A · 13 stars
forge-ship SKILL.md skill
antonailog/forge-skills · _archive/snapshots/2026-10-10-feature-doc/forge-ship/SKILL.md · 发布上线:PR only(建 PR 即停)或 Full ship(合并 PR + 同步本地基础分支);测试失败不发布、不 force push,状态汇报严格区分提交/推送/合并/部署。 触发方式:用户说"ship"、"发布"、"合并上线"、…
git:20261010.1c72700 · audit A · 13 stars
DESIGN.md@docs DESIGN.md file
antonailog/forge-skills · docs/DESIGN.md
git:20260427.72938ed · audit A · 13 stars
forge-brainstorm SKILL.md skill
antonailog/forge-skills · skills/forge-brainstorm/SKILL.md · 通用头脑风暴:4 种模式(产品/内容/构建/探索)× 6 阶段,强制前提挑战和 2-3 方案,产出可跨会话续聊的思考文档;支持 Mermaid/图辅助判断。 触发方式:用户说"头脑风暴"、"brainstorm"、"讨论一下"、"我有个想法…
git:20260717.95d1b1c · audit A · 13 stars
forge-bugfix SKILL.md skill
antonailog/forge-skills · skills/forge-bugfix/SKILL.md · 系统性 Bug 修复流水线(P0-P8):一次修一个,强制根因分析、独立 worktree、TDD、双层验收报告、forge-qa 回归;多会话经 .forge/active.md…
git:20261010.1c72700 · audit A · 13 stars
forge-design-impl SKILL.md skill
antonailog/forge-skills · skills/forge-design-impl/SKILL.md · 设计实现:把 DESIGN.md 转成代码,只改样式不改逻辑;CSS 优先、Token 驱动、反 AI 模板、原子提交,以真实截图和 CSS 断言验证。 触发方式:用户说"实现设计"、"forge-design-impl"、设计文档确认后需…
git:20261010.cef1ea2 · audit A · 13 stars

Every file in antonailog/forge-skills

Other files named forge-bugfix

forge-bugfix SKILL.md skill
yike-gunshi/forge-skills · _archive/snapshots/2026-10-10-feature-doc/forge-bugfix/SKILL.md · 系统性 Bug 修复流水线(P0-P8):一次修一个,强制根因分析、独立 worktree、TDD、双层验收报告、forge-qa 回归;多会话经 .forge/active.md…
git:20261010.1c72700 · audit A · 13 stars
forge-bugfix SKILL.md skill
yike-gunshi/forge-skills · skills/forge-bugfix/SKILL.md · 系统性 Bug 修复流水线(P0-P8):一次修一个,强制根因分析、独立 worktree、TDD、双层验收报告、forge-qa 回归;多会话经 .forge/active.md…
git:20261010.1c72700 · audit A · 13 stars
forge-bugfix SKILL.md skill
antonailog/forge-skills · skills/forge-bugfix/SKILL.md · 系统性 Bug 修复流水线(P0-P8):一次修一个,强制根因分析、独立 worktree、TDD、双层验收报告、forge-qa 回归;多会话经 .forge/active.md…
git:20261010.1c72700 · audit A · 13 stars

Browse by kind, by grade A, or by owner.