ximing-progressive-project SKILL.md skillA
ximing-progressive-project from ximing/vital is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add ximing/vital/ximing-progressive-project@git:20261021.2674a2aPins git:20261021.2674a2a in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- ximing/vital
- Path
.claude/skills/ximing-progressive-project/SKILL.md- Versions recorded
- 1
- Latest version
- git:20261021.2674a2a, committed Oct 21, 2026
- Size
- 11,219 bytes
- Repository stars
- 3
- License
- none declared
把现有项目重构为适合 Claude Code 的持久化指令渐进式加载架构。用户提到“拆分根 CLAUDE.md”、“按目录下沉规则”、“给当前项目设计分层指令文件”、“创建不同目录的 CLAUDE.md”、“补 `.claude/rules`”、“把仓库改造成渐进式加载”时使用。技能默认不仅解释加载机制,还会基于仓库结构直接设计并落地最合适的指令文件布局。.
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
# 渐进式项目指令架构 ## 目的 本技能不是单纯解释 Claude Code 如何加载指令。 本技能的默认目标是: 1. 识别当前仓库的结构与目录职责 2. 判断哪些规则应该放在根级、目录级、路径级 3. 将项目重构为最合适的渐进式加载架构 4. 创建或改写合适的 `CLAUDE.md`、嵌套 `CLAUDE.md`、`.claude/rules/*.md` 如果仓库可访问,默认直接分析并改文件,而不是只停留在解释层。 ## 适用场景 以下请求应直接使用本技能: - “帮我把当前项目改成渐进式加载” - “这个仓库怎么拆 CLAUDE.md 才合理” - “根据目录职责生成不同的 CLAUDE.md” - “帮我补 `.claude/rules`” - “根规则太大了,帮我下沉到子目录” - “想让 Claude 进入不同目录时加载不同约束” - "请根据 Claude Code 的持久化指令机制重构项目规则" ## 成功标准 完成后应满足: - 根 `CLAUDE.md` 足够精简,只保留全局基线 - 子目录规则只在进入对应区域时加载 - 跨目录但可按文件模式命中的规则放到 `.claude/rules/*.md` 并带 `paths` - 不为每个目录机械生成规则,只覆盖真正有语义边界的区域 - 现有规则体系没有被打散成多个互相冲突的真相源 ## 加载模型速记 设计前先基于以下事实判断,不要偏离: ### Claude Code 加载机制 #### 启动时加载 Claude 会从当前工作目录向上加载可见的: - `CLAUDE.md` - `CLAUDE.local.md` - `.claude/CLAUDE.md` - `.claude/rules/` 中未被更窄作用域限制的内容 #### 按需加载 以下内容只有在 Claude 真正进入相关区域时才加载: - 子目录中的 `CLAUDE.md` - 带 `paths` 的 `.claude/rules/*.md` - 更深层目录中的局部规则 #### 导入不是懒加载 如果根 `CLAUDE.md` 通过 `@...` 导入大段内容,被导入内容会跟着根文件一起进入上下文。 因此: - `@...` 用于复用与维护 - 不要把它当成主要的渐进式加载机制 ## 设计原则 ### 1. 根文件只放基线 根 `CLAUDE.md` 只放: - 仓库级目标与架构概览 - 必须全局生效的工程约束 - 常用构建、测试、提交流程入口 - 指引性说明:更细规则分布在哪些区域 不要把包级、页面级、框架级细节堆在根文件。 ### 2. 目录规则只为“稳定语义边界”服务 只有同时满足以下至少两项,才值得单独建局部 `CLAUDE.md`: - 目录职责稳定 …
Read the whole file at its exact version.
How to install
mdr add ximing/vital/ximing-progressive-project@sha256:291716a0a1444b43The line at the top of this page pins the label git:20261021.2674a2a, 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_27uzpe5pnz226doz)
1 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Oct 21, 2026.
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 (11219 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
ximing/vital · 3 stars · license none declared · pushed 2026-10-21 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_27uzpe5pnz226doz GET https://markdownregistry.com/api/v1/resolve?ref=ximing/vital/ximing-progressive-project GET https://markdownregistry.com/api/v1/blob/291716a0a1444b43247cbe246106528303c159a69cfbe1cb759e7e653cb4667f
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.