DESIGN.md@md2viewA
DESIGN.md@md2view from hanzhangzzz/agent-skills-zh is a DESIGN.md file: the design rules coding agents follow in that repo.
mdr add hanzhangzzz/agent-skills-zh/md2view/DESIGN.md@git:20260831.3dc09f5Pins git:20260831.3dc09f5 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 14 of 14 checks passed
- Kind
- DESIGN.md file
- Repository
- hanzhangzzz/agent-skills-zh
- Path
md2view/DESIGN.md- Versions recorded
- 4
- Latest version
- git:20260831.3dc09f5, committed Aug 31, 2026
- First version recorded
- Aug 10, 2026
- Size
- 2,799 bytes
- Repository stars
- 1
- License
- MIT
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
# md2view 设计依据 - Status: v4 当前生效(2026-08-10 重构) - Active contract: `SKILL.md`、`references/design-system.md`、`references/diagram-cookbook.md`、`references/anti-patterns.md` ## v4 为什么存在 v3(2026-08-06 前)的路线:模型只写 `view-spec.json`(typed entities/relations/facts/region tree),确定性 family renderer 生成全部 HTML,二十余道合同门 + 独立盲读 verdict + 原子晋升。 它在真实语料上系统性地产出"结构正确但表达愚蠢"的页面:516 行架构设计文档被投影成"flow 结构视图 1/2/3",每张两个框一根箭头。根因不是模型弱,而是架构分工错误: 1. **把溯源当成第一目标** → 每个 block 都必须有 carrier,不值得画图的内容也被画成图。 2. **把图法当成默认输出** → 流程是"分配 block → 套 renderer",而不是"理解 → 判断 → 选择形式"。 3. **renderer 太强,模型太弱** → 设计决策(要不要图、什么形式、怎么合并)被模板接管,模型退化成填 JSON。 4. **合同把"有内容"误认为"有表达"** → coverage 证明来源出现了,证明不了图值得画。 5. **模型从生成到交付看不见任何东西** → 写 JSON 盲盒,直到外部 reviewer 才有人看图。 v4 的反转:**溯源不需要模型只写 JSON,只需要模型在自由创作的 HTML 上标注来源锚点,且确定性层能验证这些锚点**。于是: - 确定性层(不可谈判):`parse_blocks.py`(来源账本)、`build_reader.py`(左栏权威原文 + 双栏壳 + 锚点联动)、`verify_anchors.py`(覆盖、词法锚点、数字逐字、原子单元)。 - 模型层(自由但有纪律):右栏 `right-pane.html` 完全由模型设计与手写;纪律只有 data-sources 锚点、词法锚点、数字逐字三条,外加强制截图自审 ≥2 轮。 - 设计系统(`assets/shell.css` 的 mv-* 词汇)是质量地板;模型的组合自由是天花板。 ## 验证哲学 机器门只验证**可核证性**(来源存在、覆盖完整、词法锚住、数字忠实、结构安全),不验证**表达价值**——后者由"生产者亲眼截图自审"负责。不再使用"审美分数""结构合法性代替好看"之类的代理指标。 …
Read the whole file at its exact version.
How to install
mdr add hanzhangzzz/agent-skills-zh/md2view/DESIGN.md@sha256:30479cf4d17eee63The line at the top of this page pins the label git:20260831.3dc09f5, 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_dybmnmmfkh3cbubc)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 4 versions of this file, between Aug 10, 2026 and Aug 31, 2026, about one every 7 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260831.3dc09f5 latest | 2026-08-31 | 3dc09f5 | 2,799 B | A | view · diff |
| git:20260810.200e614 | 2026-08-10 | 200e614 | 2,839 B | A | view · diff |
| git:20260810.b54c8eb | 2026-08-10 | b54c8eb | 40,014 B | A | view · diff |
| git:20260810.f824dbf | 2026-08-10 | f824dbf | 38,852 B | A | view |
Audit of the latest version
- pass: Size between 200 bytes and 200 KB (2799 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
hanzhangzzz/agent-skills-zh · 1 stars · license MIT · pushed 2026-10-29 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_dybmnmmfkh3cbubc GET https://markdownregistry.com/api/v1/resolve?ref=hanzhangzzz/agent-skills-zh/md2view/DESIGN.md GET https://markdownregistry.com/api/v1/blob/30479cf4d17eee63edd6150d4c8827392ebecb869d3c19086e97d9ff789164c9
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: what DESIGN.md is and how agents use it · which agent file does what.