Tooluck logoTooluck
SKILL.md

neat-freak

Agent skill fromKKKKhazix/khazix-skills

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, or auditing whether workspace rules are actually followed. Do not trigger for pure coding/refactoring/debugging tasks, tidying data or prose (JSON, 周报, changelog announcements), or a bare "整理" with no project-knowledge context.

How to install neat-freak

install neat-freak
# install the khazix-skills pack with the skills CLI
npx skills add KKKKhazix/khazix-skills

# or add only this skill to Claude Code: copy the folder

neat-freak/

# into

~/.claude/skills/neat-freak/ (all projects)

.claude/skills/neat-freak/ (one project)

neat-freak/SKILL.md

MITFull file
1# 洁癖 — Knowledge and Governance Closeout
2
3你是知识库编辑、规范审计员和收尾者。目标不是「多写一点」,而是让代码、真实运行态、项目文档、Agent 规则、获准维护的记忆和工作区状态彼此一致,让下一次会话或第一次接手的人能找到唯一现役答案。
4
5## 完成合同
6
7一次洁癖收尾只有在相关事实面都得到明确状态后才算完成:
8
9| 事实面 | 要回答的问题 | 常见证据 |
10|---|---|---|
11| 代码 | 现在真正实现了什么? | 当前分支、schema、配置、测试 |
12| 运行态 | 用户实际得到什么? | deploy marker、服务、真实页面/API、控制台 |
13| 文档 | 人和下游看到的是不是现役答案? | README、架构、接入、运维文档 |
14| 规则 | Agent 收到的约束是否同源、可执行、无死引用? | 层级 CLAUDE.md/AGENTS.md、override、hooks |
15| 记忆 | 快照是否仍准确且允许修改? | 平台记忆入口、索引、生成来源 |
16| 工作区 | 是否仍有未集成或未审计的残留? | 会话残留文件、worktree、分支、临时库 |
17
18每一面标成 `verified-current`、`changed-and-verified`、`pending`、`out-of-scope` 或 `not-applicable`。小项目不必硬凑六个面:没有部署就没有运行态面,没有记忆系统就没有记忆面——如实标 `not-applicable`,不要编造证据。不要把 `git status` 干净、PR 已合并或测试通过单独当成「全部同步」。发布状态必须区分 draft、PR、merged、deployed、live verified、knowledge closed 和 cleaned。
19
20## 权限和范围先于洁癖
21
22当前系统、用户和项目规则始终高于本 skill。洁癖扩大检查深度,不扩大操作权限。
23
24先判断请求属于哪一档:
25
261. **文档同步**:当前项目的代码/文档/规则一致性;记忆默认只读,除非用户或项目收尾规则明确授权写入。
272. **知识收尾**:文档、规则、获准维护的记忆和会话复盘。
283. **发布收尾**:在知识收尾之外核对本地、远端、生产和 live surface;知识凭证完成后才能清场。
294. **工作区审计**:只有用户明确说「整个 workspace / 全部项目 / 审全部」时,才逐项目扩大内容审计。
30
31清场按用户在当前任务中已经给出的授权执行。用户已明确要求完成后清理时,核实合并、上线、工作区干净且没有唯一内容后直接收尾;不要求汇报后再次批准。没有授权、对象超出授权范围或含未集成的独有内容时,列出具体对象和理由再询问。年龄、大小、被忽略或会话结束都不能证明可删。
32
33默认写入边界是当前项目。可以只读检查直接上级规则和同级项目名字,以发现命名或死引用;不要因此改名、移动、删除或编辑范围外项目。跨项目依赖被本次改动实际影响时,先报告影响面,再按现有授权决定是否同步下游。
34
35删除、重命名、停服、权限/密钥、不可逆迁移、外部代发等动作服从现场规则;没有授权就列为待决。安全、可逆的小修在授权范围内可以直接做。
36…

Excerpt shown under the repository's MIT license.

More skills in khazix-skills

Keep exploring

Similar skill repositories

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates