skill-review

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Skill Review Skill

Skill审核Skill

Process

流程

Invoke:

/review-skill <skill-name>

or use this skill when detecting outdated patterns

Production evidence: better-auth audit (2025-11-08) - found 6 critical issues including non-existent API imports, removed 665 lines incorrect code, implemented v2.0.0

调用方式：

/review-skill <skill-name>

或在检测到过时模式时使用此Skill

生产环境验证案例：better-auth审核（2025-11-08）——发现6个关键问题，包括不存在的API导入，移除了665行错误代码，升级至v2.0.0版本

9-Phase Audit

9阶段审核流程

Pre-Review: Install skill, check version/date, test discovery
Standards: Validate YAML, keywords, third-person style, directory structure
Official Docs: WebFetch/Context7 verify API patterns, GitHub updates, npm versions, production repos
Code Examples: Verify imports exist, API signatures match, schema consistency, templates work
Cross-File Consistency: Compare SKILL.md vs README.md, bundled resources match files
Dependencies: Run
```
./scripts/check-versions.sh
```
, check breaking changes, verify "Last Verified"
Categorize: Severity (🔴 Critical / 🟡 High / 🟠 Medium / 🟢 Low) with evidence (GitHub/docs/npm)
Fix: Auto-fix unambiguous, ask user for architectural, update all files, bump version
Verify: Test discovery, templates work, no contradictions, commit with changelog

Automated (via

./scripts/review-skill.sh

): YAML syntax, package versions, broken links, TODOs, file org, staleness

Manual (AI): API methods vs docs, GitHub issues, production comparisons, code correctness, schema consistency

预审核：安装Skill，检查版本/日期，测试可发现性
标准合规性：验证YAML格式、关键词、第三人称表述、目录结构
官方文档校验：通过WebFetch/Context7验证API模式、GitHub更新、npm版本、生产环境仓库
代码示例验证：确认导入项存在、API签名匹配、Schema一致性、模板可正常运行
跨文件一致性检查：对比SKILL.md与README.md，确认捆绑资源与实际文件匹配
依赖项检查：运行
```
./scripts/check-versions.sh
```
，检查破坏性变更，验证"最后验证时间"
问题分级：按照严重程度（🔴 关键 / 🟡 高 / 🟠 中 / 🟢 低）分类，并附上证据（GitHub/文档/npm）
修复处理：自动修复明确的问题，针对架构类问题询问用户，更新所有相关文件，升级版本号
验证确认：测试可发现性、模板可用性，确保无矛盾内容，提交变更并更新变更日志

自动化检测（通过

./scripts/review-skill.sh

）：YAML语法、包版本、失效链接、TODO标记、文件组织、陈旧性检查

人工校验（AI执行）：API方法与文档对比、GitHub问题、生产环境对比、代码正确性、Schema一致性

Severity Classification

严重程度分级

🔴 CRITICAL: Non-existent API/imports, invalid config, missing dependencies

🟡 HIGH: Contradictory examples, inconsistent patterns, outdated major versions

🟠 MEDIUM: Stale minors (>90d), missing docs sections, incomplete errors

🟢 LOW: Typos, formatting, missing optional metadata

🔴 关键：不存在的API/导入项、无效配置、缺失依赖

🟡 高：示例内容矛盾、模式不一致、主版本过时

🟠 中：次版本陈旧（超过90天）、缺失文档章节、错误信息不完整

🟢 低：拼写错误、格式问题、缺失可选元数据

Fix Decision

修复决策

Auto-fix: Unambiguous (correct import from docs), clear evidence, no architectural impact

Ask user: Multiple valid approaches, breaking changes, architectural choices

自动修复：问题明确（如根据文档修正导入项）、证据充分、无架构影响的情况

询问用户：存在多种有效解决方案、涉及破坏性变更、架构选择类问题

Version Bumps

版本升级规则

Major (v1→v2): API patterns change
Minor (v1.0→v1.1): New features, backward compatible
Patch (v1.0.0→v1.0.1): Bug fixes only

主版本（v1→v2）：API模式发生变更
次版本（v1.0→v1.1）：新增功能，向后兼容
补丁版本（v1.0.0→v1.0.1）：仅修复Bug

Example: better-auth Audit (2025-11-08)

示例：better-auth审核（2025-11-08）

🔴 CRITICAL #1: Non-existent

d1Adapter

import from

'better-auth/adapters/d1'

Evidence: Official docs show drizzleAdapter, GitHub has no d1Adapter export, 4 production repos use Drizzle/Kysely

Fix: Replaced with

drizzleAdapter

from

'better-auth/adapters/drizzle'

Result: 3 files deleted (obsolete), 3 created (correct patterns), +1,266 lines, v1.0→v2.0, 3.5 hours

🔴 关键问题#1：从

'better-auth/adapters/d1'

导入不存在的

d1Adapter

证据：官方文档显示应为drizzleAdapter，GitHub无d1Adapter导出，4个生产环境仓库使用Drizzle/Kysely

修复：替换为从

'better-auth/adapters/drizzle'

导入

drizzleAdapter

结果：删除3个过时文件，创建3个符合规范的文件，新增1266行代码，版本从v1.0升级至v2.0，耗时3.5小时

Issues Prevented (10)

已预防的问题（10类）

Fake API adapters - Non-existent imports
Stale API methods - Changed signatures
Schema inconsistency - Different table names
Outdated scripts - Deprecated approaches
Version drift - Packages >90 days old
Contradictory examples - Multiple conflicting patterns
Broken links - 404 URLs
YAML errors - Invalid frontmatter
Missing keywords - Poor discoverability
Incomplete bundled resources - Listed files don't exist

虚假API适配器 - 不存在的导入项
陈旧API方法 - 签名已变更
Schema不一致 - 表名称不统一
过时脚本 - 使用已废弃的实现方式
版本漂移 - 包版本超过90天未更新
矛盾示例 - 存在多种冲突的实现模式
失效链接 - 404错误的URL
YAML错误 - 无效的前置元数据
缺失关键词 - 可发现性差
不完整的捆绑资源 - 列出的文件实际不存在

Bundled Resources

捆绑资源

Planning:

~/.claude/skills/../planning/SKILL_REVIEW_PROCESS.md

or repo

planning/SKILL_REVIEW_PROCESS.md

(complete 9-phase guide)

Scripts: Repo root

scripts/review-skill.sh

(automated validation)

Commands: Repo root

commands/review-skill.md

(slash command, symlinked to

~/.claude/commands/

)

References:

references/audit-report-template.md

(output template)

Last Verified: 2026-01-09 | Version: 1.0.1

规划文档：

~/.claude/skills/../planning/SKILL_REVIEW_PROCESS.md

或仓库中的

planning/SKILL_REVIEW_PROCESS.md

（完整的9阶段指南）脚本：仓库根目录下的

scripts/review-skill.sh

（自动化验证脚本）命令：仓库根目录下的

commands/review-skill.md

（斜杠命令，已软链接至

~/.claude/commands/

） 参考模板：

references/audit-report-template.md

（输出模板）

最后验证时间：2026-01-09 | 版本：1.0.1