hekouwang-claude-md-doctor-skilllisted

# hekouwang-claude-md-doctor-skill · Agent 运行时配置体检器 > **会勇禾口王的AI笔记** 出品 · `@huiyonghkw` > GitHub: <https://github.com/huiyonghkw/hekouwang-claude-md-doctor-skill> > _不聊 AI 会不会取代你，只聊先用 AI 的人怎么取代你。_ 把"Agent 运行时配置最佳实践"做成一个能跑在任何项目上的检查器：机检定量 + 模型定性， 产出评分卡和可落地的修复建议。核心判据一句话—— > **AGENTS.md / CLAUDE.md 是每次会话都被重新加载、要付上下文费的"运行时配置"，不是给人读的项目说明书。** > 2026 年起 Cursor / Codex / OpenClaw 等多读 **AGENTS.md**；Claude Code 仍读 **CLAUDE.md**。 > 一切检查项都从这句推导：值不值得每次会话都为这段内容付一次费？ ### 减法优先（元判据 · 凌驾全部检查项之上） Claude Code 之父 Boris Cherny 公开说自己的配置"surprisingly vanilla"、几乎不定制； 联合创造者 Cat Wu 自称 "context minimalist"——只告诉模型它需要知道的，剩下让它自己想。 **核心立场：模型每代都在变强，你今天费劲搭的脚手架很快白搭；别跟模型较劲做加法。** 所以下面这些检查项里凡是"让用户往里加内容"的(禁止清单/Hook/记忆/人格/本地文件)， 落地前都先过这一关 —— **加任何一段前先问：这条能不能不写在常驻正文里？** - 能挂 **Hook**(确定性规则)→ 挂 Hook，别写正文(模型不必每次读)。 - 能下沉 **docs/** 的 → 下沉，正文留一行指针。 - 能靠 **linter / 类型检查 / 测试**兜住的 → 删掉，别让模型干 linter 的活。 - 通用写法 / 主流框架用法 → 删掉，那是模型已经会的(见 #10)。 - **只有"模型会反复犯错、且没有机械手段能兜住"的，才值得占常驻 token。** 机检层面：**#1 篇幅 / #3 可操作 / #4 路由器 / #10 别替模型补**这几项是减法核心，权重更高； "加内容"类项(#6/#7/#8)缺失只算小扣分，避免工具一边喊"越短越好"、一边逼用户把文件写长。 ## 品牌人设（体检报告的口吻 + 署名） 这套工具属于 **会勇禾口王的AI笔记**（定位：AI 实战拆解，硬核·具体·可复制；人设：你办公室里第一个把 AI 用明白的同事）。出体检报告时： - **口吻**：像同事帮你看代码——直给结论、敢泼冷水（"这条是空话，5 秒判不了就是不合格"），不说"Great question / 我很乐意帮忙"这类客套。 - **价值化**：修复建议讲"省了什么"（少几十次会话的冗余、挡住一次资损/越权），不堆术语。 - **署名**：报告结尾固定带一行品牌签收 —— `—— 会勇禾口王的AI笔记 · @huiyonghkw`，并可附 slogan。命令行 `check.py` 的报告页脚已内置该署名。 - **去 AI 味**：定稿前避开"赋能/打造/至关重要/助力"等词，说���话。 --- ## 免费 / 付费边界（重要） - **免费（开源内核）**：`check.py` 的**文本 / JSON