module-regression SKILL.md skillA
module-regression from qshanx/docs-governance is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add qshanx/docs-governance/module-regression@git:20261011.856328dPins git:20261011.856328d in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- qshanx/docs-governance
- Path
skills/engineering/module-regression/SKILL.md- Versions recorded
- 2
- Latest version
- git:20261011.856328d, committed Oct 11, 2026
- First version recorded
- Oct 11, 2026
- Size
- 7,156 bytes
- Repository stars
- 218
- License
- MIT
大项目模块间联动回归——一份 REGRESSION.md 回归台账登记"每个模块的下游消费者 + 可执行的回归验收命令"，每次改动后照台账跑回归审计，防"改一个模块悄悄弄坏其他模块"。判决靠退出码，不靠 AI 看着没问题。中文触发：模块回归、回归台账、回归审计、改A坏B、模块联动检查、影响面检查、模块牵连、下游验证、大项目改动检查。English triggers: module regression, regression ledger, impact regression audit, downstream verification.
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
# 模块回归台账（module-regression） ## 治什么病 大项目里模块互相引用。改模块 A 时，AI 和人都只盯着 A 本身对不对，**下游的 B、C 被悄悄改坏了没人知道**——直到几天后 B 的产出数字对不上才发现。这是 AI 协作大项目里最高发、最晚爆雷的事故。 解法：一份**回归台账**（`REGRESSION.md`）+ 一个**照单审计**动作——改完任何模块，按台账把受牵连的下游全部验一遍，全绿才算改完。 ## 台账三要素（每个模块一段，缺一不可） ```markdown ## 模块 03-店铺数据清洗 下游（谁依赖我）：05-汇总、07-成品导出 <!-- 脚本从 import 生成，勿手改 --> 回归验收命令：pytest tests/test_03.py && python scripts/对账.py --module 03 联动规则：改我的对外行为 → 必须跑 05、07 的验收命令；只改内部实现且本模块验收绿 → 可豁免下游 ``` 1. **下游消费者**——**脚本从 import/调用关系生成，禁止手写**。手写的依赖清单必然腐烂（变动最频繁、没人记得同步），生成的永远反映真实代码。 2. **回归验收命令**——**台账的核心资产**：每个模块一条"怎么证明我没坏"的**可执行命令**（pytest / 对账脚本 / golden sample diff）。没有这行，审计退化成"AI 看一眼说没问题"（把裁判权交给被告）；有这行，判决就是退出码。 3. **联动规则**——改我 → 谁必须被验证；什么情况可豁免。 ## 与 TESTS.md 的连接 `REGRESSION.md` 不再维护业务规则和测试缺口。它只引用 `TESTS.md` 中稳定的 TEST-ID： ```markdown 关联测试点：TEST-ORDER-001、TEST-REFUND-003 ``` - 哪些规则必须被保护、测试处于什么状态、证据在哪：由 `test-collaboration` skill 和 `TESTS.md` 管理。 - 改了某模块后要重跑哪些模块、执行哪条命令：由本 skill 和 `REGRESSION.md` 管理。 - `/regression-audit` 只按回归台账执行命令和报告退出码，不重复审查测试必要性。 ## 台账纪律 - **验收命令优先"对账型"而非"断言型"**：锚外部事实（golden sample / 上游合计 / 财务勾稽），"测试全过"能被钻（改松断言、注水 mock），"和基准差异 < 0.01"钻不了。 - **下游列表只由重扫刷新**：加了新 import → 重跑生成脚本，不许手补一行了事。 …
Read the whole file at its exact version.
How to install
mdr add qshanx/docs-governance/module-regression@sha256:c09e26de0facaaa2The line at the top of this page pins the label git:20261011.856328d, 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_zhxf3pz4vircc3os)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, all committed on Oct 11, 2026.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261011.856328d latest | 2026-10-11 | 856328d | 7,156 B | A | view · diff |
| git:20261011.d0306dc | 2026-10-11 | d0306dc | 6,725 B | A | view |
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 (7156 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
qshanx/docs-governance · 218 stars · license MIT · pushed 2026-10-16 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_zhxf3pz4vircc3os GET https://markdownregistry.com/api/v1/resolve?ref=qshanx/docs-governance/module-regression GET https://markdownregistry.com/api/v1/blob/c09e26de0facaaa252c6406ec5231b1c3546cda742c80ff8585d223aefef9cc7
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 qshanx/docs-governance
Every file in qshanx/docs-governance