Skip to content

PANYUXIN6/pyx-skills / repo-map-first

repo-map-first

Verified

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

references/map-sync-checklist.md

View on GitHub
# 仓库地图同步检查清单

实施后,如符合以下任一条件,就更新地图文档。

明确要求创建或修复地图时,应在依赖它的实施工作之前完成,即使预计不会改变结构。仅检查或使用地图并不授权修改地图;以下检查适用于已授权的实施工作改变仓库结构之后。

## 更新 `docs/REPO_MAP.md`

- 新文件、目录或模块承担了新的职责。
- 文件或目录被移动或重命名。
- 文件或模块的职责发生变化。
- 新增页面、端点、命令或任务等入口。
- 功能的实际实现位置与旧地图不同。
- 原本由一个模块承担的职责分散到了多个位置。

## 同时更新 `docs/ARCHITECTURE.md`

- 分层关系发生变化。
- 模块依赖方向发生变化。
- 关键调用链或主要流程发生变化。
- 引入了持久的跨模块协作机制。
- 新基础设施或外部系统改变了系统间关系。

## 通常无须更新

- 在既有职责范围内修复缺陷。
- 仅改变局部实现细节,入口、边界和职责均未变化。
- 仅修改测试、注释、文案或样式,且不影响系统结构。

## 最少应记录的内容

- 路径或模块名称;
- 一句话说明职责;
- 所属流程或入口;
- 与相邻模块的关系。

如果文档的 frontmatter 含有 `generated_by` 或 `authority_status`,同步时应保留。没有用户明确确认,不要将 `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