design-doc SKILL.md skillA
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/design-doc@v10.10Pins v10.10 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/design-doc/SKILL.md- Versions recorded
- 23
- Latest version
- v10.10, committed Oct 29, 2026
- First version recorded
- Sep 13, 2026
- Size
- 11,333 bytes
- Repository stars
- 15
- License
- MIT
维护**单一作用域**的 ued/ 分层设计文档、需求编码、架构决策、验证/EVAL、 术语表与产品基线。作用域可以是单系统 `ued/`，也可以是系统内的一个子系统 `ued/{subsystem}/`；由多个子系统组成的系统级注册表、依赖钉住与发布由 system-design-doc 负责。 **design-doc是极其重要的技能，应作为每次开发和设计的基础。** 项目有 ued/ 时，改功能、修缺陷或按需求实现代码前 MUST 先对照设计： 需改设计则先文档后代码；禁止先写代码再补设计。 亦用于创建、审查、更新设计文档与基线发版。.
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
# 产品设计文档规范（UED）
本 skill **约束 AI 的执行方式**，不是人类写作教程。**规则与流程在 `references/`**；本文是运行时路由：选对 workflow、守住不变量、该停则停。
措辞强度见 [coding-system.md · 需求级别说明](references/coding-system.md#需求级别说明)。
## 一致性（无冲突）
包内与 `ued/` 内**同一规则只允许一种表述**。发现技能包两处不一致、或设计文档之间/与基线冲突 → 视为**规范缺陷**，当轮修正或列入人审后修正；**MUST NOT** 用「优先级表」掩盖冲突。定稿与发布前审查须确认无未解消冲突。
## 运行时步骤
1. 确认当前作用域存在设计树：单系统为 `ued/`，系统内为 `ued/{subsystem}/`；解析配置见 [runtime-config.md](references/workflows/runtime-config.md)。
2. 若 `ued/README.md` 含**子系统注册表**，说明这是系统根而非单作用域：系统级用 [system-design-doc](../system-design-doc/SKILL.md)，本技能只对每个 `ued/{subsystem}/` 运行。若含 `应用注册表` / `app_key` / `doc_mode`，说明是 9.x 旧多应用结构：停止并指向 system-design-doc 的迁移流程，**MUST NOT** 当单系统继续。
3. 按下方**任务路由**加载对应 workflow（**MUST read**）；仅在流程分支需要时再打开所列 rule。
4. 解冻、废弃、批量编码或动基线前：先短计划，人审停点见各 workflow 的 Checkpoint。
5. 改完跑 `check_docs.py`；通过≠语义正确。子系统校验用 `--glossary ued/glossary.md`；检查器按系统注册表只读解析其他子系统的文档编码与术语块，仅用于术语表 `定义位置`。
6. **仅当**本轮改过 `ued/`、要定稿/提交、或有基线漂移须询问时，再加载 [lifecycle.md](references/workflows/lifecycle.md) 走 Checkpoint 5；未改设计文档则不必读 lifecycle。
## 任务路由
| 意图 | MUST 先读 |
|------|-----------|
…Read the whole file at its exact version.
How to install
mdr add reddishz/designdoc/design-doc@sha256:d885dcc4359b0345The line at the top of this page pins the label v10.10, 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_5h2pbiql7uplal5d)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 23 versions of this file, between Sep 13, 2026 and Oct 29, 2026, about one every 2 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v10.10 latest | 2026-10-29 | 9726ef9 | 11,333 B | A | view · diff |
| v10.9 | 2026-10-29 | a19448f | 11,332 B | A | view · diff |
| v10.8 | 2026-10-29 | 9f18e52 | 11,332 B | A | view · diff |
| v10.7 | 2026-10-29 | c91b1c8 | 11,332 B | A | view · diff |
| v10.6 | 2026-10-29 | d9a47d3 | 10,929 B | A | view · diff |
| v7.0 | 2026-10-16 | 7de825e | 7,300 B | A | view · diff |
| v7.0 | 2026-10-16 | b79b4f3 | 7,088 B | A | view · diff |
| v6.7 | 2026-10-13 | 514deb5 | 31,572 B | A | view · diff |
| v6.6 | 2026-10-12 | 72266e9 | 31,479 B | A | view · diff |
| v6.5 | 2026-10-12 | fa138a2 | 31,320 B | A | view · diff |
| v6.4 | 2026-10-12 | 898bf6b | 31,320 B | A | view · diff |
| v6.3 | 2026-10-09 | bbf802e | 30,926 B | A | view · diff |
| v6.2 | 2026-10-08 | b17132b | 30,680 B | A | view · diff |
| v6.1 | 2026-10-08 | b8ce7c1 | 27,686 B | A | view · diff |
| v6.1 | 2026-10-08 | 02370a5 | 27,055 B | A | view · diff |
| v6.1 | 2026-10-08 | 27f51ea | 25,148 B | A | view · diff |
| v6.0 | 2026-10-08 | 1d8742e | 24,245 B | A | view · diff |
| v5.1 | 2026-09-14 | c0cadef | 22,934 B | A | view · diff |
| v5.0 | 2026-09-14 | f43e23a | 22,380 B | A | view · diff |
| v4.8 | 2026-09-14 | b934789 | 21,419 B | A | view · diff |
| v4.7 | 2026-09-14 | 1a364a7 | 21,398 B | A | view · diff |
| v4.6 | 2026-09-13 | 90e9044 | 21,246 B | A | view · diff |
| v4.5 | 2026-09-13 | 1ceea68 | 21,041 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 (11333 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_5h2pbiql7uplal5d GET https://markdownregistry.com/api/v1/resolve?ref=reddishz/designdoc/design-doc GET https://markdownregistry.com/api/v1/blob/d885dcc4359b034568c2764313a97d8f064a8012ef9d818a2e9239f8d7e7a51b
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 reddishz/designdoc
Every file in reddishz/designdoc