用途
mcp-tool-priority 是一条面向 AI 编码智能体的行为规则集合，用于在会话中存在 MCP 服务器或专用文件工具时，约定工具选择与异常处理方式。其核心目标是避免智能体习惯性地用 Bash 处理本可由专用工具完成的任务，并在专用能力缺失时保持透明。
主要能力与规则
优先使用专用工具读取已知路径
当文件路径已经明确时，应使用 Read 工具或项目指定的 MCP 文件读取工具，而非 Bash 的 cat、rtk read 或对已知路径的 shell 循环。该规则适用于会话中的所有代理，包括实现、审查、研究与规划子代理。用 Bash for 循环批量 cat 多个已知文件被视为最差实践，既不便审查，也不比逐次调用专用工具有优势。
Bash 仍保留给专用工具无法表达的场合：需要 find/grep 定位未知文件集合、二进制文件，或真正的 shell 文本处理流水线。
MCP 工具应直接调用
当项目规则要求使用特定 MCP 工具（如 WebStorm、Context7、数据库客户端等）时，应直接通过 MCP 工具调用使用，不得通过终端命令启动、代理或模拟。若当前上下文（例如不具备该能力的子代理）无法直接访问 MCP，应如实报告，而不是用近似行为的 shell 命令绕过。
缺失/禁用与临时错误的区分
如果项目规则指定的 MCP 工具未安装、未连接或对当前用户禁用，应主动说明并建议安装、连接或启用，并在给出非 MCP 替代方案时将其作为回退而非默认。若只是临时连接错误（如一次性的 session not found、连接中断），则视为环境波动，直接回退或重试即可，无需建议安装。
每个项目一个指定工具
项目通常指定一个 IDE/编辑器 MCP 服务器作为优先工具（示例中为 WebStorm MCP）。当规则只说“使用 MCP”而未指明服务器时，指该项目指定的那一个；应先查阅项目自身说明确认是否已配置。
worktree 预检
在会话首次文件读取前，或刚发现会话运行于 git worktree 内时，应先通过 pwd/cwd 确认工作目录是否真在 worktree 路径内，而不是等到 MCP 与 Read 的选择问题出现时再判断。在 worktree 内，项目指定的 MCP 工具常按主检出解析路径，可能静默返回过期内容，因此默认只用 Read，直到环境确认工具能正确处理 worktree 路径。这是一次性预检，而非逐文件判断。
使用方式
该规范以技能/规则文本形式提供，供 AI 编码助手在会话中遵循。用户需在项目中配置相应 MCP 服务器或文件工具，并可在项目指令中声明指定的 MCP 工具。
适用场景
- 已配置 MCP 服务器或专用文件工具的 AI 编码会话
- 多代理协作（实现、审查、研究、规划子代理）
- 在 git worktree 中工作的场景
- 需要明确工具回退策略与错误提示的团队规范
限制
资料未提供具体的安装命令、配置细节、支持的 MCP 服务器完整列表或价格信息。规范的执行依赖智能体对规则的遵循以及项目自身的 MCP 配置。worktree 路径解析问题的行为描述为经验性提示，资料未给出通用验证方法。