worktree-isolation SKILL.md skillA
worktree-isolation from ccoalm/ccl-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add ccoalm/ccl-skills/worktree-isolation@git:20261004.5fc0d87Pins git:20261004.5fc0d87 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- ccoalm/ccl-skills
- Path
skills/worktree-isolation/SKILL.md- Versions recorded
- 10
- Latest version
- git:20261004.5fc0d87, committed Oct 4, 2026
- First version recorded
- Aug 16, 2026
- Size
- 13,964 bytes
- Repository stars
- 6
- License
- Apache-2.0
开工前先在独立 git worktree 里再改代码——**绝不在 main（主检出/main 分支）上开发**，任何迭代/功能/哪怕一行修改都先建分支+worktree（并发只是让这条更刚性，单人单线同样适用）；worktree 集成回目标分支后立即清理 worktree+本地分支+远端分支（让位见收尾节）。Never develop on the main checkout/branch — always create a dedicated worktree first (concurrency only makes it stricter, not a precondition); also covers teardown/cleanup when a worktree is integrated. 触发：凡要动代码，动手前先过本技能 Step 0（由 owner 在其实现阶段调用，本技能不抢交付入口）、并行做两个版本、改 ccl-skills 等共享仓库、被隔离闸 deny、worktree 干完要清理时。Skip…
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
# Worktree Isolation（编辑隔离） ## 核心心法 主检出（main 那个工作树）是**干净的基线/集成点，不是开发现场**。每个迭代/任务在**自己的 worktree** 里做。并行的两个迭代 = 两个 worktree，互不碰主检出 → 天生不会 clobber。 **「天生不会 clobber」只覆盖 git 工作树 / 索引 / 分支——不覆盖仓外的共享运行时状态。** 独立 worktree 让并行 lane 互不碰彼此的 tracked 文件和 index，但不隔离仓外共享面,大致三类:①**共享服务/端口**——同一本机的测试库 / 消息队列 / 缓存服务、监听端口（如 `:3000`）、docker compose 工程名与卷；②**共享文件状态**——共享的 `.env`、跨 worktree 共享的可变 `node_modules` / `.venv` / build 输出 / 生成物目录、固定 `/tmp` 路径；③**主机全局配置与凭据**——`$HOME` 下的工具配置与 auth profile、`KUBECONFIG` / gcloud·kubectl 当前 context / cloud·registry 凭据、`~/.npmrc`、浏览器/设备 profile（切错 context 会让另一条 lane 的 migration/deploy/install 打到错误目标——是**权限/目标**级 clobber，不止数据）。两个 worktree 同时跑 `pytest` / migration / dev server / deploy 会在这些面互踩——一方的 migration 或 fixture 清库毁掉另一方、端口占用失败、缓存串写、或打到错误集群。所以并行前先隔离:每条 lane 独立的 DB/schema/namespace、不同端口、独立 compose project 与卷、每 worktree 自己的**可变**依赖安装/构建/输出目录、独立的 `KUBECONFIG`/配置 profile 并显式传 context 而非依赖全局当前值（并发安全的内容寻址/只读缓存可共享,不必强拆——如 pnpm store、Go module cache;cargo 仅指依赖下载缓存,**不含** `$CARGO_HOME` 的 config/凭据/`bin`/registry index/`target`;只拆会被并发写坏的可变面）;**隔离不了的共享面就把那部分工作串行**（呼应 `multi-agent-delegation` 的「共享 state / migration / 生成物就串行或留本地」）。单人单线顺序跑通常不触发,但共享库残留脏数据或残留的全局 context 仍可能跨… …
Read the whole file at its exact version.
How to install
mdr add ccoalm/ccl-skills/worktree-isolation@sha256:25833675f213ab7eThe line at the top of this page pins the label git:20261004.5fc0d87, 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_cbvpkxm7kh5bkvbh)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 10 versions of this file, between Aug 16, 2026 and Oct 4, 2026, about one every 5 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261004.5fc0d87 latest | 2026-10-04 | 5fc0d87 | 13,964 B | A | view · diff |
| git:20261004.1109396 | 2026-10-04 | 1109396 | 13,672 B | A | view · diff |
| git:20261004.863fb14 | 2026-10-04 | 863fb14 | 12,349 B | A | view · diff |
| git:20260913.bf0020b | 2026-09-13 | bf0020b | 38,112 B | A | view · diff |
| git:20260907.87995ee | 2026-09-07 | 87995ee | 38,153 B | A | view · diff |
| git:20260819.3177427 | 2026-08-19 | 3177427 | 39,209 B | A | view · diff |
| git:20260819.d01ddfb | 2026-08-19 | d01ddfb | 39,230 B | A | view · diff |
| git:20260818.6e3a61d | 2026-08-18 | 6e3a61d | 39,212 B | A | view · diff |
| git:20260816.9325dd4 | 2026-08-16 | 9325dd4 | 40,735 B | A | view · diff |
| git:20260816.97d9aac | 2026-08-16 | 97d9aac | 39,777 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 (13964 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
ccoalm/ccl-skills · 6 stars · license Apache-2.0 · pushed 2026-10-09 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_cbvpkxm7kh5bkvbh GET https://markdownregistry.com/api/v1/resolve?ref=ccoalm/ccl-skills/worktree-isolation GET https://markdownregistry.com/api/v1/blob/25833675f213ab7e5f70d4ded9453d364d53a30bc3b51951b7e7eca3b4b2bdbe
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 ccoalm/ccl-skills
Every file in ccoalm/ccl-skills