What makes hekouwang-claude-md-doctor-skill notable?

1.1K downloads. Trust evidence available

How should hekouwang-claude-md-doctor-skill be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

hekouwang-claude-md-doctor-skill

会勇禾口王的AI笔记 · Agent 运行时配置体检器。检查项目的 AGENTS.md（跨 Agent 推荐）或 CLAUDE.md（及子目录本地配置）是否符合"把它当运行时配置、不是项目说明书"的最佳实践，给出评分卡 + 按优先级的修复建议，并可代为修复。触发：用户说「检查我的 CLAUDE.md / AGENTS.md / 运行时配置体检 / claude-md-doctor / agents.md 规范吗 / audit CLAUDE.md / lint AGENTS.md / 看看我的 agent 配置合不合规」。任何"评估/审查/优化某个项目 AGENTS.md 或 CLAUDE.md 质量"的请求都应触发。

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.1k

Updated

Oct 11, 2026

Version

1.3.2

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 11, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 11, 2026
Adoption signal: 1.1K downloadsadoption · observed Oct 11, 2026
Latest release: 1.3.2release · observed Aug 12, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17639bexg8w6nymygatvtx99585dbjd:hekouwang-claude-md-doctor-skill

Install using `clawhub skill install s17639bexg8w6nymygatvtx99585dbjd:hekouwang-claude-md-doctor-skill` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/huiyonghkw/hekouwang-claude-md-doctor-skill before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-huiyonghkw-hekouwang-claude-md-doctor-skill/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

149,125 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: hekouwang-claude-md-doctor-skill
slug: hekouwang-claude-md-doctor-skill
displayName: CLAUDE.md / AGENTS.md 体检器
summary: AGENTS.md / CLAUDE.md linter & skill lint companion — Agent runtime config audit (not a project wiki). Dual-file dedup + .agents/skills/ routing.
license: MIT
homepage: https://github.com/huiyonghkw/hekouwang-claude-md-doctor-skill
version: 1.3.2
description: >
  会勇禾口王的AI笔记 · Agent 运行时配置体检器。检查项目的 AGENTS.md（跨 Agent 推荐）
  或 CLAUDE.md（及子目录本地配置）是否符合"把它当运行时配置、不是项目说明书"的最佳实践，
  给出评分卡 + 按优先级的修复建议，并可代为修复。触发：用户说「检查我的 CLAUDE.md /
  AGENTS.md / 运行时配置体检 / claude-md-doctor / agents.md 规范吗 / audit CLAUDE.md /
  lint AGENTS.md / 看看我的 agent 配置合不合规」。
  任何"评估/审查/优化某个项目 AGENTS.md 或 CLAUDE.md 质量"的请求都应触发。
allowed-tools:
  - Bash
  - Read
  - Write
  - Edit
  - Glob
  - Grep
  - AskUserQuestion
---

# 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 报告 + 评分**。任何人本地或 Docker 跑、进 CI，随便用。
- **付费（增值）**：**品牌可视化体检报告卡**（评分弧 + 等级带 + 九项明细的精美分享图）。
  它依赖 `hekouwang-content-factory` 的**私有品牌字体与版式**，不随本仓库分发。

**触发"出图 / 报告卡 / 图表 / 可视化"时怎么办**：
1. 先照常给**免费文本报告**（机检 + 定性复核）。
2. 是否生成图：检查本机有没有 `hekouwang-content-factory`（品牌字体在
   `~/.claude/skills/hekouwang-content-factory/assets/fonts/`）。
   - **有**（作者本人环境）：可按 V2 米白生成报告卡 PNG。
   - **没有**（外部用户）：明确说明可视化报告是**付费增值项**，引导联系 **@huiyonghkw** 获取，
     不要用系统字体凑一张劣化图糊弄。
3. 一句话口径：**跑检查免费，出"好看的报告图"找我。**

---

## 与内置 `/doctor` 命令的分工（名字像，别混用）

Claude Code 内置了一个 `/doctor` 命令，名字也带 "doctor"，但**体检对象和本 skill 完全不同**——
一个查整套工具的运行环境，一个只查一份文档写得好不好。别把两者当同一个东西。

| 维度 | 内置 `/doctor` 命令 | 本 skill（claude-md-doctor） |
|-

README.md

# hekouwang-claude-md-doctor-skill

**简体中文** · [English](README.en.md)

[![CI](https://github.com/huiyonghkw/hekouwang-claude-md-doctor-skill/actions/workflows/ci.yml/badge.svg)](https://github.com/huiyonghkw/hekouwang-claude-md-doctor-skill/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
![Python](https://img.shields.io/badge/python-3.x-blue.svg)
![dependencies](https://img.shields.io/badge/dependencies-zero-brightgreen.svg)
![open source](https://img.shields.io/badge/open%20source-free-success.svg)

> **会勇禾口王的AI笔记** 出品 · `@huiyonghkw`
> _不聊 AI 会不会取代你，只聊先用 AI 的人怎么取代你。_

CLAUDE.md / AGENTS.md 体检器 —— 检查任意项目的运行时配置是否符合"**路由器、不是图书馆**"，
给出评分卡 + 修复建议。

## 30 秒验收

```bash
python3 check.py .                    # 体检当前项目（零依赖）
bash scripts/run-all-doctors.sh .     # 三件套：md + skill + env
```

<p align="center">
  <img src="examples/demo.gif" width="720" alt="hekouwang-claude-md-doctor-skill 体检演示">
  <br><sub>↑ 一句「检查我的 CLAUDE.md」/ <code>python3 check.py</code>，秒出评分 + 修复建议（免费 CLI）</sub>
</p>

一句话判据：**CLAUDE.md 每次会话都被重新加载、要付上下文费。值不值得每次会话都为这段内容付一次费？**

<p align="center">
  <img src="examples/report-card.gif" width="420" alt="CLAUDE.md 体检报告卡（动效示例）">
  <br><sub>↑ 品牌可视化报告卡（<b>付费增值</b>示例）——评分弧随分数填充、等级 D→A 变色。免费版输出文本/JSON 报告。</sub>
</p>

## 为什么需要它

很多人把 CLAUDE.md 写成"项目说明书"：塞进历史、技术决策、营销叙事，动辄上千行。
结果模型在冗长上下文里迷失，还挤掉了真正理解代码的空间。这个工具把 10 条可检查的
最佳实践固化下来，让任何人一键体检自己的项目。

核心立场是 Claude Code 之父 Boris Cherny / Cat Wu 的 **context minimalism —— 别跟模型较劲做加法**：
模型每代都在变强，你今天费劲搭的脚手架很快白搭。所以评分按"减法优先"加权，
"越短越准"类核心项权重更高，"加内容"类项缺了不重罚。

## 10 项检查

1. 篇幅 ≤ 200 行（路由器不是图书馆）
2. 禁止清单（Do NOT introduce）
3. 规则可操作（非"写干净代码"式空话）
4. 路由器不是图书馆（大块下沉 docs/ 留指针）
5. 高危模块有本地 CLAUDE.md（碰钱/认证/迁移）
6. 关键规则有 Hook 强制（不靠模型记忆）
7. 跨会话记忆回路（MEMORY.md）
8. 工作风格块（你是谁 / 你讨厌什么 · 限 3–5 行）
9. 30 秒三问（产品 / 技术栈 / 新代码放哪）
10. 别替模型补它已经会的（无"如何使用 X / 教程"式随模型升级即过时的冗余）

## 用法

### 在 Claude Code 里（推荐）
直接说：「**检查我的 CLAUDE.md**」「**CLAUDE.md 体检**」——会自动跑机检 +
模型定性复核，给出评分和按优先级的修复建议，并可代为修复。

### 命令行直接跑（零依赖，仅需 Python 3）
```bash
python3 check.py [项目目录]          # 默认当前目录，输出彩色报告
python3 check.py [项目目录] --json   # 机器可读 JSON（CI 可用）
```
退出码：有 FAIL → 1，否则 0（可用于 CI 卡关）。

### Docker（不想装 Python 也能跑）
```bash
# 拉官方镜像直接用（打 tag 时 GitHub Actions 自动发布到 GHCR）
docker run --rm -v "$PWD:/work" ghcr.io/huiyonghkw/hekouwang-claude-md-doctor-skill

# 或本地自建
docker build -t claude-md-doctor .
docker run --rm -v "$PWD:/work" claude-md-doctor            # 体检当前项目
docker run --rm -v "$PWD:/work" claude-md-doctor /work --json
```

### 接进 CI 卡关（GitHub Actions 示例）
```yaml
- uses: actions/setup-python@v5
  with: { python-version: "3.x" }
- name: CLAUDE.md 体检（不合格则拦 PR）
  run: |
    curl -sO https://raw.githubusercontent.com/huiyonghkw/hekouwang-claude-md-doctor-skill/main/check.py
    python3 check.py .
```
本仓库自身的 CI 见 [`.github/workflows/ci.yml`](.github/workflows/ci.yml)（语法 + good/bad 夹具 + JSON 合法性）。

## 这不是内置的 `/doctor` 命令

Claude Code 自带一个 `/doctor` 命令，名字也带 "doctor"，但**体检对象和本工具完全不同**——
一个查整套工具的运行环境，一个只查一份文档写得好不好。别搞混。

| 维度

_meta.json

{
  "ownerId": "kn73qd1gcmjr446mwcbdxef70x82vxcw",
  "slug": "hekouwang-claude-md-doctor-skill",
  "version": "1.3.2",
  "publishedAt": 1786534620249
}

references/doctor-suite.md

# hekouwang-doctor-suite · 体检器三件套

> 竞品多是单点；这套把「项目配置 → 技能包 → 本机环境」串成一条验收链。

```
hekouwang-doctor-suite（概念）
├── md-doctor      → AGENTS.md / CLAUDE.md（运行时配置）
├── skill-doctor   → SKILL.md（Agent 技能包）
└── env-doctor     → 磁盘 / 版本管理器 / AI 宿主目录
```

## 一键跑

```bash
bash scripts/run-all-doctors.sh /path/to/your-project
```

（脚本在 `hekouwang-claude-md-doctor-skill`；`skill-doctor` / `env-doctor` 仓内各有一份相同副本。）

## 建议顺序

1. **md-doctor** — 根配置是否「路由器」而非「图书馆」
2. **skill-doctor** — `.agents/skills/` 下各 skill 是否按需加载
3. **env-doctor** — 本机是否留着已换掉的 nvm / 膨胀的 AI 缓存

## 免费 vs 付费

| | 免费（开源） | 付费增值 |
|---|---|---|
| 机检 | `check.py` / `scan.sh` 文本报告 + JSON | 品牌可视化报告卡（评分弧 + 等级带） |
| CI | 退出码卡关 | — |
| 联系 | GitHub Issue / PR | ClawHub **@huiyonghkw** |

CHANGELOG.md

# Changelog

本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。

## [1.3.2] - 2026-08-12

### 变更
- ClawHub 分类：`development`

## [1.3.1] - 2026-08-12

### 新增
- `scripts/run-all-doctors.sh`：hekouwang-doctor-suite 三件套一键体检
- `references/doctor-suite.md`：套件说明与免费/付费对照

### 变更
- `check.py`：无 `HEKOUWANG_CONTENT_FACTORY` 时提示付费报告卡 CTA
- README：30 秒验收 + 三件套互链；summary 补英文 SEO 关键词

## [1.3.0] - 2026-08-12

### 新增
- **`check.py` 支持 AGENTS.md**：根目录优先体检 `AGENTS.md`，其次 `CLAUDE.md` / `CLAUDE.local.md`；
  子目录扫描同时认两份本地配置。
- **#0b 双文件去重**：根目录 `AGENTS.md` + `CLAUDE.md` 同时存在且都不是薄指针 → WARN（双倍上下文费）。
- **#4c Skill 路由**：正文应把细则指针到 `.agents/skills/`（或 `.cursor/skills/`），别堆在常驻正文。
- 报告标题改为 **AGENT CONFIG DOCTOR**；JSON 输出增加 `root_configs` 字段。

### 文档
- `SKILL.md` 触发词补 `AGENTS.md` / `agents.md` / `运行时配置体检`；评分表扩至 12 项。
- 新增测试夹具 `tests/fixtures/good-agents/`、`tests/fixtures/dual/`。

## [1.2.2] - 2026-07-09

### 文档
- **新增「与内置 `/doctor` 命令的分工」小节**：两者名字都带 doctor 但体检对象完全不同——
  内置 `/doctor` 查整套 Claude Code 运行环境（安装/未用扩展/上下文膨胀/权限/版本），
  本 skill 只查一份 CLAUDE.md 的写法质量。给出对比表 + 唯一交集（`/doctor` Check 2/3 碰 CLAUDE.md
  但只从上下文成本看、不评质量）+ 用法建议（先 `/doctor` 发现文档偏大，再用本 skill 深度评 + 重构）。
- **README.md / README.en.md 同步**：两份 README 也各补一节「这不是内置的 `/doctor` 命令」
  （精简对比表 + 唯一交集 + 组合用法），中英一致。

## [1.2.1] - 2026-06-22

自体检（用姊妹工具 skill-doctor 跑）后的两处打磨：

### 优化
- **SKILL.md 声明 `allowed-tools`**：收敛到本 skill 真正需要的工具集，减小越权面。
- **补「本 skill 自检会触发 #10 误报」豁免说明**：正文里的"教程/如何使用/step by step"是
  待检测的黑名单词本身（评分表/盲区/修复清单都要举例），机检会误报教学冗余——
  与 skill-doctor 对齐，注明定性时直接放行，别删那些词（删了体检器就不工作）。

## [1.2.0] - 2026-06-21

对照社区教程 `luongnv89/claude-howto` 的 Memory 最佳实践逐条比对后，补上三个真空白
（只取它的"安全 + 机制正确性"，不取它"把文件写全"的加法倾向）。

### 新增
- **安全红线检查「无硬编码密钥」(#0)**：扫正文里的 `sk-`/`AKIA`/`AIza`/`gh*_`/`xox*`/
  JWT / 私钥块 / `password=`/`secret=` 等指纹，命中即 **FAIL**（权重 1.5、资损级）。
  报告对命中值脱敏（前 4 位 + 长度）。占位/示例值（`<your-pwd>`/`${VAR}`/`example` 等）自动豁免。
  补齐教程头号 Don't "Never store secrets in CLAUDE.md"——此前脚本只防自己读 .env，
  却不查被体检文件本身是否藏密钥。
- **指针死链检查 (#4b)**：`docs/` 文本指针与原生 `@import` 路径都校验目标文件是否存在，
  死链 → WARN（指向不存在的文件比没指针更糟）。

### 变更
- **#4 路由器检查认原生 `@import` 语法**：此前只认纯文本 `docs/...`，用官方 `@path` 导入
  反而不给"下沉指针"加分；现在两种写法都算合格指针。

### 文档 / 测试
- `SKILL.md` 评分表补 #0 与 #4b，加权说明与修复动作清单同步（拔密钥 + 轮换提醒、修死链）。
- good 夹具补 `docs/architecture.md`、`docs/api.md` 桩文件，示范"指针均可解析"。

## [1.1.0] - 2026-06-18

把 Claude Code 之父 Boris Cherny / Cat Wu 的"context minimalism · 别跟模型较劲做加法"
立场接进体检逻辑。

### 新增
- **第 10 项检查「别替模型补它已经会的」**：扫教学型措辞(如何使用 / 使用教程 /
  step by step / how to use)，命中即 WARN——这类通用写法随模型升级自动变强，
  写进常驻正文只是为"很快过时的东西"每次付上下文费。
- **「减法优先」元判据**：写进 `SKILL.md`，凌驾 9 项之上——加任何一段前先问
  "能不能不写在常驻正文里"。

### 变更
- **评分改为按重要度加权**：减法核心项(#1 篇幅 / #3 可操作 / #4 路由器 / #10)权重 1.5，
  加内容项(#6 Hook / #7 记忆 / #8 人格)降到 0.6。修掉旧逻辑"一边喊越短越好、
  一边因缺工作风格块扣分、逼用户把文件写长"的自相矛盾。
- **#8 工作风格块加上限护栏**：限 3–5 行，每行须对应一个"不写就会犯的具体错"，别写性格小作文。

### 文档
- `README` / `README.en` 同步「10 项检查」并写明「减法优先 · 别跟模型较劲做加法」立场。
- `SKILL.md` 顶部署名补 GitHub 仓库地址
  （<https://github.com/huiyonghkw/hekouwang-claude-md-doctor-skill>），方便 skillhub 溯源。

## [1.0.0] - 2026-06-1

Github ReposUpdated 2d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.