Back to Details

cli-tools

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

CLI Tools Skill

CLI 工具技能

Install, audit, update, and recommend CLI tools across 77 cataloged entries.
可对77个已收录的CLI工具进行安装、审计、更新和推荐。

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
    )
  • 被动触发：
    command not found
    错误——自动解决
  • 主动触发：「检查环境」「安装X」「更新工具」
  • 建议触发：推荐现代替代工具（
    grep
    ->
    rg
    、
    find
    ->
    fd
    、JSON处理->
    jq
    ）

Preferred Modern Tools

推荐的现代工具

Recommend over legacy equivalents. See 
references/preferred-tools.md
for examples.
LegacyModernLegacyModern
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
优先推荐替代传统工具。示例详见 
references/preferred-tools.md
。
LegacyModernLegacyModern
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.
  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
。

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.
运行 
scripts/check_environment.sh audit .
和 
scripts/detect_project_type.sh
，然后对照 
references/project_type_requirements.md
查看对应项目类型的工具列表。

Batch Update

批量更新

scripts/auto_update.sh
(all managers) or 
scripts/install_tool.sh <tool> update
(single).
使用 
scripts/auto_update.sh
（更新所有包管理器）或 
scripts/install_tool.sh <tool> update
（更新单个工具）。

Troubleshooting

故障排查

SymptomFix
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.
症状解决方法
已安装但无法找到
hash -r
或将目录添加至PATH
无sudo权限
cargo install
、
pip install --user
、手动安装二进制文件
Debian系统中
bat
=
batcat
、
fd
=
fdfind
创建符号链接至 
~/.local/bin/
Docker回退方案及权限 workaround 详见 
references/troubleshooting.md
。

Scripts

脚本

ScriptPurpose
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
脚本用途
scripts/install_tool.sh
安装/更新/卸载/查看状态
scripts/auto_update.sh
批量更新包管理器
scripts/check_environment.sh
审计环境及PATH
scripts/detect_project_type.sh
检测项目类型

References

参考文档

FilePurpose
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
文件用途
references/binary_to_tool_map.md
二进制文件与工具目录的映射
references/project_type_requirements.md
各项目类型所需工具列表
references/preferred-tools.md
现代工具使用模式
references/resolution-workflow.md
诊断/安装/验证流程
references/troubleshooting.md
PATH配置、权限问题、回退方案