Skip to content

PANYUXIN6/pyx-skills / repo-map-first

repo-map-first

Verified

根据源代码证据定位代码归属并判断仓库地图是否可信。适用于归属不明、跨边界行为变更、入口或依赖变更,或地图可能误导代码放置的情况;也适用于明确要求检查、使用、创建或修复地图,以及依赖技能的仓库上下文初始化或验证。

references/staleness-checklist.md

View on GitHub
# 仓库地图时效性检查清单

用此清单判断相关地图信息是否可信。过时地图是需要调查的线索,不是应直接遵循的权威。

## 缺失或信息不足

- 当前调用模式要求的 `docs/REPO_MAP.md` 或 `docs/ARCHITECTURE.md` 不存在。
- 相关文档只列名称,缺少本任务所需的职责、入口或关系。
- 与任务有关的模块或边界未被记录。
- 地图无法说明放置变更所需的当前入口、归属、依赖方向或跨模块关系。

## 明显过时或相互矛盾

- 当前目录、模块、服务、页面、端点或任务未出现在相关地图中。
- 文件或目录已移动或重命名,地图仍使用旧路径。
- 入口或关键流程已变化,地图仍描述旧路径。
- 地图记录的职责归属与当前代码不符。
- `REPO_MAP.md` 与 `ARCHITECTURE.md` 相互矛盾。

## 根据调用模式处理

- **明确要求检查或使用:** 对照源码验证相关陈述并报告缺口或矛盾;不要仅因地图缺失或过时就创建或修复文档。
- **明确要求创建、修复或更新:** 在依赖地图的实施工作之前,按请求范围和现有证据创建或修复文档。
- **自动位置风险模式:** 根据源码验证放置方案。只有缺失或过时信息妨碍安全放置,或任务将改变持久结构时,才在实施前创建或修复地图;否则不要只因地图不存在就补文档。
- **仓库上下文初始化:** 只创建缺失的文档。除非发起请求的技能明确扩大范围,否则不要修复或覆盖已有的配套文档。
- **仓库上下文验证:** 只验证依赖任务的相关范围。修复过时的 `observed` 陈述,保留准确部分;遇到未标记或已确认的权威内容发生矛盾时,报告问题而不要覆盖。

未经用户明确确认,不得将 `authority_status: observed` 改为 `confirmed`。证据不足时说明限制,不要推断预期架构。
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall