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/staleness-checklist.md
View on GitHub# 仓库地图时效性检查清单
用此清单判断相关地图信息是否可信。过时地图是需要调查的线索,不是应直接遵循的权威。
## 缺失或信息不足
- 当前调用模式要求的 `docs/REPO_MAP.md` 或 `docs/ARCHITECTURE.md` 不存在。
- 相关文档只列名称,缺少本任务所需的职责、入口或关系。
- 与任务有关的模块或边界未被记录。
- 地图无法说明放置变更所需的当前入口、归属、依赖方向或跨模块关系。
## 明显过时或相互矛盾
- 当前目录、模块、服务、页面、端点或任务未出现在相关地图中。
- 文件或目录已移动或重命名,地图仍使用旧路径。
- 入口或关键流程已变化,地图仍描述旧路径。
- 地图记录的职责归属与当前代码不符。
- `REPO_MAP.md` 与 `ARCHITECTURE.md` 相互矛盾。
## 根据调用模式处理
- **明确要求检查或使用:** 对照源码验证相关陈述并报告缺口或矛盾;不要仅因地图缺失或过时就创建或修复文档。
- **明确要求创建、修复或更新:** 在依赖地图的实施工作之前,按请求范围和现有证据创建或修复文档。
- **自动位置风险模式:** 根据源码验证放置方案。只有缺失或过时信息妨碍安全放置,或任务将改变持久结构时,才在实施前创建或修复地图;否则不要只因地图不存在就补文档。
- **仓库上下文初始化:** 只创建缺失的文档。除非发起请求的技能明确扩大范围,否则不要修复或覆盖已有的配套文档。
- **仓库上下文验证:** 只验证依赖任务的相关范围。修复过时的 `observed` 陈述,保留准确部分;遇到未标记或已确认的权威内容发生矛盾时,报告问题而不要覆盖。
未经用户明确确认,不得将 `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 |