neat-freaklisted

Knowledge and governance closeout: reconcile project docs, rule files (CLAUDE.md/AGENTS.md), authorized agent memory, and workspace residue with what the code and runtime actually do, so the next session or the next person starts from one current answer. Trigger when the user names "neat-freak", "洁癖", or "/neat" — and also on clear knowledge-closeout intent without the name: syncing or tidying project docs/rules/memory after development ("把文档和记忆整理一下", "收尾时把文档同步掉", "docs 和代码对不上了"), stale or conflicting CLAUDE.md/memory, a clean handoff to a teammate or a fresh session, auditing whether workspace rules are actually followed, or auditing whether every stated requirement across the conversation is actually closed ("我的需求都完成了吗", "需求都搞定了吗", "需求闭环审计", "全部对话的需求都闭环了吗"). Do not trigger for pure coding/refactoring/debugging tasks, tidying data or prose (JSON, 周报, changelog announcements), or a bare "整理" with no project-knowledge context.
kuangketongxue/kuang-skills · ★ 0 · Data & Documents · score 75

Install: claude install-skill kuangketongxue/kuang-skills

> **3.2.0（2026-09-10）** 对齐用户 CLAUDE.md 铁律 + 修实证缺陷：① 第 7 步「需要用户决定的」改为强制 AskUserQuestion 双卡片制（原为纯文本模板，违反用户固定交互约定）；②「待你确认」加不抛注意力琐碎过滤；③ 记忆审计段要求读 `BUDGET`(70% 预警) / `PROMOTE_CANDIDATE` / `ALREADY_PROMOTED` 三段，不能只看 verdict；④ 与 self-improving-agent 重复的「第一步」块统一并标注同源约束（此前已漂移）；⑤ 汇报段绑定确定性验证纪律。 > 3.1.1（2026-09-09）时间戳化 transcript、Windows 绝对路径、`NF_REPORT`/`NF_TRANSCRIPT` 机检入口。 # 洁癖 — Knowledge and Governance Closeout 你是知识库编辑、规范审计员和收尾者。目标不是「多写一点」，而是让代码、真实运行态、项目文档、Agent 规则、获准维护的记忆和工作区状态彼此一致，让下一次会话或第一次接手的人能找到唯一现役答案。 ## ⚠️ 第一步永远是：回顾全量会话（强制，不受 /compact 影响）收尾审计前必须先拉全量本次会话的用户消息，列清本次会话所有需求/改动/踩坑——这是"现役事实矩阵"（第 1 步）的用户需求侧输入。compact 只压缩 LLM 上下文窗口、不动磁盘 transcript jsonl，**只看最近几轮或会话内摘要会漏审 compact 前的需求**（曾漏 outdoor v2.5.3、think-aloud 部署、飞书字段规则等明确需求），导致收尾遗漏。运行提取脚本（真逻辑在 `~/.claude/skills/_shared/extract_transcript.py`，与 self-improving-agent 同源；`~` 和 `/tmp` 在 Windows python 不认，**必须用绝对路径**）： ``` TS=$(date +%Y%m%d-%H%M%S) python "C:/Users/kuang/.claude/skills/neat-freak/scripts/extract_transcript.py" --all --out "C:/Users/kuang/AppData/Local/Temp/nf-transcript-$TS.md" ``` - **默认行为**：扫全部 jsonl（等价 `--all`，覆盖 compact 前后 + 跨 session 连续工作）+ 按消息 timestamp 只保留最近 24 小时（聚焦本次会话，不扫历史全量）；按 `isSidechain`/`isMeta` 标志过滤 tool_result / system-reminder 注入 / task-notification / skill body 全文（这是过滤 skill body 污染的最可靠标志，标签检测会漏），只留真实用户文本 + 用户调过的命令名 - **参数**：`--hours N` 调时间窗（`--hours 0` 关闭过滤取全部历史，仅用户明确要跨天全量审计时用，输出大务必 `--out` 写文件分段 Read）；`--n N` 调文件数量；`<path>` 指定单文件；`--no-ledger` 关闭跨会话 ledger - **Windows 必