Cleanup

---
name: cleanup
description: "整理本次任务影响的文档、代码、生成物、临时文件和恢复状态，支持完成、阻塞或交接。检查无漂移可零修改结束，不扩展为全仓清理。"
---

# Knowledge Cleanup

使本次任务的记录与实际结果一致。完成、阻塞、放弃和交接都可整理，不要求先获得 ready 才能记录未完成工作。

## 流程

1. 明确本任务/轨道及其权威入口；无持久任务记录时可直接检查本次 diff。多个独立轨道可同时 active，不修改其他轨道来凑唯一工作面。
2. 只检查本次改变影响的 README、指令、接口文档、生成物和已有恢复记录。只有证据显示跨文档漂移或用户要求全量整理时扩大范围。
3. 清理本任务引入的代码遗留：死代码、未用导入和依赖、被替代的旧实现、孤儿脚本与过期生成物。删除以引用证据为准，删后跑针对性检查确认行为不变；会改变行为的清理转 `implement` 修复路径，不当作纯整理。
4. 任务关闭（complete/abandoned/blocked/换轨）走退休契约四步，同一 commit 内完成：翻行 → lessons 继承（本轨道计划/Spec 的非显然经验先蒸馏，含未批准/放弃件）→ 删本轨道 plan/Spec 文档，含未批准与放弃件（git 历史即归档）→ state 同步（保留最后快照，Status 随行翻转）。删除前置＝改动已 commit 进主树且 lessons 继承完成；入度守卫＝只删唯一入边来自本退休轨道的文档，多入边翻指针不删；既有归档目录（docs/archive/ 类）内容一律归 needs-review 待人裁，不入可删档；ADR 不删，补 superseded-by。文档活判据＝可达性（被恢复面状态文件或持久入口引用）。untracked 文件不走删除，处置出口＝补 commit 或补 .gitignore 二选一。非 harness backend（tracker/existing/feature-list 等）降级映射：翻行＝把 tracker 原生状态翻到对应终态，其余各步对应件（lessons、plan/Spec 文档、state）缺省即跳过该步，退休纪律不因缺件整体失效。四步按件适用：本轨道无 plan/Spec 文档 → 删除步为空；无带触发条件的非显然经验 → lessons 继承记「无新增」；翻行与 state 同步两步任何情形不省。
5. 清理本任务创建且已无用途的 scratch。未知归属或仍有用途的文件保留并说明；不因为 untracked、旧日期或临时命名就删除。
6. 生成物通过现有生成器更新，仅在输入变化时重建。无差异可零修改完成。本次新踩的坑（环境、流程、依赖）按 lessons 格式落笔到项目恢复面的 lessons；项目为 harness backend 而 lessons 文件不存在时，随首次落笔创建（三段式：触发 → 坑 → 正确做法），失效条目随手删。
7. 报告任务状态、修改/归档、保留事项及恢复入口。不得把 cleanup 完成写成原任务已完成。

## 按需读取

- 计划过期：`references/doc-shelves.md`。
- 临时文件归属：`references/entropy-checklist.md`。
- 交接：`references/handoff-hygiene.md`。
- 领域风险：`../review/references/cross-cutting-anti-patterns.md`（未安装 review 时跳过此参考，按本文件流程与证据规则执行）。

## Recommended next skill

- 整理完成：结束。
- 仍有已授权行为修改：`implement`；未知失败：`diagnose`。
- 用户显式要求全仓 Python 死代码清理：`remove-deadcode-py`；其他生态直接用对应工具（JS/TS knip、Go `deadcode`、Rust cargo-machete）。
- 用户显式要求全仓对账/盘点/大扫除，或发现跨文档漂移、用户要求全量整理：`sweep`。
- 新增工作超出任务：记录后续事项，不自动执行。