mcpField
C
cco-doctor

cco-doctor

github.com/egorfedorovAgent 工作流125130 次安装1 天前更新
代码仓库

关于 cco-doctor

cco-doctor 是用于检查 Claude 插件状态的诊断技能，可验证配置、文件、数据、模型预算设置和 Node.js 版本，也可选择运行单元测试。

主要功能

  1. 01检查插件清单和 package
  2. 02验证版本一致性
  3. 03检查钩子配置及脚本
  4. 04验证数据、设置和统计文件
  5. 05检查 Node.js 版本
  6. 06可选运行单元测试

适用场景

  1. 01诊断无法正常工作的插件
  2. 02使用前检查插件配置
  3. 03在健康检查中同时运行单元测试

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/egorfedorov/claude-context-optimizer --skill cco-doctor

安装后在 Claude Code 中输入/cco-doctor确认已加载。

详细介绍

CCO Doctor

当用户运行 /cco-doctor 或报告插件“无法正常工作”时，运行快速健康检查。

使用方法

标准运行（快速 — 不到 1 秒）：

node ${CLAUDE_PLUGIN_ROOT}/src/doctor.js

运行测试套件（较慢 — 运行所有单元测试）：

node ${CLAUDE_PLUGIN_ROOT}/src/doctor.js --tests

检查内容

  • 插件清单和 package.json 是否存在
  • 版本是否同步（plugin.json 和 package.json）
  • hooks.json 是否为有效 JSON，且包含所有预期事件类型
  • src/ 中是否包含所有钩子脚本
  • 数据目录 ~/.claude-context-optimizer/ 是否可写
  • patterns.json 的大小是否合理
  • 全局统计文件是否可解析
  • 用户配置中的模型和预算是否适用于所选模型
  • Node 版本是否满足 >=18 的要求

结果说明

将 doctor 的输出转换为通俗易懂的语言。如果有任何项目为 fail，请引导用户修复：

  • 版本未同步 → npm run sync-version
  • patterns.json 过大 → /cco-clean
  • 预算 > 模型上下文窗口 → /cco-budget set <smaller> 或选择支持 1M 上下文的模型（例如 opus-5.5）
  • Node 版本过旧 → 升级 Node

如果所有项目均为 pass，请确认“插件运行正常，当前版本 Х.Y.Z”，然后停止。

评论

支持 Markdown