← ClaudeAtlas

wrapuplisted

Close a Project Consistency Kit work cycle by recovering current-session decisions, comparing all changes since the synced horizon, checking linkage rules, updating approved files, and preparing a user-confirmed local commit and synced tag. Use when the user asks to wrap up, synchronize project records, reconcile linked documentation, checkpoint completed work, or finish a repository session.
sparkler233/project-consistency-kit · ★ 1 · AI & Automation · score 69
Install: claude install-skill sparkler233/project-consistency-kit
<!-- 一致性机制 version: 2026-08-18 --> 把「上次同步以来发生的一切」系统性收尾:捕获改动 → 补 B 类事件 → 查联动 → 用户确认 → 落盘 → 提交。 > 机制动机见 `一致性机制/机制设计说明.md`,联动规则见 `一致性机制/文件联动目录.md`。 > `wrapup` 是**兜底工具,不是流程门禁**——用户可随时手工改 / commit;本工作流只把漏的联动补上、把改动收尾。 ## 步骤 0 · 前置检查 - 不是 git repo(`git rev-parse --is-inside-work-tree` 失败)→ 提示「项目未纳入 git,一致性机制无法运行」并退出。 - `一致性机制/文件联动目录.md` 不存在 → 提示「联动目录未建立」并退出。 - `PROJECT.md` 不存在 → 提示「项目仍是旧版文件模型,请先告诉 Agent“给这个项目引入一致性机制”;也可使用当前 Harness 的显式安装器入口」并退出;不要把决策重新写回 README 或 Agent 指令文件。 - 检查 `AGENTS.md` 是实体文件、`CLAUDE.md` 是相对链接 `AGENTS.md`;异常计入步骤 4 联动计划,不通过重复维护两份内容来补救。 ## 步骤 1 · B 类事件 safety net git 只看得见文件改动。**决策、对外对接、口头约定**这类事发生在对话里,不直接产生文件 → 先补这一层。 1. 回看**本次对话历史**,找「已发生 B 类事件、但还没写进任何文件」的。 2. 列清单问用户:「这些要补写吗?」对**决策**类,规范落点是 `PROJECT.md` 关键决策记录(联动目录规则 2)。 3. 用户确认后**立刻写入目标文件**——这样它们就变成下一步 git 能看见的改动。 > 局限:safety net 只够得到**当前会话**的对话。跨会话未落盘的 B 类事件捞不回——所以结束会话前建议执行一次 wrapup。 ## 步骤 2 · 确定本轮同步范围(horizon = `synced`) **sync horizon 不是 HEAD,是上次已同步的提交**,用 git tag `synced` 标记。这样即便用户中途手工 commit 过,那些改动仍会被本轮联动检查到(不会被 HEAD 吞掉)。 1. 检查 `synced` tag 是否存在: ```bash git rev-parse -q --verify refs/tags/synced ``` 2. **存在** → 本轮范围 = 自 `synced` 以来工作区的全部改动: ```bash git diff --stat synced # 概览 git diff --name-status synced # 逐文件(含已 commit 未同步的 + 未 commit 的) git status --short # 兜底看未跟踪文件 ``` 3. **不存在**(首次同步)→ 范围 = 全部已跟踪改动 + 未跟踪文件: ```bash git status --short ``` 4. 范围为空 → 报「无改动可同步」并退出(除非步骤 1 已补写了文件)。 ## 步骤 3 · 查联动目录 + manifest 对账 对步骤 2 列出的每个变化文件,按 `一致性机制/文件联动目录.