Tools and Workflows zh CN

工具与工作流

English · 返回首页

内置工具

类别	代表工具	用途
文件读取	read_file、list_files、find_files	阅读文本或多模态文件、浏览目录、按名称查找文件
文件修改	write_file、apply_diff、insert_code、delete_code、delete_file	创建、重写、局部修改或删除文件
搜索	search_in_files	搜索内容、正则匹配与批量替换
终端	execute_command	执行命令、构建、测试和其他开发任务
语言服务	get_symbols、goto_definition、find_references	查询 VS Code 符号、定义和引用
文档流程	Design、Plan、Progress、Review 工具	创建和维护结构化工程文档
任务管理	todo_update 等	维护当前任务的步骤和状态
历史与知识	history_search、read_skill	检索历史对话并按需读取 Skill
媒体	图片生成、裁剪、缩放、旋转、去背景	生成或处理图像资源
记忆	memory_wake、memory_note、memory_recall 等	唤醒、记录、检索和维护永久记忆

设置界面的工具名会随语言切换，模型调用使用固定英文标识。模型传入的部分常见类型错误会自动纠正；未知参数会剥离并在结果中给出警告。

自动执行与确认

在 设置 → 自动执行 中决定哪些工具可以直接运行，哪些需要人工确认。建议对删除文件、执行任意命令、访问工作区外路径等高风险操作保留确认。

文件修改通常先显示 Diff。新建文件为了展示 Diff 可能会短暂预创建空文件；拒绝或取消时会清理该文件及本次创建且仍为空的父目录，清理失败会在工具结果中明确报告。

并行与冲突保护

同一批相邻的只读工具可并行执行，降低多次读取和搜索的累计延迟。写工具使用进程级路径锁，防止主会话与 Sub-Agents 并发修改同一文件或目录；遇到锁冲突时应先处理其他任务，再在当前写入者结束后重试。

相同参数连续失败后，GrayCode 会阻止无意义的重复调用并提示模型换一种方案。

推荐工作流

快速排查

1. Ask / Code 模式下描述现象和复现条件。
2. 先搜索相关符号、日志和调用点。
3. 要求 AI 说明证据、根因和影响范围。
4. 确认后修改，并运行最相关的测试。

复杂功能

1. 使用 Design 明确目标、非目标、约束、接口和风险。
2. 使用 Plan 将设计拆成可验证步骤。
3. 在 Code 模式逐步实现，并持续更新 TODO / Progress。
4. 使用 Review 检查完整 diff、边界和测试覆盖。

只读审查

在 Review 或 Ask 模式明确“只审查，不修改”。让 AI 按严重程度输出具体文件、行号、触发条件和证据；没有发现时也应说明已检查范围和剩余风险。

工作区外访问

read_file、write_file 等文件工具可以独立配置工作区外访问策略。若路径被拒绝，请到 设置 → 工具 展开对应工具，检查策略；不要仅为了绕过限制而扩大权限范围。