worktree-dev SKILL.md skillA

worktree-dev 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/worktree-dev@git:20261013.2cee0af

Pins git:20261013.2cee0af 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/worktree-dev/SKILL.md
Versions recorded
3
Latest version
git:20261013.2cee0af, committed Oct 13, 2026
First version recorded
Oct 6, 2026
Size
5,959 bytes
Repository stars
27
License
none declared

基于 Git Worktree 的隔离开发工作流。在 worktree 中开发新功能、修复缺陷或做验证时使用;分支合并回主分支(多 worktree 并发合并无需排队加锁)见文末.

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

# Git Worktree 开发工作流

基于 Git Worktree 提供完全隔离的独立工作区,支持多任务并发开发、独立服务调试与安全合入。

---

## 一、生命周期速查

```
[1. 创建 Worktree] ──> [2. 环境初始化 & 启动] ──> [3. 独立开发 & 提交] ──> [4. 合入主分支] ──> [5. 收尾清理]
git worktree add       init/dev-worktree.sh        git commit                  merge-to-main.sh      git worktree remove
```

---

## 二、规范约定(命名与路径)

- **分支命名**:`feat/<name>` 或 `fix/<name>`
- **工作区路径**:仓库根目录下的 `.worktrees/<name>`(`<name>` 为分支名末段,**不含斜杠**)
- **Git 忽略**:仓库根目录 `.gitignore` 必须包含 `.worktrees/`

---

## 三、标准执行流程

### 1. 创建工作树

在仓库根目录下切出独立分支与对应 worktree:

```bash
# 从主分支(master / main)创建隔离工作区
git worktree add -b feat/<name> .worktrees/<name> master
cd .worktrees/<name>
```

### 2. 环境初始化与服务启动

worktree 内建议维护两个约定脚本(根据项目实际情况在 `scripts/` 中创建或提炼):

| 脚本 | 职责与约定 |
|---|---|
| `scripts/init-worktree.sh` | 依赖安装、环境与配置初始化 |
| `scripts/dev-worktree.sh`  | 动态申请端口 → 启动服务 → 输出访问地址(供 E2E 验证及用户体验) |

#### 端口分配原则(严禁硬编码)

worktree 内启动任何监听端口的服务(开发服务器、E2E 实例、Mock 服务等),**必须通过 `acquire-port` 动态申请端口**,禁止硬编码端口号(如 `3000`):

```bash
# 方式 1:脚本变量捕获(最常用)
PORT=$(acquire-port --wait)
npm run dev -- --port "$PORT"

# 方式 2:包装执行(自动注入 $PORT / $PORTS 环境变量)
acquire-port --wait --exec npm run dev -- --port "$PORT"
```

> **说明**:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add john-walks-slow/rabbit-skills/worktree-dev@sha256:5c3dbd27e58ad14a

The line at the top of this page pins the label git:20261013.2cee0af, 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_fnqdfx3mnbrb4nza.svg)](https://markdownregistry.com/a/art_fnqdfx3mnbrb4nza)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, between Oct 6, 2026 and Oct 13, 2026, about one every 4 days. Its first recorded version is graded B and its latest A.

versioncommittedcommitsizeaudit
git:20261013.2cee0af latest2026-10-13 2cee0af 5,959 BA view · diff
git:20261009.f0bd5e32026-10-09 f0bd5e3 5,348 BB view · diff
git:20261006.e99f7c02026-10-06 e99f7c0 5,066 BB 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 (5959 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_fnqdfx3mnbrb4nza
GET https://markdownregistry.com/api/v1/resolve?ref=john-walks-slow/rabbit-skills/worktree-dev
GET https://markdownregistry.com/api/v1/blob/5c3dbd27e58ad14a74c63d5142bcf4597b0472a81ab0f5b33c9153e2e41f6a97

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
code-deep-dive SKILL.md skill
john-walks-slow/rabbit-skills · .apm/skills/code-deep-dive/SKILL.md · 为 vibe coding 项目编写中文深度 markdown 长文。
git:20261031.a5d6e68 · 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

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

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