repo-map SKILL.md skillA
repo-map from hanzhangzzz/agent-skills-zh is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add hanzhangzzz/agent-skills-zh/repo-map@git:20261028.eb66fb8Pins git:20261028.eb66fb8 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- hanzhangzzz/agent-skills-zh
- Path
repo-map/SKILL.md- Versions recorded
- 6
- Latest version
- git:20261028.eb66fb8, committed Oct 28, 2026
- First version recorded
- Jul 13, 2026
- Size
- 11,929 bytes
- Repository stars
- 1
- License
- MIT
Local repository map for multi-repo development: scan every local git repo into an incremental, self-healing index (name, path, read/write role, purpose); a UserPromptSubmit hook auto-injects the path and role whenever a repo name is mentioned, so cross-repo references and edits never need hand-pasted paths; optional macOS launchd scheduled sync keeps new repos in the map. Use when the user works across multiple local repositories or says 仓库地图, repo-map, repo map, 全局项目索引, 跨仓库引用, 找不到本地仓库…
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
# repo-map：本地仓库地图 ## 机制概览（三层识别链路） | 层 | 载体 | 覆盖场景 | 可靠性 | |----|------|---------|--------| | L1 | UserPromptSubmit hook 字符串匹配 | 用户提到明确仓库名 | 确定性 100% | | L2 | 项目 CLAUDE.md「## 关联仓库」节 | 确认过的结构性老关系（选择性沉淀） | 常驻上下文 | | L3 | 全局 CLAUDE.md 一行规则 + `resolve` 命令 | 模糊指代（"那个缺陷分级服务"） | 尽力而为兜底 | 核心不变量：**缓存是纯产物，人永远不维护**。每次 resolve/list/sync 先做低成本一致性检查（find .git 清单 vs 缓存路径集），差集增量分析、死路径自动剪枝。 自愈由谁触发，决定了"新仓库多久进地图"： | 触发方式 | 时机 | 覆盖 | |---------|------|------| | `resolve`/`list` 内置同步 | 用户手动跑命令那一刻 | 被动，不跑就不更新 | | launchd 定时 `sync`（可选，冷启动询问） | 每 N 秒自动 | 主动，新仓库无需任何动作 | `sync` 比 `list` 的增量多做一件事：**重析未成型仓库**（无 remote 或无提交）。刚 `git init` 的仓库会被记成"本地·可写"且无摘要，等它配好远端、有了首次提交，必须复查才能修正角色——纯增量永远不会回头看已存在路径，这是定时任务存在的真正理由。 组件：`scripts/repo_map.py`（scan/resolve/list/sync/schedule）+ `scripts/prompt_hook.py`（hook）。脚本就地运行于 skill 目录，不复制副本（单一事实源）。 ## 安装步骤（幂等，可重复执行） ### 1. 前置检查 `python3 --version`、`git --version`、`~/.claude/settings.json` 存在。任一缺失即停下说明，不带病安装。 ### 2. 探测扫描根，与用户确认 - 从历史 session 反推：`ls ~/.claude/projects/` 的目录名即历史 cwd（`-` 分隔），统计高频路径前缀。 - 辅助验证：对候选前缀 `find <root> -maxdepth 6 -name .git | head` 确认确实有仓库群。 - 把探测结果（根目录 + 预计仓库数）报给用户确认后再写配置。扫描根是配置不是数据——一年变不了一次，手工列出最诚实。 …
Read the whole file at its exact version.
How to install
mdr add hanzhangzzz/agent-skills-zh/repo-map@sha256:13d2dd0f541e1d8bThe line at the top of this page pins the label git:20261028.eb66fb8, 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_c6gl4n4s24btylwy)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 6 versions of this file, between Jul 13, 2026 and Oct 28, 2026, about one every 21 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261028.eb66fb8 latest | 2026-10-28 | eb66fb8 | 11,929 B | A | view · diff |
| git:20261028.e943cc5 | 2026-10-28 | e943cc5 | 11,824 B | A | view · diff |
| git:20260901.4d9bf39 | 2026-09-01 | 4d9bf39 | 11,329 B | A | view · diff |
| git:20260805.148e328 | 2026-08-05 | 148e328 | 11,362 B | A | view · diff |
| git:20260724.1d731c3 | 2026-07-24 | 1d731c3 | 10,918 B | A | view · diff |
| git:20260713.154c5ab | 2026-07-13 | 154c5ab | 7,265 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 (11929 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
hanzhangzzz/agent-skills-zh · 1 stars · license MIT · pushed 2026-10-29 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_c6gl4n4s24btylwy GET https://markdownregistry.com/api/v1/resolve?ref=hanzhangzzz/agent-skills-zh/repo-map GET https://markdownregistry.com/api/v1/blob/13d2dd0f541e1d8bfc467fdd8ae427053aaa299e326eaa7f0466457886ffa7fb
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 hanzhangzzz/agent-skills-zh
Every file in hanzhangzzz/agent-skills-zh