360 Secure SkillHub
360 安全技能中心

cli-tools

面向命令行环境的工具管理技能:出现 command not found 时诊断缺失工具并安装,覆盖 77 个目录化工具条目,支持按项目类型审计环境、批量更新包管理器与 PATH 排查,主要通过 shell 脚本调用系统包管理器或从发布源下载二进制。

dirnbauer
热度 0.00
最近更新 2026-10-18 17:10:47
分类:自动化依赖:代码执行 / 读写文件 / 第三方 API应用场景:工作流 / DevOps / 自动化脚本

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add dirnbauer/webconsulting-skills/cli-tools
Metadata
name
cli-tools
description
Use when ANY command fails with 'command not found', when installing CLI tools (ripgrep, fd, jq, yq, bat, etc.), auditing project environments, or batch-updating tools. Triggers on: command not found, install tool, missing binary, environment audit, update tools, which, apt install, brew install.

CLI Tools Skill

Install, audit, update, and recommend CLI tools across 77 cataloged entries.

Triggers

  • Reactive: command not found errors -- auto-resolve
  • Proactive: "check environment", "install X", "update tools"
  • Advisory: Recommend modern alternatives (grep->rg, find->fd, JSON->jq)

Preferred Modern Tools

Recommend over legacy equivalents. See references/preferred-tools.md for examples.

Legacy Modern Legacy Modern
grep -r rg diff difft
find fd time hyperfine
grep on JSON jq cat bat
sed on YAML yq cloc tokei/scc
awk on CSV qsv grep for sec semgrep
sed on TOML dasel

Workflows

Missing Tool Resolution

  1. Diagnose: which <tool>, command -v <tool>, type -a <tool>
  2. Map binary: Check references/binary_to_tool_map.md (rg->ripgrep, ansible->ansible-core, batcat->bat)
  3. Install: scripts/install_tool.sh <tool> install
  4. Verify: which <tool> + <tool> --version; if still missing: hash -r, check PATH

See references/resolution-workflow.md for full diagnostic steps.

Environment Audit

Run scripts/check_environment.sh audit . and scripts/detect_project_type.sh, then cross-reference with references/project_type_requirements.md for per-type tool lists.

Batch Update

scripts/auto_update.sh (all managers) or scripts/install_tool.sh <tool> update (single).

Troubleshooting

Symptom Fix
Installed but not found hash -r or add dir to PATH
No sudo cargo install, pip install --user, manual binary
Debian bat=batcat, fd=fdfind Symlink to ~/.local/bin/

See references/troubleshooting.md for Docker fallbacks and permission workarounds.

Scripts

Script Purpose
scripts/install_tool.sh Install/update/uninstall/status
scripts/auto_update.sh Batch update package managers
scripts/check_environment.sh Audit environment and PATH
scripts/detect_project_type.sh Detect project type

References

File Purpose
references/binary_to_tool_map.md Binary-to-catalog mapping
references/project_type_requirements.md Tools per project type
references/preferred-tools.md Modern tool usage patterns
references/resolution-workflow.md Diagnostic/install/verify flow
references/troubleshooting.md PATH, permissions, fallbacks

Credits & Attribution

This skill is based on the excellent work by Netresearch DTT GmbH.

Original repository: https://github.com/netresearch/cli-tools-skill

Copyright (c) Netresearch DTT GmbH — Methodology and best practices (MIT / CC-BY-SA-4.0)

Special thanks to Netresearch DTT GmbH for their generous open-source contributions to the TYPO3 community, which helped shape this skill collection. Adapted by webconsulting.at for this skill collection