PANYUXIN6/pyx-skills / repo-map-first
repo-map-first
Verified根据源代码证据定位代码归属并判断仓库地图是否可信。适用于归属不明、跨边界行为变更、入口或依赖变更,或地图可能误导代码放置的情况;也适用于明确要求检查、使用、创建或修复地图,以及依赖技能的仓库上下文初始化或验证。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.1 KB |
| references/map-sync-checklist.md | markdown | 1.6 KB |
| references/placement-analysis.md | markdown | 1.1 KB |
| references/staleness-checklist.md | markdown | 1.9 KB |
references/map-sync-checklist.md
View on GitHub# 仓库地图同步检查清单
实施后,如符合以下任一条件,就更新地图文档。
明确要求创建或修复地图时,应在依赖它的实施工作之前完成,即使预计不会改变结构。仅检查或使用地图并不授权修改地图;以下检查适用于已授权的实施工作改变仓库结构之后。
## 更新 `docs/REPO_MAP.md`
- 新文件、目录或模块承担了新的职责。
- 文件或目录被移动或重命名。
- 文件或模块的职责发生变化。
- 新增页面、端点、命令或任务等入口。
- 功能的实际实现位置与旧地图不同。
- 原本由一个模块承担的职责分散到了多个位置。
## 同时更新 `docs/ARCHITECTURE.md`
- 分层关系发生变化。
- 模块依赖方向发生变化。
- 关键调用链或主要流程发生变化。
- 引入了持久的跨模块协作机制。
- 新基础设施或外部系统改变了系统间关系。
## 通常无须更新
- 在既有职责范围内修复缺陷。
- 仅改变局部实现细节,入口、边界和职责均未变化。
- 仅修改测试、注释、文案或样式,且不影响系统结构。
## 最少应记录的内容
- 路径或模块名称;
- 一句话说明职责;
- 所属流程或入口;
- 与相邻模块的关系。
如果文档的 frontmatter 含有 `generated_by` 或 `authority_status`,同步时应保留。没有用户明确确认,不要将 `authority_status: observed` 改为 `confirmed`。
更新后的地图应让后来者无须重读整个代码库,就能找到代码并理解它为何放在那里。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |