external-tools-skilllisted
Install: claude install-skill aiskillstore/marketplace
# 外部工具装备系统
## 概述
外部工具装备系统遵循"**整合 > 创造**"的核心理念,通过深度整合成熟的CLI工具,为AI Runtime提供强大的外部能力扩展。系统支持10+个经过社区验证的工具,无需重复造轮子。
## 核心能力
### 工具生态
- **基础必备**: fzf、eza、bat、ripgrep、zoxide、jq
- **搜索增强**: fd、ripgrep的高性能代码搜索
- **数据处理**: jq的强大JSON处理能力
- **界面优化**: 美化文件列表、语法高亮、智能跳转
### 深度整合
- **自动检测**: 系统自动发现已安装的工具
- **元数据管理**: 标准化的工具描述和参数定义
- **统一接口**: 通过discover-toolkit.py统一调用
## 快速开始
### 安装推荐工具
**macOS**:
```bash
brew install fzf eza zoxide fd bat ripgrep jq
```
**Ubuntu/Debian**:
```bash
sudo apt-get install fzf ripgrep jq bat
```
### 基本使用
```bash
# 进入工具装备目录
cd .ai-runtime/toolkit
# 查看外部工具
python3 discover-toolkit.py list --external
# 检查安装状态
python3 discover-toolkit.py check-external
```
## 推荐工具详解
### 基础必备工具
#### fzf - 模糊查找器
```bash
# 交互式文件选择
find . -name "*.py" | fzf
# 历史命令搜索
history | fzf
```
#### eza - 现代化ls
```bash
# 美化文件列表
eza -la
# 树状结构显示
eza -T
```
#### bat - 语法高亮cat
```bash
# 带语法高亮的代码查看
bat script.py
# 与fzf结合使用
find . -name "*.md" | fzf | xargs bat
```
#### ripgrep - 极速搜索
```bash
# 递归搜索代码
rg "TODO|FIXME"
# 搜索特定文件类型
rg "function" --type py
```
#### zoxide - 智能跳转
```bash
# 跳转到常用目录
z project-name
# 查看权重统计
zoxide query
```
#### jq - JSON处理器
```bash
# 格式化JSON
cat data.json | jq '.'
# 提取字段
cat package.json | jq '.dependencies | keys[]'
```
## 渐进式披露文档
### 工具详解
- **[fzf使用指南](../docs/tools/external/fzf.md)** - 模糊查找器的完整指南
- **[eza使用指南](../docs/tools/external/eza.md)** - 现代化文件列表工具
- **[bat使用指南](../docs/tools/external/bat.md)** - 语法高亮文件查看器
- **[ripgrep使用指南](../docs/tools/ex