spec-debug SKILL.md skillB
spec-debug from hhu3637kr/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add hhu3637kr/skills/spec-debug@git:20261106.f67a3a4Pins git:20261106.f67a3a4 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- B, 16 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- hhu3637kr/skills
- Path
spec-debug/SKILL.md- Versions recorded
- 12
- Latest version
- git:20261106.f67a3a4, committed Nov 6, 2026
- First version recorded
- Jul 30, 2026
- Size
- 17,884 bytes
- Repository stars
- 146
- License
- none declared
诊断并修复 Spec 执行过程中发现的问题。由角色 spec-debugger 调用。触发条件：(1) 角色 spec-debugger 接收到 TeamLead 转交的 bug handoff，(2) spec-executor 执行后出现 bug 或 writer/plan.html 中未考虑到的情况，(3) 运行时出现问题、依赖环境或配置问题，(4) 用户要求诊断/修复线上问题、偶发故障、异常报错、环境依赖问题或回归排查。不修改已确认的 writer/plan.html，而是在 debugger/ 下创建独立的诊断文档（debug-xxx.html）和修复总结（debug-xxx-fix.html）。修复完成后向 TeamLead 提交重新验证请求，由 TeamLead 启动 spec-tester。触发词：诊断、修复、线上问题、偶发 500、复现、回滚。主动迭代新需求归 spec-start / spec-update，不要被笼统的'帮我做个开发任务'带走。.
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
# Spec Debug ## 运行契约 > 进入核心原则前先对齐这张表。它把本 Skill 当成一个有边界的循环单元：明确读什么、能动什么、怎么算完成、什么时候停、什么时候交还给人。 | 项 | 本 Skill 的约定 | |----|----------------| | 输入 | TeamLead 转交的 bug handoff（含复现步骤）、`writer/plan.html`、`executor/summary.html`、`tester/test-report.html`、`exp-search` 结果 | | 权限 | 写 `debugger/debug-xxx.html` / `debug-xxx-fix.html` + 最小化修复代码；不改已确认的 `writer/plan.html`、不加新功能、不自行判定修复成功 | | 验证 | 诊断含根因分析、修复总结含前后对比与本轮进展（新增根因/缩小范围/新增证据）。**未验证根因不得改码**；修复后必须在当前工作树上跑一次复现步骤并观察输出，最终结论由 spec-tester 重新验证 | | 停止 | 受「修复循环预算」约束：「已用轮数」 达 「最大轮数」 或 「连续无进展」 达 「最大无进展轮数」 时停止修复。另：连续几轮都有进展、但每轮都翻出新的共享状态或耦合时（Phase 4.5），停下质疑架构而非继续修 | | 升级 | 触发预算上限、Phase 4.5 触发、或根因涉及权限/计费/数据迁移/需绕过测试时，停止并交回 TeamLead 由用户决策 | | 参考 | 进入诊断 → 必读 `references/root-cause-tracing.md`；涉及超时/竞态/等待 → 必读 `references/condition-based-waiting.md`；同类 bug 反复出现 → 必读 `references/defense-in-depth.md` | ## 核心原则 1. **根因优先**：没有验证过的根因，不改代码。先写下**单一可证伪的假设**，再设计能推翻它的最小实验，跑完再判断。一次改五处会让你不知道哪处起了作用 2. **不修改已确认的 writer/plan.html**：通过创建 debug 文档记录问题，保持设计的可追溯性 3. **闭环协作**：接收 TeamLead 转交的 bug handoff → 修复 → 向 TeamLead 请求重新验证 4. **诊断确认随模式**：`gated` 模式下创建 debug-xxx.html 后由 TeamLead 向用户确认诊断；`autopilot` 模式下由「单一可证伪假设 + 已跑过的最小实验输出」替代该确认——没有实验输出就不算确认通过 …
Read the whole file at its exact version.
How to install
mdr add hhu3637kr/skills/spec-debug@sha256:c9371347d56a7255The line at the top of this page pins the label git:20261106.f67a3a4, 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_mhxmhrwv2z44zqsi)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 12 versions of this file, between Jul 30, 2026 and Nov 6, 2026, about one every 9 days. Its first recorded version is graded A and its latest B.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261106.f67a3a4 latest | 2026-11-06 | f67a3a4 | 17,884 B | B | view · diff |
| git:20261105.3ebe4fe | 2026-11-05 | 3ebe4fe | 17,132 B | B | view · diff |
| git:20261105.6c96fc3 | 2026-11-05 | 6c96fc3 | 17,131 B | B | view · diff |
| git:20260923.a4b35af | 2026-09-23 | a4b35af | 16,407 B | B | view · diff |
| git:20260922.b9191a2 | 2026-09-22 | b9191a2 | 16,135 B | B | view · diff |
| git:20260921.ee097b4 | 2026-09-21 | ee097b4 | 15,925 B | B | view · diff |
| git:20260916.4e6c727 | 2026-09-16 | 4e6c727 | 15,505 B | B | view · diff |
| git:20260911.414b35f | 2026-09-11 | 414b35f | 15,395 B | B | view · diff |
| git:20260908.b554d33 | 2026-09-08 | b554d33 | 15,220 B | B | view · diff |
| git:20260809.5529781 | 2026-08-09 | 5529781 | 15,112 B | B | view · diff |
| git:20260808.cc3dbc1 | 2026-08-08 | cc3dbc1 | 13,464 B | B | view · diff |
| git:20260730.ecb143d | 2026-07-30 | ecb143d | 10,173 B | A | view |
Audit of the latest version
- fail: No script tag (matched: <script)
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (17884 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
Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.
Source
hhu3637kr/skills · 146 stars · license none declared · pushed 2026-11-06 · branch master
API
GET https://markdownregistry.com/api/v1/artifacts/art_mhxmhrwv2z44zqsi GET https://markdownregistry.com/api/v1/resolve?ref=hhu3637kr/skills/spec-debug GET https://markdownregistry.com/api/v1/blob/c9371347d56a7255f9a0a239a80b802a3371ddcc7cfff5231ae68ca299e0bd4d
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.