code-deep-dive SKILL.md skillA
code-deep-dive from john-walks-slow/rabbit-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add john-walks-slow/rabbit-skills/code-deep-dive@git:20261031.a5d6e68Pins git:20261031.a5d6e68 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- john-walks-slow/rabbit-skills
- Path
.apm/skills/code-deep-dive/SKILL.md- Versions recorded
- 2
- Latest version
- git:20261031.a5d6e68, committed Oct 31, 2026
- First version recorded
- Aug 9, 2026
- Size
- 9,527 bytes
- Repository stars
- 27
- License
- none declared
为 vibe coding 项目编写中文深度 markdown 长文。.
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
# Code Deep-Dive 为 vibe coding 项目编写**中文深度 markdown 长文**,让用户在碎片时间用手机补齐全栈代码知识。 ## 核心场景 - **用户是谁**:vibe coder——用自然语言指挥 AI 写代码,但对自己项目的底层机制缺乏系统理解。 - **何时触发**:用户指定一个主题,想深入理解它,把"AI 替他写出来的代码"变成"他自己懂的知识"。 - **学习场景**:不在电脑前。通勤、午休、睡前,用手机阅读。 - **输出形态**:单篇 markdown 文件,中文,约 1.5 小时学习时长,完全自包含,配丰富外部链接。 ## 不可妥协的五条原则 这五条是本文档的基础,写作时的所有细节规范都从它们推导。先理解"为什么",再执行具体规则。 ### 1. 自包含——学习时不在电脑前 用户学习时看不到代码,也搜不了资料。因此: - 文章中**每个被讲解的代码片段都必须完整内嵌**,标注来源文件路径。禁止只写"见 `src/foo.py` 第 42 行"而不贴代码。 - 所有需要的前置概念都在文中解释,默认读者零基础。禁止"你应该知道 X"这种甩锅式写法。 - 文中引用的每个外部链接都要有**一句话说明**:讲了什么、适合什么阶段。用户在手机/平板上随时可以点开——说明文字帮他们判断"这个链接值不值得现在点开"。 ### 2. 深度优先——把代码讲透 一篇文章的价值在于把主题**讲透**,而不是复述项目的现状。**代码是文章的主体**:项目代码是教学载体和入口,核心与周边的代码逻辑都要讲透——不追求逐行抠细节,但核心机制和它周边的配套机制(被调用的依赖、相邻模块、生态中的同类机制)必须讲到位。正文还要覆盖: - 核心概念的全貌(不限于项目用到的部分) - 底层原理:机制如何实现、为何这样设计、有什么权衡 - 历史脉络:为什么会出现、解决了什么问题、后来如何演化 项目里没体现但主题相关的部分,一样要讲。这才能支撑起 1.5 小时的学习时长。 ### 3. 代码讲解——讲清"它实际是什么",而不是"它应该是什么" 本文的核心动作是**讲解代码**。姿态不带评价: - **讲清实际行为**:这段代码做什么、怎么工作、数据怎么流、和谁交互。把代码的"实际样子"如实讲清楚——这正是读者拿去定位问题、规划重构的依据。 - **不做价值评判**:既不唱赞歌("我们深思熟虑地选择了这个方案"),也不批判("这段代码有缺陷,应该改")。代码讲透了,哪里不对劲、哪里要动,读者自己看得出来——你的任务是让"看得出来"成为可能。 - **不虚构动机**:代码为什么长这样,只讲客观可考的因果(依赖关系、语言特性、历史沿革、遗留设计)。编造"当初为什么这么选"的叙事是不诚实的——大多数代码不是精心设计出来的。 …
Read the whole file at its exact version.
How to install
mdr add john-walks-slow/rabbit-skills/code-deep-dive@sha256:30b65c7bcf94cb65The line at the top of this page pins the label git:20261031.a5d6e68, 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_43i2acg7wj64ug5j)
5 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, between Aug 9, 2026 and Oct 31, 2026, about one every 83 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261031.a5d6e68 latest | 2026-10-31 | a5d6e68 | 9,527 B | A | view · diff |
| git:20260809.a7569fc | 2026-08-09 | a7569fc | 10,328 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 (9527 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
john-walks-slow/rabbit-skills · 27 stars · license none declared · pushed 2026-11-02 · branch master
API
GET https://markdownregistry.com/api/v1/artifacts/art_43i2acg7wj64ug5j GET https://markdownregistry.com/api/v1/resolve?ref=john-walks-slow/rabbit-skills/code-deep-dive GET https://markdownregistry.com/api/v1/blob/30b65c7bcf94cb658eac917f11cf121fda5e35bc22227382c22a3e07660ef404
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.