forge-bugfix SKILL.md skillA
forge-bugfix from yike-gunshi/forge-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add yike-gunshi/forge-skills/forge-bugfix@git:20261010.1c72700Pins git:20261010.1c72700 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- yike-gunshi/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
mdr add yike-gunshi/forge-skills/forge-bugfix@sha256:ecf30f23caf1f43eThe 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.
[](https://markdownregistry.com/a/art_b7j6daegyxgdtm64)
4 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.
Audit of the latest version
- 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
yike-gunshi/forge-skills · 13 stars · license MIT · pushed 2026-10-14 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_b7j6daegyxgdtm64 GET https://markdownregistry.com/api/v1/resolve?ref=yike-gunshi/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 yike-gunshi/forge-skills
Every file in yike-gunshi/forge-skills