← ClaudeAtlas

catchuplisted

Restore a repository's project context from PROJECT.md, Git history, pending changes, and focus files, then report what is done, in progress, blocked, and next. Use when the user asks to catch up, resume prior work, load project state, understand where a project stopped, or begin a new session in a repository using Project Consistency Kit.
sparkler233/project-consistency-kit · ★ 1 · AI & Automation · score 69
Install: claude install-skill sparkler233/project-consistency-kit
<!-- 一致性机制 version: 2026-08-18 --> 新对话开局,把项目当前状态完整装载进来再继续工作。Agent harness 已经注入 `AGENTS.md`(Codex)或其适配链接 `CLAUDE.md`(Claude Code),**不要再次读取这两份指令文件**。 > 配套出向工作流是 `wrapup`(Codex: `$wrapup`;Claude Code: `/wrapup`)。机制见 `一致性机制/机制设计说明.md`。 ## 第一层:项目事实 1. ��整读取 `PROJECT.md`——背景、流程、地图、阶段与近期决策的唯一正本。 2. 只检查适配入口的**文件类型与目标**,不读取内容: ```bash test -f AGENTS.md test -L CLAUDE.md && readlink CLAUDE.md ``` 健康状态:`AGENTS.md` 是实体文件,`CLAUDE.md` 是相对链接 `AGENTS.md`。 3. `PROJECT.md` 不存在时进入**旧版兼容模式**:读取 `README.md` 判断项目概况,并在报告中明确提示“缺少 PROJECT.md,建议迁移���;不要把 README 永久认定为项目事实正本。 ## 第二层:项目状态(git 是事件源) 1. 已沉淀事件: ```bash git log --oneline -20 ``` 2. 尚未收尾的工作: ```bash git status --short ``` 3. 自上次 wrapup 以来的完整范围(含已 commit 未同步): ```bash if git rev-parse -q --verify refs/tags/synced >/dev/null; then d=$(git diff --stat synced); [ -n "$d" ] && printf '%s\n' "$d" || echo "(已同步:synced 已在 HEAD,无新改动)" else echo "(无 synced tag,尚未执行过 wrapup)" fi ``` 4. 完整读取 `PROJECT.md` 之外的中枢文档(见 `一致性机制/文件联动目录.md` Part A)。`AGENTS.md` / `CLAUDE.md` 已由 harness 注入,跳过内容读取;README 只有列入 Part A 或处于旧版兼容模式时才读。 > 不是 git repo → 报“项目未纳入 git,一致���机制未生效”,退回只读现有文件判断状态。 ## 第三层:当前焦点 `git status` 中未提交 / 未跟踪的文件是最高优先级焦点。逐个完整读取,弄清上次写到哪里。 | 线索 | 跟进动作 | |------|----------| | 某文本文件被改 | 直接读该文件 | | 最近 commit 提到某主题 | 找对应文件 / 目录 | | 二进制目录有变化 | 读取对应 `_manifest.md` | - 工作区有未提交文件 → 直接读它们。 - 工作区干净但要续上一个方向 → 看最近提交及对应文件。 - 完全无线索 → 报告中写“未识别到当前焦点文件”。 ## 第四层:全景扫描 从仓库实际状态派生,不维护固定目录清单: ```bash git rev-par