关于 cli-tools
面向开发工作流的 CLI 工具管理技能,涵盖 77 个目录条目。它提供缺失工具诊断、安装更新、环境审计,并会推荐现代命令行工具替代方案。
主要功能
- 01诊断并处理缺失工具
- 02安装、更新和卸载工具
- 03审计环境与 PATH
- 04按项目类型检查工具需求
- 05推荐现代工具替代方案
适用场景
- 01处理 command not found 错误
- 02检查开发环境所需工具
- 03批量更新已安装工具
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ dirnbauer/ webconsulting-skills --skill cli-tools安装后在 Claude Code 中输入/cli-tools确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/binary_to_tool_map.mdpreferred-tools.mdproject_type_requirements.mdresolution-workflow.mdtroubleshooting.mdscripts/auto_update.shcheck_environment.shdetect_project_type.shinstall_composer.shinstall_tool.shscripts/installers/aws_installer.shdedicated_script.shgithub_clone.shgithub_release_binary.shhashicorp_zip.shnpm_global.shnpm_self_update.shpackage_manager.shuv_tool.shscripts/lib/capability.shcatalog.shcommon.shdependency.shinstall_strategy.shpath_check.shpolicy.shreconcile.shroot.shscope_detection.sh详细介绍
CLI 工具技能
在 77 个已编目的条目中安装、审计、更新和推荐 CLI 工具。
触发条件
- 响应式:出现
command not found错误时——自动解决 - 主动式:「检查环境」「安装 X」「更新工具」
- 建议式:推荐现代替代工具(
grep->rg、find->fd、JSON->jq)
首选现代工具
优先推荐现代工具,而非传统工具。示例见 references/preferred-tools.md。
| 传统工具 | 现代工具 | 传统工具 | 现代工具 |
|---|---|---|---|
grep -r | rg | diff | difft |
find | fd | time | hyperfine |
| 用 grep 处理 JSON | jq | cat | bat |
| 用 sed 处理 YAML | yq | cloc | tokei/scc |
| 用 awk 处理 CSV | qsv | 用 grep 查找安全问题 | semgrep |
| 用 sed 处理 TOML | dasel |
工作流
解决缺少工具的问题
- 诊断:
which <tool>、command -v <tool>、type -a <tool> - 映射二进制文件:查看
references/binary_to_tool_map.md(rg->ripgrep、ansible->ansible-core、batcat->bat) - 安装:
scripts/install_tool.sh <tool> install - 验证:
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 中 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.md | PATH、权限和替代方案 |
致谢与署名
本技能基于 Netresearch DTT GmbH 的出色工作。
原始仓库:https://github.com/netresearch/cli-tools-skill
Copyright (c) Netresearch DTT GmbH — 方法论和最佳实践(MIT / CC-BY-SA-4.0)
特别感谢 Netresearch DTT GmbH 对 TYPO3 社区慷慨提供开源贡献,这些贡献帮助塑造了这一技能合集。 由 webconsulting.at 为此技能合集改编