用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/tomevault-io/skills-registry --skill neat-freak命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
| Use when this capability is needed.
> Use when this capability is needed.
Review architecture and API design for the vfs-s3 project. Use when the user mentions @architect, asks to review an issue's design, discuss module boundaries, API shape, or architectural decisions for vfs-s3. Also trigger when the user wants to create an ADR (Architecture Decision Record) or evaluate a technical approach for the project. Intended for dispatch from Codex automation or Claude routines; GitHub trigger phrase: @vfs-s3-bot please prepare design doc Use when this capability is needed.
基于 SOC 职业分类
正在显示 SKILL.md
| name | neat-freak |
| description | > Use when this capability is needed. |
跨平台 Agent Skill：Claude Code · OpenAI Codex · OpenCode · OpenClaw 通用。
使用本技能时，你是知识库编辑，不是记录员。记录员只会追加；编辑要审查全局、合并重复、修正过期、删除废弃。目标是让项目知识体系保持干净、准确、对新人友好，像有洁癖一样。
在 AI 协作开发里，代码可以重写，但文档和记忆是跨会话、跨 agent 的桥梁。记忆过期会让下一个 agent 基于错误前提行动；docs/ 混乱会让同事、下游项目或未来接手的 AI 浪费时间。
这个技能的价值是：让知识体系的每一层都跟上代码变化。
先理解受众差异，否则很容易只改 CLAUDE.md / AGENTS.md，却漏掉真正给人类和下游系统看的文档。
| 位置 | 受众 | 职责 | 不同步的代价 |
|---|---|---|---|
| Agent 记忆系统（若平台支持） | Agent 自己跨会话复用 | 个人偏好、非显而易见的项目事实、跨项目 reference | 下次会话忘记历史决策 |
项目根 CLAUDE.md / AGENTS.md | 当前项目里的 AI | 项目约定、结构、红线、环境变量、路由清单 | 下次 AI 在项目里走弯路 |
项目 docs/ + README.md | 人类同事、下游开发者、未来接手的 AI | 接入指南、架构说明、运维手册、交接说明、API 参考 | 他人或系统无法正确接入、运维或扩展 |
三层受众不同，职责不重叠。CLAUDE.md 写“新增了 device flow 五个路由”不等于 docs/integration-guide.md 说明“下游怎样接入这套 flow”。前者提醒 agent，后者教别人。两份都要对齐。
Agent 记忆系统路径因平台而异。速查见 references/agent-paths.md。如果当前 agent 没有独立记忆系统，跳过记忆层，把精力放在 docs/ 和项目根 markdown。
先做 ls，再做判断。不能跳过枚举。
ls ~/.claude/projects/<...>/memory/，读取 MEMORY.md 及其引用的 .mdls <project-root>/，确认根目录结构ls <project-root>/docs/ 2>/dev/null，枚举所有 docs；没有也要确认find <project-root> -maxdepth 2 -name "*.md" -not -path "*/node_modules/*" -not -path "*/.git/*"，兜底抓散落 markdownREADME.md、CLAUDE.md / AGENTS.md、每一个 docs/*.md~/.claude/CLAUDE.md、~/.codex/AGENTS.md内部维护一张文件清单，对每个文件标记“已评估 / 要改 / 不用改”。不用把清单完整展示给用户，但不能漏文件。
不要只问“这次新增了什么事实”，要问“这个事实会影响哪些文档层级”。
常见映射：
完整映射见 references/sync-matrix.md。不确定时先查表。
重点检查这次对话是否跨项目。如果改了项目 A，而项目 B 通过 SDK、API、子域名、环境变量或共享协议依赖它，项目 B 的 docs 也要改。
必须真的修改文件：编辑现有 markdown，创建缺失文档，清理废弃文件。只描述“应该怎么改”不算完成。
推荐顺序：
docs/ 和 README.md，因为它们面向外部读者。CLAUDE.md / AGENTS.md 等项目内 agent 指南。编辑原则：
2026-04-29，不写“今天”“最近”。docs/ 的读者是第一次接触项目的人，默认对方只有 5 分钟。全局配置要极度克制。只有用户明确表达跨项目核心原则时，才更新 ~/.claude/CLAUDE.md、~/.codex/AGENTS.md 等全局文件。项目细节不要进全局。
新增能力时，docs 通常要补四处：
API 速查表、环境变量表、术语表属于高频查询结构化信息，必须保持“所见即最新”。
修改完成后逐项过检查清单：
CLAUDE.md / AGENTS.md 提到的路径、命令、工具、环境变量在代码中真实存在README.md 的安装和运行步骤与代码一致grep -E "今天|昨天|刚刚|最近|上周|today|yesterday|recently" 应该清零，除非是在解释触发词或示例哪条不能勾，就回去补。不要用“差不多”跳过。
所有文件改完之后，用简洁摘要收尾：
## 同步完成
### 记忆变更
- 更新：xxx（原因）
- 新增：xxx
- 删除：xxx（原因）
### 文档变更
- <项目 A>/CLAUDE.md — xxx
- <项目 A>/docs/integration-guide.md — xxx
- <项目 A>/docs/architecture.md — xxx
- <项目 B>/docs/<integration>.md — xxx
### 未处理
- xxx（原因，例如需要用户确认）
只列实际变更。没改的文件不要写进摘要。
项目没有 README 或 agent 指南：如果项目已经有可运行代码，就创建；如果还在早期探索阶段，可以跳过，但在摘要中说明。
对话没有产生新事实：仍然审查现有记忆和文档是否过期、冲突、使用相对时间。审查本身有价值。
记忆之间存在无法自动判断的矛盾：列入“未处理”，让用户决定。这是唯一需要用户介入的情况。
跨项目改动：每个涉及项目都完整跑一遍“盘点现状”。不要假设上游 docs 改了，下游就不用改。
发现过去同步漏了东西：直接补上。这个技能的职责就是持续维护知识库。
如果当前项目是 CodeBTI 或类似的 Markdown-first skill 仓库（包含 SKILL.md、AGENT.md / AGENTS.md、MANIFEST.md、zh/、shared/、project/、语言包目录、验证脚本等），先读 references/codebti-markdown-workflow.md，再执行上面的通用流程。
这个本地 overlay 的作用是把 neat-freak 的通用清理规则落到本仓库的真实维护面：manifest 漂移、中文镜像、示例/fixture、验证命令、已安装 skill 副本同步。
Source: CHENyiru3/CodeBTI — distributed by TomeVault.