check-dev-env - 开发环境依赖检测技能技能概述check-dev-env是一个用于自动检查开发环境中常见依赖项是否已安装的 AI Agent 技能。该技能能够快速验证 Java、Maven、Node.js、NPM、Go、Python、Git 等主流开发工具的安装状态和版本号。 元信息项目说明技能名称check-dev-env适用场景开发环境初始化、CI/CD 前置检查、新员工入职配置运行平台Windows / Linux / macOS依赖要求Python 3.6执行时长 1 秒并发模式✨ 核心能力支持的检测项✅ 语言运行时 → Java, Python, Node.js, Go ✅ 构建工具 → Maven, NPM ✅ 版本控制 → Git技术特性智能版本识别— 自动提取并显示版本号跨平台兼容— 统一处理 Windows/Linux/macOS 编码差异⚡并发执行— 多线程并行检测提升效率UTF-8 输出— 中文环境无乱码零外部依赖— 仅使用 Python 标准库 使用方式作为 Agent 技能调用当用户需要检查开发环境时Agent 可自动触发此技能用户帮我检查一下开发环境是否配置好了 Agent: → 执行 check-dev-env 技能手动执行# 在项目根目录执行python scripts/check_env.py 输出示例全部已安装Java version: 17 Python version: 3.11.4 Maven version: 3.9.6 Node.js version: 20 NPM version: 10.2.3 Go version: 1.21 Git version: 2.34.1部分未安装Java version: 17 Python version: 3.11.4 Maven version: 3.9.6 Node.js version: 20 NPM version: 10.2.3 Go is not installed Git version: 2.34.1️ 实现原理检测流程┌─────────────┐ │ 启动技能 │ └──────┬──────┘ ↓ ┌─────────────────────────────────────┐ │ 并发执行 7 个检测线程 │ │ ├─ check_java() ─→ java --version │ │ ├─ check_python() ─→ python --version│ │ ├─ check_maven() ─→ mvn -v │ │ ├─ check_node() ─→ node -v │ │ ├─ check_npm() ─→ npm -v │ │ ├─ check_go() ─→ go version │ │ └─ check_git() ─→ git --version │ └──────┬──────────────────────────────┘ ↓ ┌─────────────┐ │ 输出结果 │ └─────────────┘关键技术点子进程执行— 使用subprocess.run()执行系统命令正则解析— 针对不同工具的输出生成对应正则表达式并发优化—threading.Thread并行执行所有检测编码适配— 自动处理 Windows GBK 与 Unix UTF-8 差异 文件结构check-dev-env/ ├── SKILL.md # 技能定义文件ClawdHub 格式 ├── README.md # 本文档 └── scripts/ └── check_env.py # 主程序脚本~170 行 扩展指南添加新的检测项只需两步即可扩展支持新的工具检测步骤 1编写检测函数defcheck_docker()-bool:检查 Docker 是否安装.rc,outputrun_command(docker --version 21)ifrc!0:print(Docker is not installed)returnFalseversion_patternrDocker version (\d\.\d\.\d)matchre.search(version_pattern,output)ifmatch:print(fDocker version:{match.group(1)})returnTruereturnFalse步骤 2在main()函数中添加调用functions[check_java,check_python,# ...check_docker,# 新增] 典型应用场景场景描述新项目初始化克隆代码后快速验证环境是否满足要求CI/CD 流水线构建前自动检查必要工具是否可用团队标准化确保团队成员开发环境一致故障排查快速定位缺少依赖类问题容器镜像构建验证基础镜像包含的运行时❓ 常见问题Q: 为什么某些工具检测不到A: 可能原因包括工具未安装或未添加到 PATH命令名称不同如python3vspython解决方法# 确认命令路径whichjava# Linux/macOSwherejava# WindowsQ: 输出顺序为何不固定A: 由于采用多线程并发执行各检测任务的完成顺序可能不同。如需固定顺序可改为串行执行或使用concurrent.futures模块。 许可证MIT License 相关资源Python subprocess 文档Python threading 文档最后更新2026-03-29