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.

Install it, pinned
mdr add john-walks-slow/rabbit-skills/code-deep-dive@git:20261031.a5d6e68

Pins 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

The exact contents, by fingerprint
mdr add john-walks-slow/rabbit-skills/code-deep-dive@sha256:30b65c7bcf94cb65

The 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_43i2acg7wj64ug5j.svg)](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.

versioncommittedcommitsizeaudit
git:20261031.a5d6e68 latest2026-10-31 a5d6e68 9,527 BA view · diff
git:20260809.a7569fc2026-08-09 a7569fc 10,328 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • 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

GitHub

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.

More from john-walks-slow/rabbit-skills

bad-smell SKILL.md skill
john-walks-slow/rabbit-skills · .apm/skills/bad-smell/SKILL.md · 识别到代码坏味道时,阅读本技能并及时重构。例:重复代码,过长函数,过大的类,过长参数列,数据泥团,依恋情结,基本类型偏执,重复的 Switch,拒绝遗赠,发散式变化,霰弹式修改。
git:20261030.60282cf · audit A · 27 stars
commit-own-changes SKILL.md skill
john-walks-slow/rabbit-skills · .apm/skills/commit-own-changes/SKILL.md · 基于 git-hunk 提交改动,防止带入其他无关的未提交修改。事关安全,在执行任何 `git add`,`git commit` 命令前 **必须** 使用本技能。例外:若你当前在单独 worktree 中工作,则无需使用本技能。
git:20261006.6e3c0b4 · audit A · 27 stars
cross-check SKILL.md skill
john-walks-slow/rabbit-skills · .apm/skills/cross-check/SKILL.md · 使用子代理对当前的想法、结论、计划或决策进行批判性检查和核实。当你对计划感到不踏实;感觉某个结论"可能有问题但说不清";决策证据不充足;决策判断失误代价高、希望二次确保准确性时主动使用。
git:20261031.a5d6e68 · audit A · 27 stars
grilling SKILL.md skill
john-walks-slow/rabbit-skills · .apm/skills/grilling/SKILL.md · 围绕计划对用户进行刨根问底的追问。当用户想厘清计划的疑难点,或使用任何 "grill" 相关关键词时使用。
git:20261031.a5d6e68 · audit A · 27 stars
handoff SKILL.md skill
john-walks-slow/rabbit-skills · .apm/skills/handoff/SKILL.md · 编写交接文档,将工作上下文传递给另一个 agent、同事、检视者或 oncall。可选参数:目标受众或方向(例如 "to reviewer"、"给 QA"、"for oncall")。
git:20260711.ac4022a · audit A · 27 stars
implement-review SKILL.md skill
john-walks-slow/rabbit-skills · .apm/skills/implement-review/SKILL.md · 实施与检视循环。在软件工程类项目中实施中等规模以上的修改时,实施代码修改并通过检视循环打磨到准入。
git:20261102.ccdf8fe · audit A · 27 stars
max-effort SKILL.md skill
john-walks-slow/rabbit-skills · .apm/skills/max-effort/SKILL.md · max-effort 模式。在对用户精力消耗最少的情况下,将简略 idea 转变为具有极致体验的完整可交付产物。
git:20261031.a5d6e68 · audit A · 27 stars
research-plan SKILL.md skill
john-walks-slow/rabbit-skills · .apm/skills/research-plan/SKILL.md · 需求调研设计。在软件工程类项目中,进行中等以上规模需求开发、架构设计和重构前必须遵守此流程制定计划。
git:20261102.ccdf8fe · audit A · 27 stars
similar-idea SKILL.md skill
john-walks-slow/rabbit-skills · .apm/skills/similar-idea/SKILL.md · 寻找相似项目/点子,让用户了解市场现状,防止重复造轮子
git:20261031.a5d6e68 · audit A · 27 stars
spawn-deep-researcher SKILL.md skill
john-walks-slow/rabbit-skills · .apm/skills/spawn-deep-researcher/SKILL.md · 使用 deep-researcher 子代理进行深度调研。常规查询、简单事实验证或基础搜索直接在当前会话完成,无需使用。拉起 deep-researcher 前必须阅读。
git:20261030.ab6f92f · audit A · 27 stars
spawn-e2e-tester SKILL.md skill
john-walks-slow/rabbit-skills · .apm/skills/spawn-e2e-tester/SKILL.md · 使用 e2e-tester 子代理进行端到端测试。拉起 e2e-tester 子代理前必须阅读。
git:20261011.07d265d · audit A · 27 stars
spawn-reviewer SKILL.md skill
john-walks-slow/rabbit-skills · .apm/skills/spawn-reviewer/SKILL.md · 使用 reviewer 子代理进行高质量的代码审查。拉起 reviewer 子代理前必须阅读。
git:20260714.5f75a5d · audit A · 27 stars

Every file in john-walks-slow/rabbit-skills

Browse by kind, by grade A, or by owner.