用途:在需要选择命令行工具时提供决策支持,覆盖按文件名查找、文件内容搜索、AST 代码搜索、JSON 处理、文件查看、目录列出、git diff 查看、目录跳转、模糊选择、HTTP 请求等任务;也用于工具异常缓慢、用户表达不满或任务可更优雅完成的情况。不适用于工具已确定或仅一行简单命令的场景。
主要能力:先运行检测脚本(bun /Users/mg/Developer/outfitter/agents/baselayer/skills/use-the-best-tool/scripts/index.ts),解析输出以确定可用工具、缺失工具与系统环境(OS、包管理器),并按会话缓存结果。随后按选择表映射任务到最优工具,如 fd 优先于 find,rg 优先于 grep,sg 用于结构感知搜索,jq 处理 JSON,bat 查看文件,eza 列目录,delta 看 git diff,zoxide 跳转目录,fzf 模糊选择,httpie 发请求;不可用时依次回退。
使用方式:标准流程为接收任务、分类、检查检测结果、选择工具、以最优参数执行、评估是否触发研究。缺失首选工具时按收益分级处理:提升轻微(10%–30%)则静默使用次优方案;提升显著(2 倍以上)则提示 ◇ Alternative 与安装命令但不阻塞;关键缺失则提示 ◆ Caution 并让用户选择安装、继续或推迟。研究流程包括搜索现代 CLI 工具、检查 GitHub 趋势、从速度、易用性、维护度、安装复杂度、兼容性评估候选,并给出工具名、优势、安装命令、用法示例与取舍。
限制与注意事项:不得假设工具已安装,必须先检查检测结果;不得因缺失非必需工具而阻塞流程;不得推荐无人维护的工具;有现代替代时不用旧工具;缺失首选工具时必须有回退策略。文档还提到 tool-catalog.md、alternatives.md、detection-script.md 等资料文件,但未提供其具体内容。