Skip to content

KKKKhazix/khazix-skills / neat-freak

neat-freak

Unverified

干完活的知识收尾:把项目文档、CLAUDE.md/AGENTS.md 等规则文件、Agent 记忆和会话留下的临时文件,对齐到代码和线上的真实现状,让下一个会话或接手的人读到的是唯一、正确的现役答案。触发:用户点名 "neat-freak"、"洁癖"、"/neat",或明确的知识收尾意图——开发后同步文档与记忆、CLAUDE.md/记忆过期或冲突、交接前清场、审计规则是否被遵守("把文档和记忆整理一下"、"docs 和代码对不上了")。不触发:纯写代码/重构/调试、整理数据或文稿(JSON、周报、changelog)、没有项目知识语境的裸"整理"。

FileKindSize
SKILL.mdskill md12.3 KB
evals/evals.jsonconfig10.7 KB
evals/fixtures/eval-1-routine-dev-sync/agent-memory/taskflow/memory/MEMORY.mdmarkdown183 B
evals/fixtures/eval-1-routine-dev-sync/agent-memory/taskflow/memory/project_api-design.mdmarkdown243 B
evals/fixtures/eval-1-routine-dev-sync/agent-memory/taskflow/memory/project_deploy.mdmarkdown274 B
evals/fixtures/eval-1-routine-dev-sync/workspace/CLAUDE.mdmarkdown355 B
evals/fixtures/eval-1-routine-dev-sync/workspace/taskflow/AGENTS.mdmarkdown9 B
evals/fixtures/eval-1-routine-dev-sync/workspace/taskflow/CLAUDE.mdmarkdown479 B
evals/fixtures/eval-1-routine-dev-sync/workspace/taskflow/README.mdmarkdown231 B
evals/fixtures/eval-1-routine-dev-sync/workspace/taskflow/docs/architecture.mdmarkdown374 B
evals/fixtures/eval-1-routine-dev-sync/workspace/taskflow/package.jsonmanifest311 B
evals/fixtures/eval-1-routine-dev-sync/workspace/taskflow/src/router.tsscript888 B
evals/fixtures/eval-1-routine-dev-sync/workspace/taskflow/src/server.tsscript474 B
evals/fixtures/eval-10-vibe-project/project/PLAN.mdmarkdown229 B
evals/fixtures/eval-10-vibe-project/project/README.mdmarkdown314 B
evals/fixtures/eval-10-vibe-project/project/TODO-fix-bug.mdmarkdown245 B
evals/fixtures/eval-10-vibe-project/project/data.jsonconfig105 B
evals/fixtures/eval-10-vibe-project/project/index.htmlother873 B
evals/fixtures/eval-10-vibe-project/project/notes/debug-notes.mdmarkdown176 B
evals/fixtures/eval-10-vibe-project/project/package.jsonmanifest167 B
evals/fixtures/eval-10-vibe-project/project/server.jsscript1.1 KB
evals/fixtures/eval-10-vibe-project/project/server_old.jsscript298 B
evals/fixtures/eval-11-unknown-platform/project/.agentx/memory.jsonconfig394 B
evals/fixtures/eval-11-unknown-platform/project/.agentx/session-log.jsonlother177 B
evals/fixtures/eval-11-unknown-platform/project/AGENTS.mdmarkdown352 B
evals/fixtures/eval-11-unknown-platform/project/main.pyscript771 B
evals/fixtures/eval-11-unknown-platform/project/requirements.txtmanifest13 B
evals/fixtures/eval-2-memory-conflict/agent-memory/notesapp/memory/MEMORY.mdmarkdown353 B
evals/fixtures/eval-2-memory-conflict/agent-memory/notesapp/memory/feedback_auth-clerk.mdmarkdown212 B
evals/fixtures/eval-2-memory-conflict/agent-memory/notesapp/memory/feedback_auth-nextauth.mdmarkdown189 B
evals/fixtures/eval-2-memory-conflict/agent-memory/notesapp/memory/feedback_performance.mdmarkdown178 B
evals/fixtures/eval-2-memory-conflict/agent-memory/notesapp/memory/project_db-migration.mdmarkdown256 B
evals/fixtures/eval-2-memory-conflict/workspace/CLAUDE.mdmarkdown289 B
evals/fixtures/eval-2-memory-conflict/workspace/notesapp/AGENTS.mdmarkdown9 B
evals/fixtures/eval-2-memory-conflict/workspace/notesapp/CLAUDE.mdmarkdown343 B
evals/fixtures/eval-2-memory-conflict/workspace/notesapp/README.mdmarkdown74 B
evals/fixtures/eval-2-memory-conflict/workspace/notesapp/prisma/schema.prismaother297 B
evals/fixtures/eval-2-memory-conflict/workspace/notesapp/src/auth.tsscript255 B
evals/fixtures/eval-3-cold-start/workspace/CLAUDE.mdmarkdown490 B
evals/fixtures/eval-3-cold-start/workspace/analytics_dashboard/.envconfig107 B
evals/fixtures/eval-3-cold-start/workspace/analytics_dashboard/.gitignoreother20 B
evals/fixtures/eval-3-cold-start/workspace/analytics_dashboard/package.jsonmanifest333 B
evals/fixtures/eval-3-cold-start/workspace/analytics_dashboard/src/App.jsxother618 B
evals/fixtures/eval-3-cold-start/workspace/analytics_dashboard/src/lib/supabase.jsscript174 B
evals/fixtures/eval-4-cross-project/agent-memory/auth-center/memory/MEMORY.mdmarkdown105 B
evals/fixtures/eval-4-cross-project/agent-memory/auth-center/memory/project_device-flow.mdmarkdown232 B
evals/fixtures/eval-4-cross-project/agent-memory/skills-hub/memory/MEMORY.mdmarkdown46 B
evals/fixtures/eval-4-cross-project/workspace/CLAUDE.mdmarkdown380 B
evals/fixtures/eval-4-cross-project/workspace/auth-center/.env.exampleother101 B
evals/fixtures/eval-4-cross-project/workspace/auth-center/AGENTS.mdmarkdown9 B
evals/fixtures/eval-4-cross-project/workspace/auth-center/CLAUDE.mdmarkdown525 B
evals/fixtures/eval-4-cross-project/workspace/auth-center/docs/architecture.mdmarkdown264 B
evals/fixtures/eval-4-cross-project/workspace/auth-center/docs/integration-guide.mdmarkdown606 B
evals/fixtures/eval-4-cross-project/workspace/auth-center/docs/operator-runbook.mdmarkdown221 B
evals/fixtures/eval-4-cross-project/workspace/auth-center/migrations/004_device_codes.sqlother430 B
evals/fixtures/eval-4-cross-project/workspace/auth-center/src/routes/device.tsscript1.3 KB
evals/fixtures/eval-4-cross-project/workspace/skills-hub/AGENTS.mdmarkdown9 B
evals/fixtures/eval-4-cross-project/workspace/skills-hub/CLAUDE.mdmarkdown376 B
evals/fixtures/eval-4-cross-project/workspace/skills-hub/docs/auth-integration.mdmarkdown340 B
evals/fixtures/eval-4-cross-project/workspace/skills-hub/setup.shexecutablescript831 B
evals/fixtures/eval-4-cross-project/workspace/skills-hub/web/src/DevicesPage.jsxother419 B
evals/fixtures/eval-5-governance/agent-memory/pdf-tools/memory/MEMORY.mdmarkdown173 B
evals/fixtures/eval-5-governance/agent-memory/pdf-tools/memory/feedback_streaming.mdmarkdown197 B
evals/fixtures/eval-5-governance/workspace/CLAUDE.mdmarkdown957 B
evals/fixtures/eval-5-governance/workspace/Link_Shortener/package.jsonmanifest185 B
evals/fixtures/eval-5-governance/workspace/Link_Shortener/src/server.jsscript415 B
evals/fixtures/eval-5-governance/workspace/deploy-notes.mdmarkdown107 B
evals/fixtures/eval-5-governance/workspace/pdf-tools/.envconfig37 B
evals/fixtures/eval-5-governance/workspace/pdf-tools/.gitignoreother21 B
evals/fixtures/eval-5-governance/workspace/pdf-tools/AGENTS.mdmarkdown229 B
evals/fixtures/eval-5-governance/workspace/pdf-tools/CLAUDE.mdmarkdown180 B
evals/fixtures/eval-5-governance/workspace/pdf-tools/src/app.pyscript479 B
evals/fixtures/eval-6-scope-boundary/workspace/CLAUDE.mdmarkdown217 B
evals/fixtures/eval-6-scope-boundary/workspace/Legacy_App/README.mdmarkdown94 B
evals/fixtures/eval-6-scope-boundary/workspace/current-app/AGENTS.mdmarkdown9 B
evals/fixtures/eval-6-scope-boundary/workspace/current-app/CLAUDE.mdmarkdown56 B
evals/fixtures/eval-6-scope-boundary/workspace/current-app/README.mdmarkdown64 B
evals/fixtures/eval-6-scope-boundary/workspace/current-app/package.jsonmanifest79 B
evals/fixtures/eval-6-scope-boundary/workspace/current-app/src/server.tsscript47 B
evals/fixtures/eval-7-release-terminal/project/.cleanup-candidate/UNIQUE.mdmarkdown89 B
evals/fixtures/eval-7-release-terminal/project/CLAUDE.mdmarkdown180 B
evals/fixtures/eval-7-release-terminal/project/release-state.jsonconfig332 B
evals/fixtures/eval-8-generated-memory/codex-memories/MEMORY.mdmarkdown90 B
evals/fixtures/eval-8-generated-memory/codex-memories/extensions/ad_hoc/notes/.gitkeepother1 B
evals/fixtures/eval-8-generated-memory/codex-memories/memory_summary.mdmarkdown63 B
evals/fixtures/eval-8-generated-memory/codex-memories/rollout_summaries/session.jsonlother53 B
evals/fixtures/eval-8-generated-memory/project/README.mdmarkdown92 B
evals/fixtures/eval-8-generated-memory/project/docs/ARCHITECTURE.mdmarkdown76 B
evals/fixtures/eval-8-generated-memory/project/runtime.txtmarkdown19 B
evals/trigger-eval.jsonconfig2.4 KB
evals/validate.pyexecutablescript6.2 KB
references/agent-paths.mdmarkdown7.2 KB
references/governance.mdmarkdown4.7 KB
references/sync-matrix.mdmarkdown5.3 KB
references/verification.mdmarkdown3.4 KB
scripts/audit-inventory.shexecutablescript3.7 KB

references/agent-paths.md

View on GitHub
# 各平台的规则文件、记忆和 Skill 放在哪

平台机制会变,这份速查核对于 2026-11。先看当前环境和本机规则实际是什么样;涉及能不能写、尺寸上限这类事,以当前官方文档或本机工具的输出为准(文末有入口)。

## 通用原则

- 区分三类文件:人工维护的规则、Agent 自动记忆、机器生成的历史/索引。它们不能共用同一套写入规则。
- `MEMORY.md` 只是文件名,不代表跨平台语义相同。尺寸阈值必须绑定平台和文件类型。
- 规则真身可能是 CLAUDE.md、AGENTS.md、override、导入或软链;以当前工作空间声明和实际加载链为准。
- 发现多个平台目录不等于每个平台都在使用。只审当前运行平台和用户明确纳入的安装面。

## Claude Code

| 用途 | 常见路径 / 规则 |
|---|---|
| 用户指令 | `~/.claude/CLAUDE.md` |
| 项目指令 | `./CLAUDE.md`、`./.claude/CLAUDE.md`、`CLAUDE.local.md`;这三个都没有时读 `AGENTS.md`(见下) |
| 路径规则 | `.claude/rules/**/*.md` |
| 用户路径规则 | `~/.claude/rules/**/*.md` |
| 自动记忆 | `~/.claude/projects/<project>/memory/`(`autoMemoryDirectory` 设置可改位置) |
| 自动记忆索引 | 上述目录的 `MEMORY.md` |
| Skills | `~/.claude/skills/<name>/SKILL.md` 或项目 `.claude/skills/`;插件里的 Skill 以 `插件名:skill名` 出现 |

当前官方口径:

- CLAUDE.md 全量加载,但建议目标少于约 200 行;越长越消耗注意力并降低遵守度。这是质量预算,不是硬截断线。
- Claude 自动记忆 `MEMORY.md` 在会话启动时只加载前 200 行或 25KB(先到者);主题文件按需读取。这个硬限制只属于 Claude 自动记忆,不适用于 Codex 生成记忆。
- Claude Code 从 `.claude/skills` 体系和插件发现 Skill,官方文档不含 `~/.agents/skills`;装在通用目录的 Skill 要给 Claude Code 用,通常再建一个指向同一真身的 `~/.claude/skills/<name>` 软链。
- Claude Code 2.1.277 起能直接读 `AGENTS.md`,但默认只在工作目录及其上级都没有 `CLAUDE.md`、`.claude/CLAUDE.md`、`CLAUDE.local.md` 时才读。所以给一个只有 AGENTS.md 的项目新建 CLAUDE.md 或 CLAUDE.local.md,会让 Claude Code 不再读 AGENTS.md。两份都要生效时,在 CLAUDE.md 里写 `@AGENTS.md` 导入、用软链,或把设置里的 Project instructions 改成 `claude-md-and-agents-md`。更早的版本只读 CLAUDE.md。
- `AGENTS.override.md`、`AGENTS.local.md` 和 `.agents/` 下的文件 Claude Code 不读。
- 项目已经有 CLAUDE.md 或 AGENTS.md 之一,就以它为真身。哪份是真身、另一份怎么同源(导入还是软链),按项目自己的声明来,不擅自翻转,也不另建内容平行的第二份。
- `@路径` 导入相对于写它的那个文件解析,最多嵌套四层。

## OpenAI Codex

| 用途 | 常见路径 / 规则 |
|---|---|
| Codex home | `$CODEX_HOME`,默认 `~/.codex` |
| 全局指令 | `$CODEX_HOME/AGENTS.override.md`,不存在时读 `AGENTS.md` |
| 项目指令 | 从项目根到当前目录逐级找 `AGENTS.override.md`、`AGENTS.md`、配置的 fallback |
| 个人 Skills | `~/.agents/skills/<name>/SKILL.md`(Agent Skills 通用目录) |
| 项目 Skills | 从当前目录到仓库根逐级的 `.agents/skills/<name>/` |
| 管理员 / 内置 Skills | `/etc/codex/skills/`;随 Codex 自带的系统 Skill |
| 插件 Skills | `$CODEX_HOME/plugins/cache/<marketplace>/<plugin>/<version>/`,以 `插件名:skill名` 出现 |

旧版本 Codex 用过 `$CODEX_HOME/skills/`,现行文档已不列这个位置。发现它时按遗留副本处理:核对是否和 `~/.agents/skills` 里的同名 Skill 重复,不当作现役真身。

当前官方口径:项目指令链合并后默认最多 32KiB,由 `project_doc_max_bytes` 控制;越靠近当前目录的指令越晚加载。检查 override 和 fallback,不能只找根目录 AGENTS.md。

Codex 记忆默认关闭;开启后存在 `$CODEX_HOME/memories_v2/`(新装默认)或已有的 `$CODEX_HOME/memories/`。某些环境还有 rollout summaries 或 Chronicle 派生索引。这类文件由 Codex 自己生成:

- 先读当前环境给出的记忆说明;没有明确授权时只读。
- 不直接改生成的 `MEMORY.md`、`memory_summary.md`、`raw_memories.md` 或 rollout summary。
- 用户明确要求更新记忆且环境允许时,只走这个 Codex 环境规定的纠正入口,或用官方的 `/memories`、设置和 `memories.*` 配置控制记忆的生成与使用,然后等 Codex 自己重新整合。不给生成的记忆自定尺寸目标、压缩格式或项目级的检查。

发现 `TEAM_GUIDE.md`、`.agents.md` 等文件时,只有它们出现在 Codex fallback 配置中才把它们当指令文件。

## 其他 Agent Skills 平台(GitHub Copilot、Qoder、Kimi Code、iFlow、CodeBuddy、Cursor、Gemini CLI 等)

Agent Skills 是开放标准(2025-12 由 Anthropic 开放),已有约 40 个产品兼容本 skill 的分发格式。Claude Code 和 Codex 之外的平台不逐一维护速查表,用通用探测法:

1. **规则文件**:GitHub Copilot 项目先检查 `.github/copilot-instructions.md` 和 `.github/instructions/`,仍以当前宿主实际加载链为准。在项目根和上级目录找 `AGENTS.md`(跨平台事实标准)、`CLAUDE.md`,以及平台专属形态(如 `.cursor/rules/`、`.cursorrules`、平台设置里的项目指令)。哪份实际被加载,以当前平台文档和诊断入口为准,不猜。
2. **三分法归类**:把发现的每个知识文件归入三类之一——人工维护的规则、Agent 自动记忆、机器生成的历史/索引。归类不明时按机器生成处理(最保守)。
3. **记忆边界**:未知平台的记忆机制找不到官方控制面时默认只读;不把任何其他平台的尺寸阈值或写入规则套过来。
4. **降级用法**:宿主不支持 Agent Skills 时本 skill 仍可用——把 SKILL.md 全文作为规则文件或对话指令交给 Agent,references 内容按需跟进;执行边界不变。

## 共存检查

1. 列出实际存在的平台目录(含通用目录 `~/.agents/skills` 和项目 `.agents/skills`)和 skill realpath。
2. 核对同名 skill 是否软链到同一真身、复制安装、或由更高优先级版本覆盖。
3. 只改权威真身;复制安装需要明确同步机制,不能假设会自动更新。
4. 软链在 Windows 或受限环境可能不可用,允许项目采用导入或生成镜像,只要现场规则明确且有一致性门禁。
5. 验证加载而不是只验证文件存在:使用平台提供的 instruction/skill list、`/memory`、status 或等价诊断入口。

## 官方复核入口

- Agent Skills specification: <https://agentskills.io/specification>
- Agent Skills 兼容产品名录: <https://agentskills.io/clients>
- Claude Code memory and CLAUDE.md: <https://code.claude.com/docs/en/memory>
- Claude Code skills: <https://code.claude.com/docs/en/skills>
- OpenAI Codex AGENTS.md: <https://learn.chatgpt.com/docs/agent-configuration/agents-md>
- OpenAI Codex skills: <https://learn.chatgpt.com/docs/build-skills>
- OpenAI Codex Memories: <https://learn.chatgpt.com/docs/customization/memories>
rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).Stars: 198kUpdated Claude CodeCodexUnverifiedInstall
doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.Stars: 198kUpdated Claude CodeCodexVerifiedInstall