插件文档兼容性检查工具Skill docs-check

---

名称: 文档检查 描述: | 贡献者工具 - 针对最新Claude代码文档验证插件。 捕捉破坏性变更、弃用项，发现新功能。 在发布前或定期运行。不属于分发插件的一部分。 参数提示: “[–quick|–focus=agents|skills|hooks|config]”

插件文档兼容性检查

验证插件的代理、技能、钩子和配置，针对最新的Claude代码文档，以捕捉破坏性变更并发现新功能。

使用方法

/docs-check                    # 完整验证（所有组件）
/docs-check --quick            # 仅结构检查（不获取文档，无令牌消耗）
/docs-check --focus=agents     # 仅验证代理
/docs-check --focus=skills     # 仅验证技能
/docs-check --focus=hooks      # 仅验证钩子
/docs-check --focus=config     # 仅验证plugin.json/marketplace.json

架构（OTP监督模式）

┌─────────────────────────────────────────────────────────────────┐
│  /docs-check (技能入口点)                                      │
│   │                                                             │
│   ├─ 步骤1：bash scripts/fetch-claude-docs.sh (零令牌)        │
│   │          始终获取所有9个文档页面（约420KB）                │
│   │                                                             │
│   └─ 步骤2：委托给协调器（仅从缓存读取）                       │
│       │                                                         │
│       │  docs-validation-orchestrator (opus)                    │
│       │                                                         │
│       │  SCAN → READ CACHE → SPAWN WORKERS → COMPRESS → REPORT │
│       │   │         │              │             │          │   │
│       │   ↓         ↓              ↓             ↓          ↓   │
│       │ inventory  pre-fetched  4 parallel    context    report │
│       │ plugin     docs-cache   subagents     supervisor       │
│       │ components              (sonnet)      (haiku)          │
│       └─────────────────────────────────────────────────────────┘
└─────────────────────────────────────────────────────────────────┘

执行

步骤1：获取文档（自动）

始终先运行。 下载所有文档页面到缓存。跳过24小时内已缓存的页面。零令牌成本 — 纯curl。

# --quick 模式：完全跳过此步骤（仅结构检查）
# 所有其他模式：始终获取
bash scripts/fetch-claude-docs.sh

步骤2：委托给协调器

文档缓存后，委托。协调器仅从缓存读取，如果缓存文件缺失则崩溃。

Task(subagent_type: "docs-validation-orchestrator")

在提示中传递用户的标志（–quick, --focus）。

协调器的作用

1. 库存 — 扫描 plugins/elixir-phoenix/ 查找现有组件
2. 读取缓存文档 — 从 .claude/docs-check/docs-cache/（从不获取）
3. 生成工作进程 — 每个组件类型一个sonnet子代理，并行
4. 压缩 — 上下文监督器（haiku），如果3个或更多工作进程
5. 结构检查 — 快速本地检查，始终运行
6. 报告与操作 — 写入报告，如果发现问题则提供PR

铁律

1. 预先获取所有文档 — 无条件获取，不部分下载
2. 使用 scripts/fetch-claude-docs.sh — 文档获取的单一来源
3. 工作进程在提示中获取文档 — 无运行时获取
4. 工作进程使用sonnet — opus对于比较任务浪费
5. 结构检查始终运行 — 即使文档获取失败
6. 破坏性变更被阻塞 — 突出显示

参考资料

• references/validation-rules.md — 每个组件的验证检查清单
• references/doc-pages.md — 组件到URL的映射