1实现原理 · 为什么它能做到

自动评审核心是可执行脚本 review_skill.py：对目标技能目录做静态检查（frontmatter 质量、目录结构、SKILL.md <500 行、硬编码路径/密钥 regex、脚本卫生、subagent_type 合法性、指令风格启发式），并把 YAML/schema/内部路径校验委托给同套件 skill-creator 的 canonical validator。

daymade-skill/skill-reviewer/SKILL.md

The reviewer delegates YAML, schema, and internal-path validation to the canonical `skill-creator` validator bundled in the same suite. It then checks frontmatter quality, directory structure, SKILL.md size, hardcoded paths and secrets, script hygiene, `subagent_type` validity, and instruction-style heuristics.

脚本定位 sibling validator 的方式是相对路径解析（Path(__file__).resolve().parents[2] / 'skill-creator' / 'scripts' / 'quick_validate.py'）——强依赖同套件布局（daymade-skill/skill-creator 必须同在）。

静态规则实现：PATH_PATTERNS（/Users//home//C:\Users\ 绝对路径正则）与 SECRET_PATTERNS（api_key/token/password 赋值、sk-、ghp_ 前缀）把『硬编码路径与密钥』变成可机检问题；脚本卫生用 ast 解析检查裸 except，并对 requests/httpx 导入提示登记依赖。

daymade-skill/skill-reviewer/scripts/review_skill.py

SECRET_PATTERNS = [ re.compile( r"\b(?:api[_-]?key|secret[_-]?key|password|token)\b" r"\s*[:=]\s*['\"](?P<value>[^'\"]{8,})['\"]", re.IGNORECASE, ), re.compile(r"(?P<value>sk-[A-Za-z0-9]{20,})"), re.compile(r"(?P<value>ghp_[A-Za-z0-9]{36})"), ]

这是『为什么能实现』：把官方 best practices 转成可执行的正则/结构检查，结果按 0/1/2/3 退出码契约交付（0 clean / 1 warnings / 2 errors / 3 operational failure）。

三模式路由：self-review（脚本 + skill-creator security_scan + 人工清单）、external review（克隆仓库到 /tmp → 先读全部文档 → 识别作者意图 → 跑检查清单 → 出改进报告）、auto-PR（gh fork → additive 改进 → 自审 respect check → 提 PR）。

daymade-skill/skill-reviewer/SKILL.md

Auto-PR Workflow: - [ ] Fork repository (gh repo fork) - [ ] Create feature branch - [ ] Apply additive improvements only - [ ] Self-review: respect check passed? - [ ] Create PR with detailed explanation

Mode 3 的 fork/分支/PR 全部由执行模型的宿主 gh 命令完成（skill 无对应脚本）；核心原则是 additive-only（不删文件/不改语言/不重命名，只增不改并解释每处变更）。

评审哲学内建为『Respect Check』清单与 PR 语气纪律：对他人技能的 PR 只做增量、说明『What's NOT Changed』、语气面向可发现性而非指责。

daymade-skill/skill-reviewer/SKILL.md

❌ "Your skill doesn't follow best practices" ✅ "This PR aligns with best practices for better discoverability"

自评清单（Respect Check：No files deleted? / No functionality removed? / Original language preserved? …）在提 PR 前强制过一遍。

能力边界显式声明：marketplace.json 的插件边界/布局校验属于 marketplace-dev skill 的领域，本 skill 不越权自造模板，而是指引调用同仓库的 daymade-claude-code:marketplace-dev。

daymade-skill/skill-reviewer/SKILL.md

skill's domain — don't author it from a template here.

这是 daymade skill 套件内部分工的一部分：skill-creator 造、skill-reviewer 评、marketplace-dev 管插件边界、skill-governance 管目录治理。

2核心能力

01自动化技能评审（uv run --with PyYAML python review_skill.py <path> [--json]）

02委托 skill-creator canonical 校验（quick_validate.py：YAML frontmatter/schema/内部路径）

03退出码契约：0 clean / 1 warnings / 2 review errors / 3 invocation or runtime failure

04三种模式：self-review / external review（克隆评估他人仓库）/ auto-PR（fork+additive 改进+PR）

05安全扩展扫描接入：uv run … skill-creator/scripts/security_scan.py <target> --verbose

06手动评估清单与 PR 模板（references/evaluation_checklist.md、pr_template.md）

3外部依赖

Kind	Dependency / Endpoint
package	PyYAML（经 uv run --with PyYAML 从 PyPI 现场提供）
cli	uv（依赖提供与脚本运行）
cli	gh（仅 Mode 3 auto-PR：fork/分支/PR，用户显式选用时执行）
cli	git（Mode 2/3 克隆外部仓库到 /tmp）
package	skill-creator 同套件脚本（quick_validate.py / security_scan.py，sibling 依赖）

4管控建议与判定依据

建议配套管控措施

面向 Agent

分级或逐次授权，建议在沙箱运行

面向管理者

审批流程、可回滚、全程审计

判定依据（文件路径与关键语句摘要）

scripts/: 执行本地脚本或命令: scripts/review_skill.py（python3 经 uv；对目标技能目录做只读静态检查）
网络端点: 声明外部网络访问: uv 从 PyPI 拉取 PyYAML（首次运行时）
本地工作目录: 文件读写与工件输出: Mode 2/3（用户选用时）：/tmp 下克隆仓库、创建分支、additive 改动后 push

审计说明： 。评审器本体是本地静态分析（读取目标技能树 + 正则/ast 检查，不执行被评脚本，无凭证读取）；黄色来自依赖链与可选网络动作：① uv run --with PyYAML 需从 PyPI 现场拉包（第三方远程包）；② Mode 3 auto-PR 经 gh fork/克隆/推送 GitHub——官方 CLI、目标可预期，但仅在用户显式选用该模式时发生；③ 强依赖同套件 skill-creator 的校验/安全脚本（同仓信任链）。被评第三方技能内容只读不执行。无凭证接触，故不到橙；有远程包依赖与 gh 网络动作，高于蓝，判黄。

5第二遍独立确认

[ok] 委托 skill-creator validator 且不执行被评脚本 — subprocess.run 仅 [sys.executable, validator, skill_path]；validator 路径 = parents[2]/skill-creator/scripts/quick_validate.py；同套件 skill-creator 目录真实存在。
[ok] 密钥/硬编码路径机检规则 — PATH_PATTERNS 三平台绝对路径正则、SECRET_PATTERNS（key/token/password 赋值 + sk- + ghp_）、PLACEHOLDER_SECRET_PATTERNS 均在源码中逐字可查。
[ok] 三模式与 additive-only 原则 — SKILL.md Mode 1/2/3 章节 + 'Core Principle: Additive Only'（NEVER Delete existing files…ALWAYS Add new capabilities）与 Auto-PR Workflow 清单一致。
[ok] 退出码契约 — EXIT_CLEAN/EXIT_WARNINGS/EXIT_FINDINGS/EXIT_OPERATIONAL = 0/1/2/3 常量 + SKILL.md 说明一致。
[ok] 网络/凭证反例搜索 — review_skill.py 无网络代码、无凭证读取、无 shell=True；唯一外部依赖是 uv 提供 PyYAML；gh/git 动作仅在 SKILL.md Mode 2/3 的模型执行清单里（用户显式选用）。
[ok] 功能声明 vs 实际能力夸大检查 — description『Reviews and improves Claude Code skills against official best practices』——review 由脚本+清单兑现，improve 走 additive PR 流程；不声称自动化重写或深度安全渗透（后者显式指向 skill-creator security_scan）。
[ok] 元数据（commit/license/stars） — 本地 HEAD == pin d5c4678cb5d4fd6acc9c922690df035dbd33d247；GitHub API：MIT、stars 1385（2026-09-09 实采）、pushed_at 2026-09-09T12:33:29Z。

6结论

把 best practices 变成可机检 + 可复现的评审器：正则/ast 检查 + 退出码契约，CI 可直接消费。

职责分工清晰：canonical 校验委托 skill-creator，本 skill 专注质量/卫生/风格启发式，不重复造轮子。

additive-only 的协作伦理内建：Respect Check 清单 + 'What's NOT Changed' PR 段，降低对开源作者的文化摩擦。

评审-改进闭环可自动：Mode 3 从 fork 到 PR 有完整 checklist，gh 官方 CLI 全流程。

能力边界诚实：marketplace 校验指引给 marketplace-dev，安全深扫指引给 security_scan，不越权。

适合： 适合 Claude Code 技能作者发布前自检、维护者批量评估技能仓库质量、以及想给开源技能提『尊重原作』的改进 PR 的人；也适合把技能质量检查接入 CI（退出码 0/1/2/3）。与 skill-creator（创作）、marketplace-dev（插件边界）、skill-governance（目录治理）组合成完整技能生命周期。

不适合： 不适合需要深度安全渗透/恶意代码分析的人（静态规则只抓硬编码模式，深扫应另配专用安全工具）；不适合想对他人技能做非增量大改的场景（违背 additive 哲学）；不适合评估非 Claude Code 技能格式（如纯 Codex/OpenClaw 自定义格式）的目标；不适合离线无 PyPI 且未预装 PyYAML 的环境。

Install Agent-Ready

① Verified Mirror 2026-09-09

Option A · Direct DownloadDownload skill-reviewer.tar.gz

sha256: faaf2fe7a6e55ee9…

Option B · Copy Guide for Agent

install.json

agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。

② Upstream GitHub

GitHub Repo ↗

Pinned to commit d5c4678cb5.