khazix-skills/neat-freak
End-of-session knowledge cleanup with OCD-level rigor — reconciles project docs (CLAUDE.md, README.md, docs/) and agent memory against the code so nothing rots. 会话结束后对项目文档和记忆进行洁癖级审查与同步。MUST trigger when the user says: "sync up", "tidy up docs", "update memory", "clean up docs", "/sync", "/neat", "同步一下", "整理文档", "整理一下", "更新记忆", "梳理一下", "收尾", "这个阶段做完了", "新人能直接上手", or any phrase suggesting a dev milestone where knowledge needs reconciliation. Also trigger when the user reports stale docs, conflicting memories, or wants a clean handoff to teammates or other agents. Bare "整理" / "tidy" with prior dev context counts — do not under-trigger. Cross-platform: works on Claude Code, OpenAI Codex, OpenCode, and OpenClaw.
90
90%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
agent-paths.mdreferences/
Agent 记忆与配置路径速查
不同 agent 平台的记忆系统和项目配置文件位置不一样。执行第一步盘点时按你正在使用的平台查这张表。
Claude Code
| 用途 | 路径 |
|---|---|
| 跨会话记忆(全局) | ~/.claude/projects/<encoded-project-path>/memory/ |
| 记忆索引文件 | ~/.claude/projects/<...>/memory/MEMORY.md |
| 全局指令 | ~/.claude/CLAUDE.md |
| 项目级指令 | 项目根 CLAUDE.md(可层级嵌套) |
| Skills 目录 | ~/.claude/skills/<name>/SKILL.md |
记忆文件用 YAML frontmatter:name、description、type(user / feedback / project / reference)。
OpenAI Codex
| 用途 | 路径 |
|---|---|
| 跨会话指令(全局) | ~/.codex/AGENTS.md 或 $CODEX_HOME/AGENTS.md |
| 项目级指令 | 项目根 AGENTS.md(可层级嵌套) |
| 项目级 override | AGENTS.override.md(若存在,覆盖同目录 AGENTS.md) |
| Skills 目录 | ~/.codex/skills/<name>/SKILL.md 或项目内 .codex/skills/<name>/ |
Codex 没有独立的"记忆文件 + 索引"机制,所有跨会话信息都直接写在 AGENTS.md 里。同步时把"项目事实"那部分内容统一放 AGENTS.md。
发现项目里有 TEAM_GUIDE.md 或 .agents.md 也要看——这是 Codex 的 fallback 文件名。
OpenClaw
| 用途 | 路径 |
|---|---|
| 用户级 skills | ~/.openclaw/skills/<name>/SKILL.md（首次运行自动创建） |
| 项目级 skills | .openclaw/skills/<name>/SKILL.md（仓库根目录下） |
| Workspace skills | 当前 workspace 的 skills/ 目录 |
加载优先级：workspace > project-agent > personal-agent > managed/local > bundled > extra dirs。同名 skill 高优先级覆盖低优先级。
OpenClaw 没有独立的"记忆文件 + 索引"机制，跨会话信息可放在项目根的 markdown（CLAUDE.md / AGENTS.md / 等价文件）里，参照 Codex 的做法。frontmatter 支持 metadata.openclaw 字段做加载时的 gating（按 OS、环境变量、二进制依赖筛选），但不是 neat-freak 必需的。
OpenCode
| 用途 | 路径 |
|---|---|
| 全局配置 | ~/.config/opencode/ |
| 项目配置 | .opencode/ |
| Skills 目录(项目) | .opencode/skills/、.claude/skills/、.codex/skills/ 都会被扫描 |
| Skills 目录(全局) | ~/.config/opencode/skills/、~/.claude/skills/、~/.codex/skills/ |
OpenCode 同时读取 Claude Code 和 Codex 的目录,所以同一个 skill 装在 ~/.claude/skills/ 下的话三家都能识别。OpenClaw 走自己的 ~/.openclaw/skills/，需要单独装一份（或用符号链接）。
如果当前 agent 没有独立记忆系统
跳过"记忆"那一层,把功夫全花在:
- 项目根 markdown(CLAUDE.md / AGENTS.md / 本平台等价文件)
- README.md
- docs/
仍然是有效的同步——记忆是锦上添花,docs 才是项目知识的最低保障。
跨平台共存策略
如果一个项目同时被 Claude Code 用户和 Codex 用户使用,推荐:
- 项目根同时放
CLAUDE.md和AGENTS.md,内容可以互相 symlink 或在两边维护 - 或者一份内容主文件 + 另一份用一行
See CLAUDE.md跳转 - docs/ 和 README 是平台中立的,不需要分两份