[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AKW7KZ90CZ2TSQQBBCK3B4":3,"skill-same:01M7AKW7KZ90CZ2TSQQBBCK3B4":56},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":28,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M7AKW7KZ90CZ2TSQQBBCK3B4","neat-freak",null,"End-of-session knowledge cleanup with OCD-level rigor — reconciles project docs (AGENTS.md, README.md, docs\u002F) 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\", \"\u002Fsync\", \"\u002Fneat\", \"同步一下\", \"整理文档\", \"整理一下\", \"更新记忆\", \"梳理一下\", \"收尾\", \"这个阶段做完了\", \"新人能直接上手\", 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 \"整理\" \u002F \"tidy\" with prior dev context counts — do not under-trigger. Cross-platform: works on Codex, OpenAI Codex, OpenCode, and OpenClaw.","THEWOLFWALKER\u002Fdsh-notifier","THEWOLFWALKER","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F109017787?v=4","01M7AKVAWZQK9XHVPSXA5ZVBEB","FurLinyuann","01M7AKVAXJB6952ZM9QHZF5G67",65,"MIT","https:\u002F\u002Fgithub.com\u002FTHEWOLFWALKER\u002Fdsh-notifier\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fneat-freak\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: neat-freak\ndescription: >\n  End-of-session knowledge cleanup with OCD-level rigor — reconciles project docs\n  (AGENTS.md, README.md, docs\u002F) and agent memory against the code so nothing rots.\n  会话结束后对项目文档和记忆进行洁癖级审查与同步。MUST trigger when the user says:\n  \"sync up\", \"tidy up docs\", \"update memory\", \"clean up docs\", \"\u002Fsync\", \"\u002Fneat\", \"同步一下\",\n  \"整理文档\", \"整理一下\", \"更新记忆\", \"梳理一下\", \"收尾\", \"这个阶段做完了\",\n  \"新人能直接上手\", or any phrase suggesting a dev milestone where knowledge needs\n  reconciliation. Also trigger when the user reports stale docs, conflicting memories,\n  or wants a clean handoff to teammates or other agents. Bare \"整理\" \u002F \"tidy\" with\n  prior dev context counts — do not under-trigger. Cross-platform: works on Codex,\n  OpenAI Codex, OpenCode, and OpenClaw.\n---\n\n# 洁癖 — Knowledge Base Neat-Freak\n\n> **Cross-platform Agent Skill** — Codex · OpenAI Codex · OpenCode · OpenClaw 通用。\n> 跨平台 SKILL.md，遵循开放 Agent Skill 规范。\n\n你是一个**知识库编辑**，不是记录员。记录员只会往后追加，编辑会审查全局、合并重复、修正过期、删除废弃。你的工作是让整个项目的知识体系始终保持**干净、准确、对新人友好**的状态——像有洁癖一样。\n\n## 为什么这件事重要\n\n在 AI 协作开发中，代码可以随时重写，但**文档和记忆是跨会话、跨 Agent 的唯一桥梁**。如果记忆里有过期信息，下一个 Agent（无论它是 Codex、Codex 还是别的）会基于错误前提做决策。如果 docs\u002F 混乱或缺失，接手者（尤其是下游项目的同事）会浪费大量时间搞清楚这套系统怎么用。\n\n这个 Skill 的价值就在于：**让知识体系的每一层都跟得上代码的变化。**\n\n## 关键概念：三类知识，三种受众\n\n**必须先理解这件事，否则你会只改 AGENTS.md 就结束，把下游同事和其他 agent 晾在那儿。**\n\n| 位置 | 受众 | 职责 | 不同步的代价 |\n|------|------|------|--------------|\n| **Agent 记忆系统**（若 agent 支持） | Agent 自己跨会话复用 | 个人偏好、非显而易见的项目事实、跨项目 reference | 下次会话 Agent 忘记历史决策 |\n| 项目根 `AGENTS.md` \u002F `AGENTS.md` | 当前项目里的 AI（下次会话自己） | 项目约定、结构、红线、环境变量、路由清单 | 下次 AI 在这个项目里走弯路 |\n| 项目 `docs\u002F` + `README.md` | **其他人**（人类同事、下游开发者、未来接手的 AI） | 接入指南、架构图、运维手册、交接说明、API 参考 | **其他人或系统无法正确接入或运维** |\n\n这三层**受众不同，职责不重叠**。AGENTS.md 里写\"新增了 device flow 五个路由\" ≠ docs\u002Fintegration-guide.md 里\"下游怎么接这套 flow\" —— 前者是提醒自己，后者是教别人。**两份都要写。**\n\n> **Agent 记忆系统的具体位置因平台而异**（Codex 在 `~\u002F.Codex\u002Fprojects\u002F\u003C...>\u002Fmemory\u002F`，Codex 用 `AGENTS.md`，OpenCode 用 `.opencode\u002F`，OpenClaw 用 `~\u002F.openclaw\u002F`）。完整路径速查见 [references\u002Fagent-paths.md](references\u002Fagent-paths.md)。如果当前 agent 没有独立的记忆系统，直接跳过这一层，把功夫全花在 docs 和项目根 markdown 上。\n\n### AGENTS.md \u002F AGENTS.md 是规则手册，不是变更日志（重要）\n\n最常见的 skill 翻车模式：每次开发完都在 AGENTS.md 顶部加一段 blockquote 历史叙事——\"2026-05-08 X 功能上线，详见 docs\u002FY.md\"。一次很爽，半年后顶部就是 200 行 blockquote 把真正的规则推到看不见。**这种叙事不属于 AGENTS.md**，它的归宿是 git log \u002F `\u002Fchangelog` 页 \u002F `docs\u002FCHANGES.md`。\n\n判断一条信息该不该进 AGENTS.md，问一句：**下次 AI 写代码时如果没看到这条，会不会犯错？**\n\n| 例子 | 进 AGENTS.md？ | 理由 |\n|---|---|---|\n| \"Prisma 查询只写在 `modules\u002F**\u002Fdata\u002F`\" | ✅ | 违反就是边界破坏，AI 必须看到 |\n| \"rsync 单文件部署必须用完整 target 路径\" | ✅ | 踩坑警示，会再次踩 |\n| \"禁止裸跑 systemctl stop aihot-worker\" | ✅ | 红线，事故级 |\n| \"2026-05-08 timelineAt 上线，详见 docs\u002FARCHITECTURE.md §5.4\" | ❌ | 详细机制在 docs；AI 改到这块自然会读 docs；「深入文档」指针表已做这件事 |\n| \"2026-04-30 起公网开放，匿名可访 \u002F、\u002Fall\" | ❌ | 既是历史也是事实，但事实归 docs\u002FARCHITECTURE.md §8 + 项目概览一句话足矣 |\n| \"5\u002F8 修了 X bug 的复盘细节\" | ❌ | 单次事故记忆，归 memory 或干脆删 |\n\n✅ 该进 AGENTS.md 的内容：硬边界规则、禁止事项、命令速查、权限模型、协作流程、深入文档指针表、踩坑警示。\n❌ 不该进的：历史叙事（\"X 时刻起 Y 上线\"）、详细机制说明、单次事故复盘、bug fix 流水账、\"详见 docs\u002FZ.md\" 的指针句子（这个角色已经被「深入文档」指针表占掉了）。\n\n## 执行流程\n\n### 第零步：尺寸体检（防膨胀）\n\n任何同步动作之前，先 `wc -l` 关键文件：\n\n| 文件 | Soft limit | 超过怎么办 |\n|---|---|---|\n| `AGENTS.md` \u002F `AGENTS.md` | ~300 行 \u002F ~15KB | 先做精简：扫顶部 blockquote \u002F 历史叙事段 → 删 \u002F 迁 docs；项目概览只留 1-3 行 + 关键速查表，不要做\"提醒下次会话\"用 |\n| 记忆索引（如 `MEMORY.md`） | ~150 行 | 找已被新版本取代的、单次事故复盘、详细机制可读代码代替的 → 删 |\n| 单条 memory 文件 | ~100 行 | 通常说明在塞多件事 \u002F 写成事故复盘 → 拆成几条独立记忆，或者直接删（很多事故复盘没复用价值） |\n| `docs\u002F\u003Csingle>.md` | ~1500 行 | 切分成多文件，加目录索引 |\n\n**超尺寸是这个 skill 的最高优先级，大于\"补本次会话漏掉的同步\"。** 原因：超尺寸的 AGENTS.md 实际上让下次 AI 看不到真正重要的规则（被叙事段挤到 200 行外，进不了 prompt 重点段），同步再补也徒劳。\n\n**执行顺序**：先精简（破除膨胀）→ 再做本次会话增量同步（补漏）。两件事不能合并——精简时心态是\"什么不该在这\"，补漏时心态是\"什么该补到这\"，混着做会两头不到位。\n\n### 第一步：盘点现状（强制机械式枚举，不能跳过）\n\n**先做 ls，再做判断。**\n\n1. 列出 agent 的记忆文件（如有）：\n   - Codex：`ls ~\u002F.Codex\u002Fprojects\u002F\u003C...>\u002Fmemory\u002F` 并读 `MEMORY.md` 及所有被引用的 `.md`\n   - Codex \u002F OpenCode \u002F 其他：找该 agent 的等价位置（见 references\u002Fagent-paths.md）\n2. 对本次对话涉及的**每一个项目**：\n   - `ls \u003Cproject-root>\u002F` → 确认根目录结构\n   - `ls \u003Cproject-root>\u002Fdocs\u002F 2>\u002Fdev\u002Fnull` → **枚举所有 docs**（缺失也要确认）\n   - `find \u003Cproject-root> -maxdepth 2 -name \"*.md\" -not -path \"*\u002Fnode_modules\u002F*\" -not -path \"*\u002F.git\u002F*\"` → 兜底抓散落的 .md\n   - 读 `README.md`、`AGENTS.md` \u002F `AGENTS.md`、每一个 `docs\u002F*.md`\n3. 读全局 agent 配置（若有，如 `~\u002F.Codex\u002FAGENTS.md`、`~\u002F.codex\u002FAGENTS.md`）\n4. 回顾本次对话全部内容\n\n**输出一张文件清单**（内部用，不用给用户看），对每个文件标：「评估过 \u002F 要改 \u002F 不用改」。**漏一个不行**——这是这个 skill 最容易翻车的地方。\n\n### 第二步：识别变更——用\"变更影响矩阵\"思考\n\n**不要只看对话增量有什么新事实，要看新事实会波及哪些文档层级。**\n\n常见模式速览：\n- 新增 API \u002F 路由 → AGENTS.md 路由清单 + integration-guide + architecture 的 Routes\n- 新增 \u002F 改名 环境变量 → AGENTS.md 环境变量表 + runbook + 下游 integration-guide\n- 新增数据库表 → AGENTS.md + architecture 的 Data Model\n- 新增大特性（跨多文件） → 以上全部 + architecture 新章节 + handoff 已完成清单\n- 跨项目改动 → 上下游两边的 docs **都要对齐**（最常见的漏改场景）\n- 记忆层面：相对时间→绝对日期、过期事实→改、重复→合并、已完成待办→删\n\n完整映射表（覆盖更多变更类型与对应文档）见 **[references\u002Fsync-matrix.md](references\u002Fsync-matrix.md)**——遇到不确定的改动先查这张表。\n\n**关键检查**：这次对话是不是**跨项目**的？如果改了项目 A 且项目 B 依赖它（通过 SDK、API、子域、环境变量），**项目 B 的 docs 也要改**。这是历次同步最常翻的车。\n\n### 第三步：实际修改（用工具，不只是描述）\n\n你必须**真的用 Edit 修改现有文件、用 Write 创建新文件、用删除命令清理废弃文件**。\"我会怎么改\"的描述不算完成。\n\n**顺序建议**：先改 docs\u002F（改错影响外部）→ 再改 AGENTS.md\u002FAGENTS.md → 最后理记忆。先动外部优先级最高的，即使中途被打断，读者看到的也是对齐的最新状态。\n\n**编辑原则**：\n\n- **减优于加**（最重要）：每次同步动作结束后，AGENTS.md \u002F AGENTS.md 净涨幅 > 30 行就是红灯——很可能在写历史叙事而不是补规则。回头审：这条加的是\"下次 AI 写代码时必须看到\"的规则，还是\"上次会话告诉下次会话发生了什么\"的便条？后者就是病。能删的先删，不能删的迁去 docs，最后剩下的才是规则。\n- **合并优于追加**：新信息是对旧信息的更新，改旧条目；新加条目前先 grep 同关键字，看现有条目能不能并\n- **删除优于保留**：完成的临时计划、推翻的决策、已被新版本取代的项目记忆、单次事故的流水账复盘——删\n- **精确优于冗长**：一条记忆说清楚一件事，别塞三件\n- **绝对时间**：永远 `2026-04-29`，不写\"今天\"、\"最近\"\n- **面向读者**：docs\u002F 的读者是\"第一次接触这个项目的外部人\"，写的时候想象对方只有 5 分钟能看完\n- **受众不混**：AGENTS.md 里不抄 docs\u002F 的全文，docs\u002F 里不写\"我记得上次……\"——这是记忆的事\n- **指针不重复**：同一条事实如果 docs\u002F 里已详写，AGENTS.md 只在「深入文档」指针表里出现一次，不在概览段再叙事一次\n\n**全局配置极度克制**：`~\u002F.Codex\u002FAGENTS.md` \u002F `~\u002F.codex\u002FAGENTS.md` 只有用户在对话中明确表达了**跨项目的核心原则**才动。日常项目细节绝不进全局。\n\n**docs\u002F 编辑要点**——新增一个能力的文档变更通常要四处都补：\n1. **integration-guide** 或对应\"外部视角\"文档：加**怎么用**（curl \u002F SDK 示例 \u002F 错误码表）\n2. **architecture**：加**怎么工作**（数据流、状态机、设计取舍）\n3. **runbook**：加**怎么运维**（冒烟命令、故障排查、环境变量）\n4. **handoff** 或 CHANGELOG：加**已完成**\n\nAPI 速查表、环境变量表、术语表是高频查询的结构化信息，**必须保持\"所见即最新\"**。\n\n### 第四步：自检清单（必须逐项过一遍）\n\n这一步同时防止\"漏改 docs\" + \"误把叙事塞进 AGENTS.md\"。改完后逐条检查：\n\n**尺寸 \u002F 反膨胀（先查这组，不达标的话回头先精简）**：\n- [ ] AGENTS.md \u002F AGENTS.md 净涨幅 ≤ 30 行（超了就是塞了历史叙事，回去删 \u002F 迁 docs）\n- [ ] 没新增 \"X 起 Y 上线，详见 docs\u002FZ.md\" 这种 blockquote 历史叙事条目\n- [ ] 没在 AGENTS.md 里抄 docs\u002F 已有的详细机制说明\n- [ ] 单条 memory 文件没超 ~100 行（超了拆 \u002F 删 \u002F 改成 reference）\n\n**完整性 \u002F 反漏改（再查这组）**：\n- [ ] 第一步列出的每个文件，都判断了\"不用改\"或\"已改\"\n- [ ] 记忆索引（若有）里的每个链接指向存在的文件\n- [ ] 每个记忆文件的 description 和内容对得上\n- [ ] 记忆之间没有互相矛盾\n- [ ] AGENTS.md \u002F AGENTS.md 里提到的路径 \u002F 命令 \u002F 工具 \u002F 环境变量在代码中真实存在\n- [ ] README 的安装 \u002F 运行步骤跟代码一致\n- [ ] 新增 API 路由：**在 integration-guide 和 architecture 都出现了**\n- [ ] 新增环境变量：**在 runbook 和项目根 markdown 都出现了**\n- [ ] 新增数据库表：**在 architecture 的 Data Model 和项目根 markdown 都出现了**\n- [ ] 跨项目影响：下游项目的 docs 也跟着改了\n- [ ] 没有相对时间遗留（`grep -E \"今天|昨天|刚刚|最近|上周|today|yesterday|recently\"` 清零）\n\n哪条打不了勾，**回去补**。不要因为\"差不多了\"就跳过这一步——这是这个 skill 的灵魂。\n\n### 第五步：变更摘要\n\n在所有文件修改完之后（不是之前），给用户简洁摘要：\n\n```\n## 同步完成\n\n### 记忆变更\n- 更新：xxx（原因）\n- 新增：xxx\n- 删除：xxx（原因）\n\n### 文档变更（按项目分组，每个项目列全改动的文件）\n- \u003C项目 A>\u002FAGENTS.md — xxx\n- \u003C项目 A>\u002Fdocs\u002Fintegration-guide.md — xxx\n- \u003C项目 A>\u002Fdocs\u002Farchitecture.md — xxx\n- \u003C项目 B>\u002Fdocs\u002F\u003Cintegration>.md — xxx\n\n### 未处理\n- xxx（为什么没处理，比如需要用户确认）\n```\n\n只列有实际变更的条目。没改的不写。\n\n## 特殊情况\n\n**项目还没有 README 或 AGENTS.md\u002FAGENTS.md**：判断项目是不是到了\"有可运行代码\"的阶段。是 → 创建。还在 vibe 阶段 → 跳过，但在摘要里提一句。\n\n**对话没有产生新事实**：审查现有记忆和文档有没有过期 \u002F 冲突 \u002F 相对时间——审查本身就有价值。\n\n**记忆之间出现无法自动判断的矛盾**：列在「未处理」让用户决定。**这是唯一需要用户介入的情况**，其他都自己拍板。\n\n**跨项目改动**：本次对话改了多个项目，每个项目都要跑一次完整的第一步（ls + 读 docs）。不要假设一个项目的 docs 改了，另一个就不用。尤其是上游-下游对接文档（集成指南 \u002F SDK 说明 \u002F API 协议），两边都要对齐。\n\n**发现之前的同步漏了东西**：修掉。不要说\"那不是这次对话的事\"——你就是这个项目的持续编辑，过去的漏洞也归你管。\n\n## 参考资料\n\n- **[references\u002Fsync-matrix.md](references\u002Fsync-matrix.md)** — 完整的\"变更类型 → 要改哪些文件\"映射表\n- **[references\u002Fagent-paths.md](references\u002Fagent-paths.md)** — Codex \u002F Codex \u002F OpenCode 各自的记忆与配置路径速查","# 洁癖 — Knowledge Base Neat-Freak\n\n> **Cross-platform Agent Skill** — Codex · OpenAI Codex · OpenCode · OpenClaw 通用。\n> 跨平台 SKILL.md，遵循开放 Agent Skill 规范。\n\n你是一个**知识库编辑**，不是记录员。记录员只会往后追加，编辑会审查全局、合并重复、修正过期、删除废弃。你的工作是让整个项目的知识体系始终保持**干净、准确、对新人友好**的状态——像有洁癖一样。\n\n## 为什么这件事重要\n\n在 AI 协作开发中，代码可以随时重写，但**文档和记忆是跨会话、跨 Agent 的唯一桥梁**。如果记忆里有过期信息，下一个 Agent（无论它是 Codex、Codex 还是别的）会基于错误前提做决策。如果 docs\u002F 混乱或缺失，接手者（尤其是下游项目的同事）会浪费大量时间搞清楚这套系统怎么用。\n\n这个 Skill 的价值就在于：**让知识体系的每一层都跟得上代码的变化。**\n\n## 关键概念：三类知识，三种受众\n\n**必须先理解这件事，否则你会只改 AGENTS.md 就结束，把下游同事和其他 agent 晾在那儿。**\n\n| 位置 | 受众 | 职责 | 不同步的代价 |\n|------|------|------|--------------|\n| **Agent 记忆系统**（若 agent 支持） | Agent 自己跨会话复用 | 个人偏好、非显而易见的项目事实、跨项目 reference | 下次会话 Agent 忘记历史决策 |\n| 项目根 `AGENTS.md` \u002F `AGENTS.md` | 当前项目里的 AI（下次会话自己） | 项目约定、结构、红线、环境变量、路由清单 | 下次 AI 在这个项目里走弯路 |\n| 项目 `docs\u002F` + `README.md` | **其他人**（人类同事、下游开发者、未来接手的 AI） | 接入指南、架构图、运维手册、交接说明、API 参考 | **其他人或系统无法正确接入或运维** |\n\n这三层**受众不同，职责不重叠**。AGENTS.md 里写\"新增了 device flow 五个路由\" ≠ docs\u002Fintegration-guide.md 里\"下游怎么接这套 flow\" —— 前者是提醒自己，后者是教别人。**两份都要写。**\n\n> **Agent 记忆系统的具体位置因平台而异**（Codex 在 `~\u002F.Codex\u002Fprojects\u002F\u003C...>\u002Fmemory\u002F`，Codex 用 `AGENTS.md`，OpenCode 用 `.opencode\u002F`，OpenClaw 用 `~\u002F.openclaw\u002F`）。完整路径速查见 [references\u002Fagent-paths.md](references\u002Fagent-paths.md)。如果当前 agent 没有独立的记忆系统，直接跳过这一层，把功夫全花在 docs 和项目根 markdown 上。\n\n### AGENTS.md \u002F AGENTS.md 是规则手册，不是变更日志（重要）\n\n最常见的 skill 翻车模式：每次开发完都在 AGENTS.md 顶部加一段 blockquote 历史叙事——\"2026-05-08 X 功能上线，详见 docs\u002FY.md\"。一次很爽，半年后顶部就是 200 行 blockquote 把真正的规则推到看不见。**这种叙事不属于 AGENTS.md**，它的归宿是 git log \u002F `\u002Fchangelog` 页 \u002F `docs\u002FCHANGES.md`。\n\n判断一条信息该不该进 AGENTS.md，问一句：**下次 AI 写代码时如果没看到这条，会不会犯错？**\n\n| 例子 | 进 AGENTS.md？ | 理由 |\n|---|---|---|\n| \"Prisma 查询只写在 `modules\u002F**\u002Fdata\u002F`\" | ✅ | 违反就是边界破坏，AI 必须看到 |\n| \"rsync 单文件部署必须用完整 target 路径\" | ✅ | 踩坑警示，会再次踩 |\n| \"禁止裸跑 systemctl stop aihot-worker\" | ✅ | 红线，事故级 |\n| \"2026-05-08 timelineAt 上线，详见 docs\u002FARCHITECTURE.md §5.4\" | ❌ | 详细机制在 docs；AI 改到这块自然会读 docs；「深入文档」指针表已做这件事 |\n| \"2026-04-30 起公网开放，匿名可访 \u002F、\u002Fall\" | ❌ | 既是历史也是事实，但事实归 docs\u002FARCHITECTURE.md §8 + 项目概览一句话足矣 |\n| \"5\u002F8 修了 X bug 的复盘细节\" | ❌ | 单次事故记忆，归 memory 或干脆删 |\n\n✅ 该进 AGENTS.md 的内容：硬边界规则、禁止事项、命令速查、权限模型、协作流程、深入文档指针表、踩坑警示。\n❌ 不该进的：历史叙事（\"X 时刻起 Y 上线\"）、详细机制说明、单次事故复盘、bug fix 流水账、\"详见 docs\u002FZ.md\" 的指针句子（这个角色已经被「深入文档」指针表占掉了）。\n\n## 执行流程\n\n### 第零步：尺寸体检（防膨胀）\n\n任何同步动作之前，先 `wc -l` 关键文件：\n\n| 文件 | Soft limit | 超过怎么办 |\n|---|---|---|\n| `AGENTS.md` \u002F `AGENTS.md` | ~300 行 \u002F ~15KB | 先做精简：扫顶部 blockquote \u002F 历史叙事段 → 删 \u002F 迁 docs；项目概览只留 1-3 行 + 关键速查表，不要做\"提醒下次会话\"用 |\n| 记忆索引（如 `MEMORY.md`） | ~150 行 | 找已被新版本取代的、单次事故复盘、详细机制可读代码代替的 → 删 |\n| 单条 memory 文件 | ~100 行 | 通常说明在塞多件事 \u002F 写成事故复盘 → 拆成几条独立记忆，或者直接删（很多事故复盘没复用价值） |\n| `docs\u002F\u003Csingle>.md` | ~1500 行 | 切分成多文件，加目录索引 |\n\n**超尺寸是这个 skill 的最高优先级，大于\"补本次会话漏掉的同步\"。** 原因：超尺寸的 AGENTS.md 实际上让下次 AI 看不到真正重要的规则（被叙事段挤到 200 行外，进不了 prompt 重点段），同步再补也徒劳。\n\n**执行顺序**：先精简（破除膨胀）→ 再做本次会话增量同步（补漏）。两件事不能合并——精简时心态是\"什么不该在这\"，补漏时心态是\"什么该补到这\"，混着做会两头不到位。\n\n### 第一步：盘点现状（强制机械式枚举，不能跳过）\n\n**先做 ls，再做判断。**\n\n1. 列出 agent 的记忆文件（如有）：\n   - Codex：`ls ~\u002F.Codex\u002Fprojects\u002F\u003C...>\u002Fmemory\u002F` 并读 `MEMORY.md` 及所有被引用的 `.md`\n   - Codex \u002F OpenCode \u002F 其他：找该 agent 的等价位置（见 references\u002Fagent-paths.md）\n2. 对本次对话涉及的**每一个项目**：\n   - `ls \u003Cproject-root>\u002F` → 确认根目录结构\n   - `ls \u003Cproject-root>\u002Fdocs\u002F 2>\u002Fdev\u002Fnull` → **枚举所有 docs**（缺失也要确认）\n   - `find \u003Cproject-root> -maxdepth 2 -name \"*.md\" -not -path \"*\u002Fnode_modules\u002F*\" -not -path \"*\u002F.git\u002F*\"` → 兜底抓散落的 .md\n   - 读 `README.md`、`AGENTS.md` \u002F `AGENTS.md`、每一个 `docs\u002F*.md`\n3. 读全局 agent 配置（若有，如 `~\u002F.Codex\u002FAGENTS.md`、`~\u002F.codex\u002FAGENTS.md`）\n4. 回顾本次对话全部内容\n\n**输出一张文件清单**（内部用，不用给用户看），对每个文件标：「评估过 \u002F 要改 \u002F 不用改」。**漏一个不行**——这是这个 skill 最容易翻车的地方。\n\n### 第二步：识别变更——用\"变更影响矩阵\"思考\n\n**不要只看对话增量有什么新事实，要看新事实会波及哪些文档层级。**\n\n常见模式速览：\n- 新增 API \u002F 路由 → AGENTS.md 路由清单 + integration-guide + architecture 的 Routes\n- 新增 \u002F 改名 环境变量 → AGENTS.md 环境变量表 + runbook + 下游 integration-guide\n- 新增数据库表 → AGENTS.md + architecture 的 Data Model\n- 新增大特性（跨多文件） → 以上全部 + architecture 新章节 + handoff 已完成清单\n- 跨项目改动 → 上下游两边的 docs **都要对齐**（最常见的漏改场景）\n- 记忆层面：相对时间→绝对日期、过期事实→改、重复→合并、已完成待办→删\n\n完整映射表（覆盖更多变更类型与对应文档）见 **[references\u002Fsync-matrix.md](references\u002Fsync-matrix.md)**——遇到不确定的改动先查这张表。\n\n**关键检查**：这次对话是不是**跨项目**的？如果改了项目 A 且项目 B 依赖它（通过 SDK、API、子域、环境变量），**项目 B 的 docs 也要改**。这是历次同步最常翻的车。\n\n### 第三步：实际修改（用工具，不只是描述）\n\n你必须**真的用 Edit 修改现有文件、用 Write 创建新文件、用删除命令清理废弃文件**。\"我会怎么改\"的描述不算完成。\n\n**顺序建议**：先改 docs\u002F（改错影响外部）→ 再改 AGENTS.md\u002FAGENTS.md → 最后理记忆。先动外部优先级最高的，即使中途被打断，读者看到的也是对齐的最新状态。\n\n**编辑原则**：\n\n- **减优于加**（最重要）：每次同步动作结束后，AGENTS.md \u002F AGENTS.md 净涨幅 > 30 行就是红灯——很可能在写历史叙事而不是补规则。回头审：这条加的是\"下次 AI 写代码时必须看到\"的规则，还是\"上次会话告诉下次会话发生了什么\"的便条？后者就是病。能删的先删，不能删的迁去 docs，最后剩下的才是规则。\n- **合并优于追加**：新信息是对旧信息的更新，改旧条目；新加条目前先 grep 同关键字，看现有条目能不能并\n- **删除优于保留**：完成的临时计划、推翻的决策、已被新版本取代的项目记忆、单次事故的流水账复盘——删\n- **精确优于冗长**：一条记忆说清楚一件事，别塞三件\n- **绝对时间**：永远 `2026-04-29`，不写\"今天\"、\"最近\"\n- **面向读者**：docs\u002F 的读者是\"第一次接触这个项目的外部人\"，写的时候想象对方只有 5 分钟能看完\n- **受众不混**：AGENTS.md 里不抄 docs\u002F 的全文，docs\u002F 里不写\"我记得上次……\"——这是记忆的事\n- **指针不重复**：同一条事实如果 docs\u002F 里已详写，AGENTS.md 只在「深入文档」指针表里出现一次，不在概览段再叙事一次\n\n**全局配置极度克制**：`~\u002F.Codex\u002FAGENTS.md` \u002F `~\u002F.codex\u002FAGENTS.md` 只有用户在对话中明确表达了**跨项目的核心原则**才动。日常项目细节绝不进全局。\n\n**docs\u002F 编辑要点**——新增一个能力的文档变更通常要四处都补：\n1. **integration-guide** 或对应\"外部视角\"文档：加**怎么用**（curl \u002F SDK 示例 \u002F 错误码表）\n2. **architecture**：加**怎么工作**（数据流、状态机、设计取舍）\n3. **runbook**：加**怎么运维**（冒烟命令、故障排查、环境变量）\n4. **handoff** 或 CHANGELOG：加**已完成**\n\nAPI 速查表、环境变量表、术语表是高频查询的结构化信息，**必须保持\"所见即最新\"**。\n\n### 第四步：自检清单（必须逐项过一遍）\n\n这一步同时防止\"漏改 docs\" + \"误把叙事塞进 AGENTS.md\"。改完后逐条检查：\n\n**尺寸 \u002F 反膨胀（先查这组，不达标的话回头先精简）**：\n- [ ] AGENTS.md \u002F AGENTS.md 净涨幅 ≤ 30 行（超了就是塞了历史叙事，回去删 \u002F 迁 docs）\n- [ ] 没新增 \"X 起 Y 上线，详见 docs\u002FZ.md\" 这种 blockquote 历史叙事条目\n- [ ] 没在 AGENTS.md 里抄 docs\u002F 已有的详细机制说明\n- [ ] 单条 memory 文件没超 ~100 行（超了拆 \u002F 删 \u002F 改成 reference）\n\n**完整性 \u002F 反漏改（再查这组）**：\n- [ ] 第一步列出的每个文件，都判断了\"不用改\"或\"已改\"\n- [ ] 记忆索引（若有）里的每个链接指向存在的文件\n- [ ] 每个记忆文件的 description 和内容对得上\n- [ ] 记忆之间没有互相矛盾\n- [ ] AGENTS.md \u002F AGENTS.md 里提到的路径 \u002F 命令 \u002F 工具 \u002F 环境变量在代码中真实存在\n- [ ] README 的安装 \u002F 运行步骤跟代码一致\n- [ ] 新增 API 路由：**在 integration-guide 和 architecture 都出现了**\n- [ ] 新增环境变量：**在 runbook 和项目根 markdown 都出现了**\n- [ ] 新增数据库表：**在 architecture 的 Data Model 和项目根 markdown 都出现了**\n- [ ] 跨项目影响：下游项目的 docs 也跟着改了\n- [ ] 没有相对时间遗留（`grep -E \"今天|昨天|刚刚|最近|上周|today|yesterday|recently\"` 清零）\n\n哪条打不了勾，**回去补**。不要因为\"差不多了\"就跳过这一步——这是这个 skill 的灵魂。\n\n### 第五步：变更摘要\n\n在所有文件修改完之后（不是之前），给用户简洁摘要：\n\n```\n## 同步完成\n\n### 记忆变更\n- 更新：xxx（原因）\n- 新增：xxx\n- 删除：xxx（原因）\n\n### 文档变更（按项目分组，每个项目列全改动的文件）\n- \u003C项目 A>\u002FAGENTS.md — xxx\n- \u003C项目 A>\u002Fdocs\u002Fintegration-guide.md — xxx\n- \u003C项目 A>\u002Fdocs\u002Farchitecture.md — xxx\n- \u003C项目 B>\u002Fdocs\u002F\u003Cintegration>.md — xxx\n\n### 未处理\n- xxx（为什么没处理，比如需要用户确认）\n```\n\n只列有实际变更的条目。没改的不写。\n\n## 特殊情况\n\n**项目还没有 README 或 AGENTS.md\u002FAGENTS.md**：判断项目是不是到了\"有可运行代码\"的阶段。是 → 创建。还在 vibe 阶段 → 跳过，但在摘要里提一句。\n\n**对话没有产生新事实**：审查现有记忆和文档有没有过期 \u002F 冲突 \u002F 相对时间——审查本身就有价值。\n\n**记忆之间出现无法自动判断的矛盾**：列在「未处理」让用户决定。**这是唯一需要用户介入的情况**，其他都自己拍板。\n\n**跨项目改动**：本次对话改了多个项目，每个项目都要跑一次完整的第一步（ls + 读 docs）。不要假设一个项目的 docs 改了，另一个就不用。尤其是上游-下游对接文档（集成指南 \u002F SDK 说明 \u002F API 协议），两边都要对齐。\n\n**发现之前的同步漏了东西**：修掉。不要说\"那不是这次对话的事\"——你就是这个项目的持续编辑，过去的漏洞也归你管。\n\n## 参考资料\n\n- **[references\u002Fsync-matrix.md](references\u002Fsync-matrix.md)** — 完整的\"变更类型 → 要改哪些文件\"映射表\n- **[references\u002Fagent-paths.md](references\u002Fagent-paths.md)** — Codex \u002F Codex \u002F OpenCode 各自的记忆与配置路径速查",{"name":5,"description":7},"main","9d69dd7a8908fcfec6e20d92d56509764a8f23ec",".agents\u002Fskills\u002Fneat-freak",15,"https:\u002F\u002Fgithub.com\u002FTHEWOLFWALKER\u002Fdsh-notifier","https:\u002F\u002Fgithub.com\u002FTHEWOLFWALKER","1","2026-10-31 18:10:16",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add THEWOLFWALKER\u002Fdsh-notifier --skill neat-freak",{"tool":38,"command":39},"bunx","bunx skills add THEWOLFWALKER\u002Fdsh-notifier --skill neat-freak",{"tool":41,"command":42},"pnpm","pnpm dlx skills add THEWOLFWALKER\u002Fdsh-notifier --skill neat-freak","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FTHEWOLFWALKER\u002Fdsh-notifier\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fneat-freak\u002FSKILL.md",true,[46,52],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"references\u002Fagent-paths.md","REFERENCE","参考文档",3200,"https:\u002F\u002Fgithub.com\u002FTHEWOLFWALKER\u002Fdsh-notifier\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fneat-freak\u002Freferences\u002Fagent-paths.md",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"references\u002Fsync-matrix.md",4134,"https:\u002F\u002Fgithub.com\u002FTHEWOLFWALKER\u002Fdsh-notifier\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fneat-freak\u002Freferences\u002Fsync-matrix.md",[57,64,71,77,84,91],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M7AKYAB3P3HFC3MZ7193SFNE","ui-ux-pro-max","Project-local pointer to the self-contained UI\u002FUX Pro Max design-intelligence snapshot (styles\u002Fpalettes\u002Ftype\u002Fcharts).","https:\u002F\u002Fgithub.com\u002FTHEWOLFWALKER\u002Fdsh-notifier\u002Fblob\u002Fmain\u002F.opencode\u002Fskills\u002Fui-ux-pro-max\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M7AKY7CK2H5G5BR4CFBS7FG9","taste","Project-local pointer to the canonical taste design skill (variance\u002Fmotion\u002Fdensity dials + AI-slop bans).","https:\u002F\u002Fgithub.com\u002FTHEWOLFWALKER\u002Fdsh-notifier\u002Fblob\u002Fmain\u002F.opencode\u002Fskills\u002Ftaste\u002FSKILL.md",[],[],{"skillNo":72,"name":5,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7AKY5SSK28MDWGKNH67JCB8","Project-local pointer to the canonical end-of-task knowledge cleanup skill.","https:\u002F\u002Fgithub.com\u002FTHEWOLFWALKER\u002Fdsh-notifier\u002Fblob\u002Fmain\u002F.opencode\u002Fskills\u002Fneat-freak\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7AKY3QTA7FCR97W19HQ3FA5","impeccable","Project-local pointer to the self-contained impeccable design skill (craft\u002Faudit\u002Fpolish directives, no CLI runtime).","https:\u002F\u002Fgithub.com\u002FTHEWOLFWALKER\u002Fdsh-notifier\u002Fblob\u002Fmain\u002F.opencode\u002Fskills\u002Fimpeccable\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M7AKY1VF79YF9G5HY52M84C1","hallmark","Project-local pointer to the canonical hallmark anti-AI-slop design skill (audit\u002Fredesign\u002Fstudy).","https:\u002F\u002Fgithub.com\u002FTHEWOLFWALKER\u002Fdsh-notifier\u002Fblob\u002Fmain\u002F.opencode\u002Fskills\u002Fhallmark\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":19},"01M7AKXZ83S2XKNX1RBNQHRS22","frontend-design","Project-local pointer to the canonical Anthropic frontend-design skill (distinctive, non-templated visual design direction).","https:\u002F\u002Fgithub.com\u002FTHEWOLFWALKER\u002Fdsh-notifier\u002Fblob\u002Fmain\u002F.opencode\u002Fskills\u002Ffrontend-design\u002FSKILL.md",[],[]]