Initial commit

skills/toolkit/docs/tools/external/bat.md

@@ -0,0 +1,64 @@
+---
+name: bat
+description: 带语法高亮的cat替代品
+category: essential
+tool_id: EXT-BAT-001
+---
+
+# bat (cat with syntax) ⭐⭐⭐⭐⭐
+
+## 用途
+语法高亮的文件查看
+
+## 安装
+
+### macOS
+```bash
+brew install bat
+```
+
+### Ubuntu/Debian
+```bash
+sudo apt-get install bat
+```
+
+## 配置 (添加到 ~/.bashrc)
+
+```bash
+alias cat='bat -p'
+alias catn='bat'
+```
+
+## 使用
+
+```bash
+# 查看文件（有语法高亮）
+bat app.py
+
+# 分页查看（保留高亮）
+bat -p app.py | less -R
+
+# 查看Git修改
+bat -d app.py
+
+# 查看行号
+bat -n app.py
+```
+
+## 常用选项
+
+- `-p` -- 纯文本模式（无分页）
+- `-n` -- 显示行号
+- `-d` -- 显示Git diff
+- `-l` -- 指定语言
+- `--theme` -- 选择主题
+
+## 与其他工具集成
+
+```bash
+# 与fzf集成
+fd .py | fzf --preview 'bat --color=always {}'
+
+# 查看日志
+bat /var/log/system.log
+```

skills/toolkit/docs/tools/external/eza.md

@@ -0,0 +1,60 @@
+---
+name: eza
+description: 现代化的ls替代品，带彩色输出和图标
+category: essential
+tool_id: EXT-EZA-001
+---
+
+# eza (Modern ls) ⭐⭐⭐⭐⭐
+
+## 用途
+现代化文件列表，替代传统ls命令
+
+## 安装
+
+### macOS
+```bash
+brew install eza
+```
+
+### Ubuntu/Debian
+```bash
+sudo apt-get install -y gpg wget
+wget -qO- https://raw.githubusercontent.com/eza-community/eza/main/deb.asc | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/gierens.gpg
+echo "deb http://deb.gierens.de stable main" | sudo tee /etc/apt/sources.list.d/gierens.list
+sudo apt-get update
+sudo apt-get install -y eza
+```
+
+## 配置 (添加到 ~/.bashrc)
+
+```bash
+alias ll='eza -lah'
+alias ls='eza'
+alias tree='eza --tree --level=2'
+```
+
+## 使用
+
+```bash
+# 详细列表
+ll
+
+# Git状态
+ll --git
+
+# 树形结构
+tree
+
+# 显示图标
+eza --icons
+```
+
+## 常用选项
+
+- `-l` -- 长格式
+- `-a` -- 显示隐藏文件
+- `-h` -- 人性化大小
+- `-g` -- 显示Git状态
+- `--tree` -- 树形视图
+- `--icons` -- 显示文件图标

skills/toolkit/docs/tools/external/fzf.md

@@ -0,0 +1,81 @@
+---
+name: fzf
+description: 命令行模糊查找工具 - 用于交互式搜索和选择
+category: essential
+tool_id: EXT-FZF-001
+---
+
+# fzf (Fuzzy Finder) ⭐⭐⭐⭐⭐
+
+## 用途
+命令行模糊查找，革命性交互体验
+
+## 安装
+
+### macOS
+```bash
+brew install fzf
+$(brew --prefix)/opt/fzf/install  # 安装键盘快捷键
+```
+
+### Ubuntu/Debian
+```bash
+sudo apt-get install fzf
+```
+
+## 基础使用
+
+```bash
+# 文件名查找
+find . -type f | fzf
+
+# 历史命令
+history | fzf
+
+# Git分支
+git branch | fzf
+
+# 进程kill
+ps aux | fzf | awk '{print $2}' | xargs kill
+```
+
+## 进阶配置 (添加到 ~/.bashrc)
+
+```bash
+# 使用Ctrl-R搜索历史
+export FZF_CTRL_R_OPTS="--preview 'echo {}' --preview-window down:3:wrap"
+
+# 使用Ctrl-T搜索文件
+export FZF_CTRL_T_COMMAND="fd --type f --hidden --follow --exclude .git"
+export FZF_CTRL_T_OPTS="--preview 'bat -n --color=always {}'"
+```
+
+## 在ai-runtime中的建议
+
+```bash
+# 集成到discover-toolkit.py
+# 当选择工具时，使用fzf进行交互式选择
+python3 discover-toolkit.py list | fzf --height 40%
+```
+
+## 为什么我们不应重新实现
+
+- 7000+ stars on GitHub，社区验证
+- 性能优化到极致
+- 支持多种Shell和OS
+- 生态丰富（vim插件、tmux集成等）
+
+**类比**：就像人类不会自己打造锤子，而是从五金店购买。
+
+## 快速验证
+
+```bash
+# 检查是否安装
+which fzf
+
+# 验证版本
+fzf --version
+
+# 测试基本功能
+ls | fzf
+```

skills/toolkit/docs/tools/external/jq.md

@@ -0,0 +1,94 @@
+---
+name: jq
+description: JSON数据的命令行处理器 - 查询、过滤和转换JSON
+category: advanced
+tool_id: EXT-JQ-001
+---
+
+# jq (JSON Processor) ⭐⭐⭐⭐⭐
+
+## 用途
+命令行JSON查询、过滤和转换工具
+
+## 安装
+
+### macOS
+```bash
+brew install jq
+```
+
+### Ubuntu/Debian
+```bash
+sudo apt-get install jq
+```
+
+## 基础使用
+
+```bash
+# 美化打印
+cat data.json | jq '.'
+
+# 提取字段
+cat api.json | jq '.users[0].name'
+
+# 数组长度
+cat data.json | jq '.items | length'
+
+# 过滤
+cat logs.json | jq '.[] | select(.level == "ERROR")'
+
+# 转换
+cat data.json | jq '{new_name: .old_name, count: .items | length}'
+```
+
+## 在ai-runtime中的使用
+
+```bash
+# 分析JSON格式的认知记录
+jq '.entries[] | select(.type == "ERROR")' .ai-runtime/memory/episodic/timeline.json
+
+# 发现工具统计显示
+python3 discover-toolkit.py list --json | jq '.[] | {tool: .tool_name, lang: .language}'
+
+# 提取依赖分析结果
+python3 dependency-analyzer.py . -o report.json | jq '.vulnerabilities'
+```
+
+## 常用操作
+
+### 数组操作
+```bash
+# 映射
+cat data.json | jq 'map(.value * 2)'
+
+# 过滤
+cat data.json | jq 'map(select(.active == true))'
+
+# 排序
+cat data.json | jq 'sort_by(.date)'
+```
+
+### 对象操作
+```bash
+# 添加字段
+cat data.json | jq '. + {new_field: "value"}'
+
+# 删除字段
+cat data.json | jq 'del(.old_field)'
+
+# 合并对象
+cat data1.json data2.json | jq -s 'add'
+```
+
+### 高级技巧
+
+```bash
+# 条件判断
+cat config.json | jq '.env.WIN_VERBOSE = if .debug then "true" else "false" end'
+
+# 管道操作
+cat data.json | jq '.items[] | select(.price > 100) | .name'
+
+# 变量赋值
+cat data.json | jq 'first(.items[] | select(.id == "123")) as $item | $item.price'
+```

skills/toolkit/docs/tools/external/ripgrep.md

@@ -0,0 +1,68 @@
+---
+name: ripgrep
+description: 极速代码搜索工具（rg）- grep的现代化替代品
+category: essential
+tool_id: EXT-RG-001
+---
+
+# ripgrep (rg) ⭐⭐⭐⭐⭐
+
+## 用途
+极速代码搜索，默认递归搜索且遵守.gitignore
+
+## 安装
+
+### macOS
+```bash
+brew install ripgrep
+```
+
+### Ubuntu/Debian
+```bash
+sudo apt-get install ripgrep
+```
+
+## 配置
+```bash
+# 添加到 ~/.bashrc
+alias grep='rg'
+```
+
+## 使用
+
+```bash
+# 搜索Python文件中的TODO
+rg "TODO" -g "*.py"
+
+# 显示上下文（3行）
+rg -A 3 -B 3 "def function_name" app.py
+
+# 统计匹配数
+rg --count "import"
+
+# 搜索并打开文件
+rg "TODO" --files-with-matches | fzf | xargs bat
+```
+
+## 常用选项
+
+- `-i` -- 忽略大小写
+- `-g` -- 文件模式匹配（glob）
+- `-A NUM` -- 显示匹配后NUM行
+- `-B NUM` -- 显示匹配前NUM行
+- `-C NUM` -- 显示匹配前后各NUM行
+- `--count` -- 统计匹配数
+- `--files-with-matches` -- 只显示包含匹配的文件名
+
+## 技巧
+
+```bash
+# 搜索并替换（预览）
+rg "old_function" -S | fzf
+
+# 指定编码
+rg --encoding utf8 "pattern"
+
+# 与fzf集成
+rg "" --files-with-matches | fzf --preview 'rg --color=always "" {}'
+```

skills/toolkit/docs/tools/external/zoxide.md

@@ -0,0 +1,75 @@
+---
+name: zoxide
+description: 智能目录跳转工具（z）- cd的AI驱动替代品
+category: essential
+tool_id: EXT-ZOXIDE-001
+---
+
+# zoxide (Smart cd) ⭐⭐⭐⭐⭐
+
+## 用途
+智能目录跳转，学习访问习惯，基于频率和最近访问时间
+
+## 安装
+
+### 所有平台（推荐）
+```bash
+curl -sSfL https://raw.githubusercontent.com/ajeetdsouza/zoxide/main/install.sh | sh
+```
+
+或者使用包管理器：
+
+### macOS
+```bash
+brew install zoxide
+```
+
+### Ubuntu/Debian
+```bash
+sudo apt-get install zoxide
+```
+
+## 配置
+
+添加到 `~/.bashrc`:
+```bash
+eval "$(zoxide init bash)"
+alias cd='z'
+alias cdi='zi'
+```
+
+## 使用
+
+```bash
+# 第一次需要完整路径
+cd ~/projects/ai-runtime
+
+# 之后只需（zoxide会学习）
+z ai-runtime
+
+# 查看访问频率
+z --list | head
+
+# 交互式选择
+zi
+
+# 跳转到包含'proj'的目录
+z proj
+
+# 跳转到包含'ai'和'time'的目录
+z ai time
+```
+
+## 常用命令
+
+- `z --list` -- 显示访问目录列表
+- `z --list | head` -- 显示最近访问的目录
+- `z -i` -- 交互式跳转（同`zi`）
+- `z -e` -- 显示最高匹配目录
+
+## 特性
+
+- **智能学习**：基于访问频率和最近访问时间
+- **模糊匹配**：支持部分匹配
+- **跨Shell**：支持bash, zsh, fish等
+- **快速跳转**：通常比手动输入路径更快