system-design-doc SKILL.md skillA
system-design-doc from reddishz/designdoc is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add reddishz/designdoc/system-design-doc@v1.8Pins v1.8 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- reddishz/designdoc
- Path
.agents/skills/system-design-doc/SKILL.md- Versions recorded
- 5
- Latest version
- v1.8, committed Oct 29, 2026
- First version recorded
- Oct 28, 2026
- Size
- 8,026 bytes
- Repository stars
- 15
- License
- MIT
维护由多个子系统组成的系统级设计：子系统注册表、角色 / 边界 / 交互约束、 子系统依赖与外部依赖钉住、系统发布清单与版本对齐。 项目 `ued/README.md` 含子系统注册表时加载；单系统继续使用 design-doc。 子系统内部的分层设计、编码与产品基线由 design-doc 负责，本技能只做系统级编排。.
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
# 系统子系统设计规范
本技能约束**系统级编排**，不重复 design-doc 的文档、编码、状态与产品基线规则。系统由多个子系统组成；每个子系统是一个完整的 design-doc 作用域。
## 核心模型
| 概念 | 位置 | 职责 |
|------|------|------|
| **系统** | `ued/README.md` | 子系统注册表、角色 / 边界 / 交互约束、系统发布清单；**无** `产品版本`，**无** `baselines/` |
| **子系统** | `ued/{目录}/` | 完整的 design-doc 作用域：自有 README、计数器、索引、`产品版本` 与 `baselines/` |
| **系统发布** | `ued/releases/sys-vX.Y.yaml` | 组合锁：钉住本次纳入的子系统与外部依赖的精确版本；不是设计基线，也不要求覆盖全部 `正式` 成员 |
| **共享库** | 普通子系统 | 与业务子系统同规则；可有零个或多个；**不设固定 `shared/`** |
- 子系统之间通过**完整编码**引用，不共享同一个文档作用域。
- 系统根只做入口、注册表、跨子系统规则与发布；**MUST NOT** 成为设计文档作用域。
- 系统级设计内容（愿景、跨子系统需求、系统架构、交互契约）由**承担该职责的普通子系统**承载，或写在系统根 README 的摘要表中；本技能**不规定**固定目录。
- 术语表仍固定为 `ued/glossary.md`（全系统唯一）；子系统校验时用 `--glossary ued/glossary.md`。
## 运行时步骤
1. 判定结构：`ued/README.md` 含**子系统注册表** → 本技能适用；否则是单系统，改用 design-doc。
2. 按任务路由读对应 workflow；仅在需要时打开 rule。
3. 登记 / 激活 / 废弃子系统、创建系统发布前：先给短计划，停在人审 Checkpoint。
4. 改完运行：
```bash
python3 .agents/skills/system-design-doc/scripts/check_system.py -p ued
```
并对每个子系统运行：
```bash
python3 .agents/skills/design-doc/scripts/check_docs.py -p ued/{子系统} --glossary ued/glossary.md
```
跨子系统细项 `依赖`（成环 / 指向他子系统 `初稿`）另跑：
```bash
…Read the whole file at its exact version.
How to install
mdr add reddishz/designdoc/system-design-doc@sha256:100df82d5045a7dfThe line at the top of this page pins the label v1.8, 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_kngna4rt5mv5cmnb)
1 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Oct 28, 2026 and Oct 29, 2026, more than one a day.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v1.8 latest | 2026-10-29 | 9f18e52 | 8,026 B | A | view · diff |
| v1.7 | 2026-10-29 | d7f4a94 | 8,026 B | A | view · diff |
| v1.6 | 2026-10-29 | c91b1c8 | 8,026 B | A | view · diff |
| v1.5 | 2026-10-29 | d9a47d3 | 7,841 B | A | view · diff |
| v1.4 | 2026-10-28 | 6bea5a6 | 7,706 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 (8026 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
reddishz/designdoc · 15 stars · license MIT · pushed 2026-10-29 · branch master
API
GET https://markdownregistry.com/api/v1/artifacts/art_kngna4rt5mv5cmnb GET https://markdownregistry.com/api/v1/resolve?ref=reddishz/designdoc/system-design-doc GET https://markdownregistry.com/api/v1/blob/100df82d5045a7df68fd0505b7e9bf6f9aa62b3282a81fa0e5538d6ac8a0a83c
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.