architect-4r-cn SKILL.md skillA
architect-4r-cn from ontology-of-everything/semanticskills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add ontology-of-everything/semanticskills/architect-4r-cn@v0.1.0Pins v0.1.0 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- ontology-of-everything/semanticskills
- Path
skills/zh-CN/architect-4r-cn/SKILL.md- Versions recorded
- 1
- Latest version
- v0.1.0, committed Nov 4, 2026
- Size
- 4,002 bytes
- Repository stars
- 13
- License
- Apache-2.0
基于李运华的 4R 方法，从上下文讨论或源代码中总结系统模型，生成图文结合的架构文档。.
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
# 4R 架构
## 核心认识
4R 是把系统讲清楚的逻辑框架：在一个确定的观察层级，说明系统由什么组成、各部分怎样联系，以及如何协作完成目标。
同一个系统可以有不同视图。每个视图关注一类问题，关键场景把它们联系起来。这延续了 4+1 视图模型中“多角度描述、用场景检验”的思想。
## 四个维度
### Rank：从哪一级观察
确定讨论的范围与粒度，例如企业、系统、服务、模块或代码。
同一个对象，在整体图中可能只是一个角色，展开后又成为包含多个角色的系统。Rank 决定当前保留哪些细节，以及哪些细节属于下一层。
### Role：系统由什么组成
角色是当前层级中的关键组成部分，对应结构图中的节点。
角色可以是业务能力、子系统、服务、模块或基础设施。角色的意义在于职责：它承担什么工作，与其他角色的责任边界在哪里。
### Relation：角色怎样联系
关系是角色之间的调用、依赖、信息传递或资源共享，对应结构图中的连线。
关系说明谁与谁联系、方向是什么、交换什么。角色与关系共同描述系统的静态结构。
### Rule：角色怎样协作
规则说明角色在具体场景中，如何按照条件与顺序共同完成业务。
它包括请求流转、状态变化、异常处理，以及协作必须满足的约束。时序图和流程图用于表达这些运行规则。
Relation 说明存在什么联系，Rule 说明这些联系在什么时候、按什么条件发挥作用。
## 同一个系统的不同视图
| 观察角度 | Role：主要角色 | Relation：主要联系 | Rule：主要规则 |
|---|---|---|---|
| 业务 | 业务能力、部门、参与者 | 业务协作、信息与价值流转 | 从业务发起到完成的过程 |
| 系统 | 子系统、服务、外部系统 | 调用、消息、数据共享 | 跨系统协作与失败处理 |
| 应用内部 | 模块、组件、类、接口 | 调用、依赖、继承与实现 | 请求处理与状态变化 |
| 部署 | 运行实例、机器、网络设施 | 网络连接、流量转发 | 路由、扩缩容与故障切换 |
各视图描述同一个系统：业务能力由应用实现，应用代码形成运行单元，运行单元部署到基础设施。它们之间可以是多对多关系。
## 例子：一笔支付
在系统协作这一层，订单服务管理订单，支付服务管理支付过程，外部支付渠道执行扣款。
```mermaid
flowchart LR
O["订单服务"] -->|"发起支付"| P["支付服务"]
P -->|"请求扣款"| C["外部支付渠道"]
C -->|"通知扣款结果"| P
P -->|"通知支付结果"| O
```
这张图给出了 Role 与 Relation。运行还需要 Rule：
…Read the whole file at its exact version.
How to install
mdr add ontology-of-everything/semanticskills/architect-4r-cn@sha256:2fcf786a2ce12f07The line at the top of this page pins the label v0.1.0, 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_neafqoy6cr74xycl)
0 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Nov 4, 2026.
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 (4002 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
ontology-of-everything/semanticskills · 13 stars · license Apache-2.0 · pushed 2026-11-05 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_neafqoy6cr74xycl GET https://markdownregistry.com/api/v1/resolve?ref=ontology-of-everything/semanticskills/architect-4r-cn GET https://markdownregistry.com/api/v1/blob/2fcf786a2ce12f0713a1770d134f3a58aed868c22953e6de3c7b091ecbbfd6cb
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 ontology-of-everything/semanticskills
Every file in ontology-of-everything/semanticskills