mcpField
C
cli-tools

cli-tools

github.com/netresearch开发683 次安装6 周前更新
代码仓库

关于 cli-tools

cli-tools 是面向 Agent 的命令行工具管理技能，涵盖安装、审计、更新和推荐。它结合工具目录、诊断脚本与项目类型要求。

主要功能

  1. 01安装、更新、卸载并查询工具状态
  2. 02诊断缺失的命令
  3. 03审计环境与 PATH
  4. 04识别项目类型及所需工具
  5. 05推荐现代命令行替代工具

适用场景

  1. 01处理“找不到命令”错误
  2. 02审计项目所需工具
  3. 03通过包管理器更新工具

安装

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

$npx skills add https://github.com/netresearch/cli-tools-skill --skill cli-tools

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

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
binary_to_tool_map.md
preferred-tools.md
project_type_requirements.md
resolution-workflow.md
troubleshooting.md
scripts/
auto_update.sh
check_environment.sh
detect_project_type.sh
install_composer.sh
install_tool.sh
scripts/installers/
aws_installer.sh
dedicated_script.sh
github_clone.sh
github_release_binary.sh
hashicorp_zip.sh
npm_global.sh
npm_self_update.sh
package_manager.sh
uv_tool.sh
scripts/lib/
capability.sh
catalog.sh
common.sh
dependency.sh
install_strategy.sh
path_check.sh
policy.sh
reconcile.sh
root.sh
scope_detection.sh

详细介绍

CLI 工具技能

安装、审计、更新并推荐目录中收录的 77 个 CLI 工具。

触发条件

  • 响应式：出现 command not found 错误时——自动解决
  • 主动式：“检查环境”、“安装 X”、“更新工具”
  • 建议式：推荐现代替代工具（grep->rg、find->fd、JSON->jq）

首选现代工具

优先推荐现代工具，而非旧版对应工具。示例请参阅 references/preferred-tools.md。

旧版现代工具旧版现代工具
grep -rrgdiffdifft
findfdtimehyperfine
对 JSON 使用 grepjqcatbat
对 YAML 使用 sedyqcloctokei/scc
对 CSV 使用 awkqsv用于安全检查的 grepsemgrep
对 TOML 使用 seddasel

工作流

解决工具缺失问题
  1. 诊断：which <tool>、command -v <tool>、type -a <tool>
  2. 映射二进制文件：检查 references/binary_to_tool_map.md（rg->ripgrep、ansible->ansible-core、batcat->bat）
  3. 安装：scripts/install_tool.sh <tool> install
  4. 验证：which <tool> + <tool> --version；如果仍未找到：运行 hash -r，并检查 PATH

完整诊断步骤请参阅 references/resolution-workflow.md。

环境审计

运行 scripts/check_environment.sh audit . 和 scripts/detect_project_type.sh，然后对照 references/project_type_requirements.md 检查各项目类型对应的工具列表。

批量更新

使用 scripts/auto_update.sh（所有包管理器），或使用 scripts/install_tool.sh <tool> update（单个工具）。

故障排除

问题解决方法
已安装但找不到运行 hash -r，或将目录添加到 PATH
没有 sudo 权限使用 cargo install、pip install --user 或手动安装二进制文件；在 Debian/Ubuntu 上使用 apt-get download + dpkg -x
Debian 上 bat=batcat、fd=fdfind创建指向 ~/.local/bin/ 的符号链接

Docker 回退方案和权限解决方法请参阅 references/troubleshooting.md。

脚本

脚本用途
scripts/install_tool.sh安装/更新/卸载/查看状态
scripts/auto_update.sh批量更新包管理器
scripts/check_environment.sh审计环境和 PATH
scripts/detect_project_type.sh检测项目类型

参考资料

文件用途
references/binary_to_tool_map.md二进制文件到目录工具的映射
references/project_type_requirements.md各项目类型所需工具
references/preferred-tools.md现代工具使用模式
references/resolution-workflow.md诊断/安装/验证流程
references/troubleshooting.mdPATH、权限和回退方案

评论

支持 Markdown