architecture-audit SKILL.md skillA
architecture-audit from suge8/friedbun is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add suge8/friedbun/architecture-audit@git:20261009.443953aPins git:20261009.443953a in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- suge8/friedbun
- Path
skills/development/architecture-audit/SKILL.md- Versions recorded
- 3
- Latest version
- git:20261009.443953a, committed Oct 9, 2026
- First version recorded
- Oct 8, 2026
- Size
- 3,106 bytes
- Repository stars
- 12
- License
- MIT
架构体检：找出该合并加深的浅模块，用 eli5 图解呈现，再为选中的一项并行设计几种接口。.
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
# 架构体检 找出值得加深的模块：接口几乎和实现一样复杂、理解一个概念要在许多小文件间来回跳、bug 藏在调用方式里的地方。目标是改一处就够、测试只打一个入口。 ## 1. 圈范围 用户指了模块、子系统或痛点就只看那里。否则沿较长一段 `git log --oneline` 找反复改动的热点，优先看它们；改动分散时再扩大。按 [fan-out](../fan-out/SKILL.md) 中档按热点拆片，交回摩擦点及证据（文件、调用方）。 判断一个模块是不是透传层，用**删除测试**：想象删掉它，复杂度随之消失的是透传层；复杂度散回 N 个调用方的，它在干活。 ## 2. 呈现 按 [eli5](../eli5/SKILL.md) 把候选画成图解，文件放 `$TMPDIR`，不进仓库。每个候选讲清：涉及文件、问题、改法、收益（用行为说：改价格规则只动一个文件，不写「更易维护」）、改前改后对比图、推荐强度（值得做 / 值得探索 / 推测）、依赖类别（见下）。最后说最先做哪一个及原因。此时不提接口方案，问用户想展开哪一个。 ## 3. 设计接口 用户选定后，先写一段约束说明（新接口必须满足什么、依赖属于哪一类、一段粗略代码示意）给用户看，同时按 fan-out 高档并行出 3 个以上截然不同的接口： - 最小接口：1–3 个入口，每个入口承担尽量多的行为。 - 最大灵活：支持多种用例与扩展。 - 为最常见的调用方优化：默认情况最简单。 - （跨进程依赖时）围绕端口与适配器设计。 每份方案交回：接口（类型、不变量、调用顺序、错误形态）、调用示例、藏在接口后面的东西、依赖与适配器、强弱处。逐个展示后比较：调用方学一个接口能用到多少行为、改动会不会集中在一处、接口放在哪。给出明确推荐，能取长补短就提混合方案。需要逐项和用户对齐决策时用 [grilling](../../workflow/grilling/SKILL.md)。 ## 依赖类别 类别决定加深后怎么测： 1. **进程内**（纯计算、内存状态）：直接合并，经新接口测试。 2. **可本地替代**（PGLite 代 Postgres、内存文件系统）：用替代物测，不在接口上开端口。 3. **自有远程服务**：接口处定义端口，生产用 HTTP/队列适配器，测试用内存适配器。 4. **第三方服务**（Stripe 等）：作为注入的端口，测试给模拟适配器。 ## 判断规则 - 只有一个适配器的端口是假设，两个（通常是生产 + 测试）才是真的；不够两个就别开端口，那只是多一层间接。 - 内部接缝可以给自己的测试用，不为此暴露到接口上。 - 加深后，浅模块上的旧单元测试删掉；改动按 [better-test](../better-test/SKILL.md) 从新接口的真实入口验证。
Read the whole file at its exact version.
How to install
mdr add suge8/friedbun/architecture-audit@sha256:39990de24521a9bcThe line at the top of this page pins the label git:20261009.443953a, 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_4av4kdrk5gfoh4mq)
1 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 3 versions of this file, between Oct 8, 2026 and Oct 9, 2026, more than one a day.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261009.443953a latest | 2026-10-09 | 443953a | 3,106 B | A | view · diff |
| git:20261008.6378243 | 2026-10-08 | 6378243 | 3,112 B | A | view · diff |
| git:20261008.3911d61 | 2026-10-08 | 3911d61 | 3,085 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 (3106 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
suge8/friedbun · 12 stars · license MIT · pushed 2026-10-21 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_4av4kdrk5gfoh4mq GET https://markdownregistry.com/api/v1/resolve?ref=suge8/friedbun/architecture-audit GET https://markdownregistry.com/api/v1/blob/39990de24521a9bcfe1c0e850c0064a2687332e6fb59b8f87bf1628c5ba3cb9e
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.