用途:这是一份面向 AI 智能体的工具使用模式(Tool Usage Patterns)技能,目标是让智能体高效、可靠地利用可用工具并处理失败。
主要能力:
- 工具选择矩阵:按任务给出首选工具与备选方案,例如按文件名查找用 find_by_name(备选 list_dir 递归)、搜索代码内容用 grep_search、理解结构用 view_file_outline、读取指定行用带范围的 view_file、单点编辑用 replace_file_content、多点编辑用 multi_replace_file_content、运行命令用 run_command、网络调研用 search_web 与 read_url_content。
- 工具组合:给出文件探索流程(list_dir → find_by_name → view_file_outline → view_file → view_code_item)与编辑流程(view_file → 规划 → replace_file_content → run_command 验证)。
- 并行调用:独立任务(读多个文件、搜索不同目录、互不依赖的编辑)可并行;编辑后验证、读后编辑同一文件、有依赖的操作不可并行。
- 错误处理:针对文件未找到、命令失败、编辑冲突、超时、权限拒绝给出应对;重试策略为首次立即重试、第二次分析错误、第三次尝试替代方案、仍失败则询问用户。
- 效率与命令执行:尽量并行、先看大纲再读必要片段;列出可自动运行的安全命令(如 ls、cat、npm run lint、npm run build、git status、git diff、npx tsc --noEmit)与需审批的命令(如 npm install、rm、git push、git commit、数据库操作、网络请求)。
- 搜索与编辑实践:按已知文本、模式、文件名或探索选择搜索方式;编辑前先查看文件、使用准确行号、精确复制目标内容并验证结果,并列出常见编辑错误及修复方法。
使用方式:作为智能体技能/提示参考,在调用工具前按矩阵选型,按流程组合,按并行规则调度,按错误表与重试策略处理失败。
适用场景:需要多工具协作的代码探索、搜索、编辑与命令执行类智能体任务。
限制:资料未提供具体安装命令、平台支持、收费或价格信息;文中命令与工具名需按实际环境确认。