SuperAPI AI 工具集

cli-tools

部署与运维

查看项目

更新于 10-16 09:34

技能介绍

用途:该技能面向命令行环境的工具管理,覆盖 77 个已编目条目,用于安装、审计、更新和推荐 CLI 工具。触发场景包括:命令报错“command not found”时自动解析;主动执行“检查环境”“安装 X”“更新工具”等操作;以及给出改用现代替代工具的建议(如 grep 换成 rg、find 换成 fd、处理 JSON 用 jq)。

主要能力:

  1. 缺失工具解析:用 which <tool>、command -v <tool>、type -a <tool> 诊断,并借助 references/binary_to_tool_map.md 做二进制到工具的映射(rg→ripgrep、ansible→ansible-core、batcat→bat)。
  2. 安装:运行 scripts/install_tool.sh <tool> install,安装后以 which <tool> 和 <tool> --version 验证;若仍缺失,执行 hash -r 或检查 PATH。
  3. 环境审计:运行 scripts/check_environment.sh audit . 和 scripts/detect_project_type.sh,再对照 references/project_type_requirements.md 获取按项目类型的工具清单。
  4. 批量更新:scripts/auto_update.sh 处理所有管理器,或用 scripts/install_tool.sh <tool> update 更新单个工具。
  5. 推荐现代工具:例如 rg、fd、difft、hyperfine、jq、bat、yq、qsv、semgrep、dasel,取代 grep、find、diff、time、grep on JSON、cat、sed on YAML、awk on CSV、grep for sec、sed on TOML 等传统用法。

使用方式:按需调用脚本:scripts/install_tool.sh 负责安装/更新/卸载/状态;scripts/auto_update.sh 批量更新包管理器;scripts/check_environment.sh 审计环境与 PATH;scripts/detect_project_type.sh 识别项目类型。参考文件 references/preferred-tools.md、references/resolution-workflow.md、references/troubleshooting.md 提供用法模式、诊断流程与故障排查。

限制与注意:部分环境无 sudo 权限,可改用 cargo install、pip install --user 或手动安装二进制;Debian/Ubuntu 上 apt-get download + dpkg -x 可用。Debian 中 bat 实际命令为 batcat、fd 为 fdfind,可软链到 ~/.local/bin/。安装后仍找不到时,先 hash -r 或检查 PATH。更多 Docker 回退方案与权限变通见 troubleshooting 参考。