Repository navigation
Releases: MaxHou-infinity/cli-doctor
Releases · MaxHou-infinity/cli-doctor
Release list
v0.2.0
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
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
安装体验修复
- 移除尚未完成 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
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
首个公开版本:
- 提供 Homebrew、npm、Python/pip、Rust、Bun、uv 与自更新 CLI 的只读版本检查
- 区分工具与依赖包,输出 Markdown / JSON 报告
- 提供自包含 Agent Skill 安装方式(SKILL.md + bin/check.js)
- README 更新产品定位、安装说明与使用场景