improve-codebase-architecture SKILL.md skillA
improve-codebase-architecture from vinvcn/mattpocock-skills-zh-cn is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add vinvcn/mattpocock-skills-zh-cn/improve-codebase-architecture@git:20261008.5be0dc1Pins git:20261008.5be0dc1 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- vinvcn/mattpocock-skills-zh-cn
- Path
skills/engineering/improve-codebase-architecture/SKILL.md- Versions recorded
- 5
- Latest version
- git:20261008.5be0dc1, committed Oct 8, 2026
- First version recorded
- Aug 11, 2026
- Size
- 5,770 bytes
- Repository stars
- 5,110
- License
- MIT
扫描代码库中的深化机会，生成可视化 HTML 报告，然后围绕你选中的候选项继续追问。.
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
# 改进代码库架构 暴露 architectural friction，并提出 **deepening opportunities**：把 shallow modules 变成 deep modules 的 refactors。目标是 testability 和 AI-navigability。 这个命令由项目的 domain model 提供信息，并建立在共享 design vocabulary 上： - 调用 Skill 工具并指定 `codebase-design`，获取 architecture vocabulary（**module**、**interface**、**depth**、**seam**、**adapter**、**leverage**、**locality**）及其 principles（deletion test、"the interface is the test surface"、"one adapter = hypothetical seam, two = real"）。每条建议都准确使用这些术语，不要漂移到 "component"、"service"、"API" 或 "boundary"。 - `GLOSSARY.md` 中的 domain language 会为好的 seams 命名；`docs/adr/` 中的 ADRs 记录这个命令不应重新争论的 decisions。 ## 流程 ### 1. 探索 **先划定扫描范围：YAGNI。** 深化 module 的收益在于让未来修改更容易，因此要更关注最近仍在变化的 codebase 区域。开始探索前先决定去哪里看： - 如果用户点名了方向（module、subsystem 或 pain point），就按该方向探索，跳过下面的推断。 - 否则，向前回看一段足够长的 commit history（`git log --oneline`），找出反复出现的 files 和 areas，让这些 hot spots 成为首要关注点。如果变更分散、没有明显 hot spot，再扩大范围。 先读取项目 domain glossary（`GLOSSARY.md`）以及你将触碰区域的 ADRs。 然后 spawn 一个 sub-agent 来遍历 codebase。不要套死板 heuristics；自然探索，并记录你感到 friction 的地方： - 理解一个概念是否需要在许多小 modules 之间来回跳？ - 哪些 modules 是 **shallow** 的，即 interface 几乎和 implementation 一样复杂？ …
Read the whole file at its exact version.
How to install
mdr add vinvcn/mattpocock-skills-zh-cn/improve-codebase-architecture@sha256:e97f2738acd31d68The line at the top of this page pins the label git:20261008.5be0dc1, 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_cz4bvc7ledmasdcb)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Aug 11, 2026 and Oct 8, 2026, about one every 14 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261008.5be0dc1 latest | 2026-10-08 | 5be0dc1 | 5,770 B | A | view · diff |
| git:20261008.f659bb3 | 2026-10-08 | f659bb3 | 5,796 B | A | view · diff |
| git:20260928.3f92a83 | 2026-09-28 | 3f92a83 | 5,795 B | A | view · diff |
| git:20260921.49ef591 | 2026-09-21 | 49ef591 | 5,795 B | A | view · diff |
| git:20260811.b46e155 | 2026-08-11 | b46e155 | 5,735 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 (5770 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
vinvcn/mattpocock-skills-zh-cn · 5,110 stars · license MIT · pushed 2026-10-20 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_cz4bvc7ledmasdcb GET https://markdownregistry.com/api/v1/resolve?ref=vinvcn/mattpocock-skills-zh-cn/improve-codebase-architecture GET https://markdownregistry.com/api/v1/blob/e97f2738acd31d68afbbfa415166db3cfd8ea7000562b5a7067084d02e54813b
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 vinvcn/mattpocock-skills-zh-cn
Every file in vinvcn/mattpocock-skills-zh-cn