wrapuplisted
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 列出的每个变化文件,按 `一致性机制/文件联动目录.