cleanuplisted
Install: claude install-skill YSAA1/harness-workflow
# 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
- 整理完成:结束。
- 仍有已授权行为修改:`impl