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/verification.md

View on GitHub
# 什么结论要什么证据

## 结论越重,证据越硬

| 你要下的结论 | 最低证据 |
|---|---|
| 文档链接有效 | 项目自己的链接或索引检查通过,或者逐个确认目标存在 |
| 两份规则文件同源 | 软链或导入确实指向同一份,并且平台实际加载到了 |
| 代码实现是 X | 目标分支上现在的代码、schema、配置和相关测试 |
| PR 已完成 | PR 状态是已合并,有合并提交。这推不出已部署 |
| 已部署 | 部署记录或线上的版本标记指向这次提交,服务在运行 |
| 用户已经看到新版本 | 用户实际访问的地址或接口返回了新内容 |
| 可以清场 | 已合并,线上包含这次改动,文档和规则已同步,工作区没有未提交内容,要删的东西里没有别处找不到的独有内容 |
| 已获准清场 | 用户在这次任务里明确让你清理,而且要删的对象在他说的范围内 |
| 整个项目干净 | 适用的每一面都核实过;未核实的、范围外的单独列出 |

对代码的印象、旧记忆、提交说明、加了防缓存参数的网址,都只能当线索,证明不了线上的状态。

## 发布走到了哪一步

一次改动从写完到收尾依次是:

写完并本地验证 → 推送或开 PR → 检查通过 → 合并 → 部署 → 线上验证 → 文档、规则和记忆同步 → 清理分支、工作树和临时产物 → 清理后再查一遍

卡在哪一步,就按那一步汇报,不用「基本完成」盖过去。跳过某一步要有项目规则允许的理由。

项目没有部署环节(本地工具、还没上线的小项目)时,后面几步不适用,如实说不适用,不编造部署状态。

## 内容经过缓存或有多个出口时

用户看到的内容经过 CDN、边缘缓存、搜索索引、后台任务或多个客户端时,分开确认:

- 源站是不是新内容;
- 用户实际访问的地址是不是还在返回旧缓存;
- 页面、接口、通知、RSS 是不是同一个数据出口;
- 版本标记是不是在所有后台进程都切换之后才写的。

加防缓存参数只能用来诊断,不能当成用户已经看到的证据。只验证了其中一个出口,就在结论里写明只验证了哪个。

## 清场之前

1. 确认这次的工作已经合并并上线;
2. 文档、规则和允许维护的记忆已经同步;项目规则要求留收尾记录的,留好;
3. 列出要删的工作树、分支、临时库和中间产物;
4. 检查里面有没有未提交的文件,有没有别处找不到的内容;
5. 核对用户在这次任务里的清理授权。已经明确批准的不再问;
6. 清理授权范围内的对象。还有独有内容的、没获授权的保留下来,写进待决;
7. 清理后重新查一遍工作区,汇报实际删了什么、还剩什么。

目录名、分支多旧、Agent 会话是否已关闭,都不能证明可以删。

## 验证失败时

- 同一个失败出现第二次,停止盲目重试,回头检查假设、环境和命令名。
- 检查要求机器可读的记录时,补上正确的记录再触发一次。能修的格式问题不用人工确认绕过去。
- 失败发生在写入生产之前,明确说「还没有影响生产」。发生在切换之后,先确认现在线上跑的是哪个版本、能退回到哪。
- 没核实的保持「未核实」,不为了让摘要好看而降成一句提醒。
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