huiyonghkw

Hekouwang Claude Skill Doctor Skill — Development skill for Claude Code

Development community

Agent Skill（SKILL.md）体检器：评 description 触发质量 / 篇幅 / 渐进披露 / 脚本外置 / 可移植性 / 安全（无硬编码密钥），出评分卡 + 修复建议.

How to install Hekouwang Claude Skill Doctor Skill

This entry records only its repository, not the path inside it, so there is no exact command to give. Open huiyonghkw/hekouwang-claude-skill-doctor-skill and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Hekouwang Claude Skill Doctor Skill does

Agent Skill（SKILL.md）体检器：评 description 触发质量 / 篇幅 / 渐进披露 / 脚本外置 / 可移植性 / 安全（无硬编码密钥），出评分卡 + 修复建议。零依赖，claude-md-doctor 的姊妹工具。

Alternatives in Development

Doctor — Environment diagnostics with interactive fixes — providers, auth, RTK, hooks, token optimization 2.8k ★
Claude Doctor — Diagnose your Claude Code sessions 616 ★
Serenity Stock Choke — A股/港股/美股卡脖子选股 Skill，基于 Serenity 供应链瓶颈理论 Claude Code / Codex 通用智能体可用，零依赖 487 ★

README

hekouwang-claude-skill-doctor-skill

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

给 **Agent Skill（SKILL.md）** 做体检的工具。把"Skill 是按需加载的指令包、不是单文件巨石" 这条最佳实践，做成一个能跑在任何 skill 上的检查器：机检定量 + 模型定性，产出评分卡和可落地的修复建议。

30 秒验收

python3 check.py path/to/your-skill    # 体检任意 skill 目录
bash scripts/run-all-doctors.sh .      # 三件套（需已装 md-doctor + env-doctor）

姊妹工具：[`hekouwang-claude-md-doctor-skill`](https://github.com/huiyonghkw/hekouwang-claude-md-doctor-skill)（体检 AGENTS.md / CLAUDE.md）。

核心判据

SKILL.md 是模型"决定要不要加载、加载后照着做"的运行时指令包。 `description` 决定它何时被唤醒；正文越精简越准；厚重细节要能"按需展开" （references/ 用到再读），而不是每次触发就把全部细节灌进上下文。

用法

在 Claude Code 里（推荐）

直接用**自然语言**喊它，Claude 会自动加载本 skill、在底层跑机检、再做定性复核，给评分卡 + 按优先级的修复建议，并问要不要代为重构：

「帮我体检 ~/.claude/skills/xxx 这个 skill」
「我的 SKILL.md 规范吗 / 是不是太长了 / 要不要拆 references」
「audit this skill」「lint SKILL.md」

命令行直接跑（零依赖，仅需 Python 3）

python3 check.py           # 输出彩色报告
python3 check.py  --json   # 机器可读 JSON（CI 可用）

退出码：有 FAIL → 1，否则 0（可用于 CI 卡关）。

Docker（不想装 Python 也能跑）

# 拉官方镜像直接用（打 v* tag 时 GitHub Actions 自动发布到 GHCR）
docker run --rm -v "$PWD:/work" ghcr.io/huiyonghkw/hekouwang-claude-skill-doctor-skill

# 或本地自建
docker build -t claude-skill-doctor .
docker run --rm -v "$PWD:/work" claude-skill-doctor            # 体检挂载的 skill
docker run --rm -v "$PWD:/work" claude-skill-doctor /work --json

接进 CI 卡关（GitHub Actions 示例）

- uses: actions/setup-python@v5
  with: { python-version: "3.x" }
- name: SKILL.md 体检（不合格则拦 PR）
  run: |
    curl -sO https://raw.githubusercontent.com/huiyonghkw/hekouwang-claude-skill-doctor-skill/main/check.py
    python3 check.py path/to/your/skill

本仓库自身的 CI 见 [`.github/workflows/ci.yml`](.github/workflows/ci.yml)（语法 + good/bad 夹具 + JSON 合法性）。

检查项（12 项加权）

权重	项
1.5（核心）	无硬编码密钥 · frontmatter 必填合法 · description 含「何时用」 · SKILL.md ≤500 行 · 渐进披露(拆 references/) · 可移植(无硬编码绝对路径) · 别替模型补它已会的