Skip to content

Releases: MaxHou-infinity/cli-doctor

v0.2.0

Choose a tag to compare

@MaxHou-infinity MaxHou-infinity released this 13 Oct 07:20

CLI Doctor v0.2.0 新增 Codex 侧栏诊断页,并统一 Agent Skill、CLI 与插件的版本号。

新增功能

  • 按生态展示工具卡片,点击“一键诊断当前状态”刷新本机诊断结果。
  • 分别展示可用更新与升级建议,核对已安装包声明的直接、间接依赖及版本约束冲突。
  • 提供 Python 依赖约束检查;可选依赖启用状态和大版本兼容性无法确认时要求进一步核验。
  • 支持从 Git marketplace 安装 Codex 侧栏插件,页面和诊断程序随插件分发,无开发者电脑路径依赖。
  • README 提供安装、更新共用的 Codex 提示词,并要求报告实际安装版本和使用方法。

安装与更新

复制 README 中的 Codex 提示词 给自己的 Codex。安装或更新后重启 Codex,从左侧 CLI Doctor 入口打开页面。

本次将此前 Skill/CLI 的 0.1.4 和侧栏插件的 0.1.0 统一为 0.2.0。更新只作用于 CLI Doctor;诊断不会自动升级被检查的工具。提示词提供按需更新,没有后台更新通知。

验证与范围

  • 已用隔离 Codex 配置,从真实 GitHub 来源将插件 0.1.0 升级至 0.2.0,并核对已安装、已启用和版本一致。
  • 安装副本通过 MCP 握手、侧栏入口、页面资源和 CLI 版本检查;Python 依赖测试通过。
  • 当前为 macOS-first,依赖诊断按已安装包声明核对;未扫描其他项目目录、虚拟环境或 lockfile,也不验证运行时 API 兼容性。侧栏显示需要在重启后的用户界面核对。

v0.1.4

Choose a tag to compare

@MaxHou-infinity MaxHou-infinity released this 04 Sep 12:17

WorkBuddy 兼容性修复

  • 为 SKILL.md frontmatter 增加 WorkBuddy 要求的 version 字段。
  • 增加中文展示名 display_name。
  • 增加英文展示名 display_name_en。
  • 增加中文描述 description_zh。
  • 增加英文描述 description_en。
  • package.json 版本同步为 0.1.4。
  • README 增加 WorkBuddy 上传兼容说明。

验证

  • WorkBuddy 所需字段已写入压缩包中的 SKILL.md。
  • skills CLI 仍可正常识别 cli-doctor。
  • CLI 语法检查和运行测试通过。
  • npm 打包检查通过。
  • 桌面压缩包 cli-doctor-v0.1.4.zip 已生成并通过完整性校验。

说明:通用 quick_validate.py 对 WorkBuddy 顶层扩展字段会给出未知字段提示,但 WorkBuddy 上传要求这些字段位于 frontmatter 顶层,因此本版本以 WorkBuddy 兼容性为准。

v0.1.3

Choose a tag to compare

@MaxHou-infinity MaxHou-infinity released this 04 Sep 11:36

安装体验修复

  • 移除尚未完成 skills.sh 索引而显示 resource not found 的失效徽章。
  • README 统一使用标准 skills CLI,不再要求用户手动选择 Claude、Codex 或其他 Agent 的本地目录。
  • 移除会默认写入 ~/.claude/skills 的旧版自包含安装器。
  • 旧 install 子命令现在返回明确的迁移提示,避免静默执行错误流程。
  • 补充 agent-skills、ai-agents、codex 和 claude-code 生态关键词。

推荐安装

npx skills@latest add MaxHou-infinity/cli-doctor

验证

  • Agent Skill 结构校验通过
  • CLI 快速实测通过
  • npm 打包清单通过
  • skills CLI 隔离目录真实安装通过

skills.sh 索引问题已提交至 vercel-labs/skills#2152 。

v0.1.2

Choose a tag to compare

@MaxHou-infinity MaxHou-infinity released this 04 Sep 11:07

v0.1.2

修复

  • 修复 Issue #1:pip CLI 工具与依赖包因包名不规范而错误分类
  • 使用 importlib.metadata 读取标准包名和版本
  • 统一 PEP 503 包名规范化,避免版本后缀、连字符和下划线导致匹配失败
  • 防止同一 pip CLI 同时出现在工具类和依赖包类

Skill 输出契约

  • 固定一级分类:工具类、依赖包类
  • 固定二级分块:Homebrew、npm 全局、Python/pip、Rust/Bun/uv、自更新 CLI
  • 待升级或待核验项必须输出七字段:工具名称、当前版本、最新版本、手动升级命令、作用说明、耦合关系说明、风险说明
  • 默认直接在 Agent 对话中输出 Markdown;HTML 仅用于明确要求的分享或存档场景

安装与触发

  • 推荐使用:npx skills@latest add MaxHou-infinity/cli-doctor
  • 增加 skills.sh 徽章与完整安装说明
  • 增加中文、英文、日文和西班牙文自然语言触发语义
  • 保留显式 -doctor 调用方式
  • 自包含安装器现在同时复制 SKILL.md、bin/check.js 和 package.json

完整文档见 README。

v0.1.0

Choose a tag to compare

@MaxHou-infinity MaxHou-infinity released this 04 Sep 10:00

首个公开版本:

  • 提供 Homebrew、npm、Python/pip、Rust、Bun、uv 与自更新 CLI 的只读版本检查
  • 区分工具与依赖包,输出 Markdown / JSON 报告
  • 提供自包含 Agent Skill 安装方式(SKILL.md + bin/check.js)
  • README 更新产品定位、安装说明与使用场景