code-deep-dive skillA
code-deep-dive is agent-read markdown (skill) from john-walks-slow/rabbit-skills: 为 vibe coding 项目编写中文深度 markdown 长文，帮助用户在碎片时间（通勤、午休、睡前，手机观看）补齐代码知识。每次由用户明确指定主题（如某个框架机制、某段核心逻辑、某个技术概念），输出一篇完全自包含（代码完整内嵌、无需电脑即可学习）、附带充分外部链接与资料、单篇学习时长约 1.5 小时的深度长文，保存到项目的 docs/learning/ 目录。用户可要求 format=html 生成带目录、交互测验、代码高亮的单文件网页版。当用户说'帮我写一篇学习 XX 的文章'、'把这个项目的 XX 讲透'、'我想深入理解 XX 原理'、'碎片时间想学一下 XX'、'写一篇 XX 的深度笔记'，或任何 vibe coding 后想系统补齐代码知识的请求时，务必使用本技能，即使没有明确提到'文章'或'笔记'字样。.
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns 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@git:20260809.a7569fcmdr add john-walks-slow/rabbit-skills/code-deep-dive@sha256:a09fe8bbf8eb4088Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_43i2acg7wj64ug5j)
1 badge views in 30 days
Versions
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 (10328 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 · 14 stars · license none · pushed 2026-09-20 · 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/a09fe8bbf8eb4088b7ac4fec345a658ec274af2716b917111635a7515871f3be
Your agent 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.