内置工具清单

Mogick 依据执行模式生成工具目录。Plan 只允许探索、提问和写计划；Agent 提供完整的写入、执行、MCP 与变更追踪能力。实验性功能和构建能力可能进一步裁剪工具。

文件与代码搜索

工具	功能	Plan	Agent
`file.read`	读取文件	✓	✓
`file.list_dir`	列出目录	✓	✓
`file.glob`	按 glob 匹配文件	✓	✓
`file.grep`	搜索文件内容	✓	✓
`code.search`	使用 mwcs 做语义代码搜索；取决于构建是否包含 mwcs	✓	✓
`file.tree_find`	使用 mwcs 按文件树定位；取决于构建是否包含 mwcs	✓	✓
`file.write`	创建或覆盖文件	—	✓
`file.edit`	精确编辑文件	—	✓
`file.apply_patch`	应用多文件补丁；可能部分成功，不保证事务性	—	✓
`file.delete`	删除文件	—	✓

文件写入、编辑和删除受权限策略约束。长工具结果会在送入模型时截断，但完整结果仍保存在会话记录中。

工具	功能	Plan	Agent
`shell.exec`	执行 Shell 命令并返回结果	—	✓
`git.status`	查看工作区状态	✓	✓
`git.diff`	查看差异	✓	✓
`git.log`	查看提交历史	✓	✓
`git.show`	查看提交内容	✓	✓

Git 内置工具是只读 evidence 工具；需要执行写入类 Git 命令时，由 Agent 使用 shell.exec，并接受相应权限审批。

bash

mogick run "Run go test ./... and summarize the failures"

工具	功能	Plan	Agent
`plan.read`	读取当前计划	✓	✓
`plan.write`	保存或增量更新计划	✓	—
`todo.write`	写入任务列表	✓	✓
`todo.update`	更新任务状态	—	✓
`user.question`	向用户发起结构化单选或多选问题	✓	✓
`tool.usage`	查询工具用法	✓	✓
`agent.task`	委派子代理；受实验功能开关控制	✓	✓

plan.write 完成后，模型结束当前轮次，TUI 或 ACP 宿主负责展示确认并切换模式。Plan 流程不使用 plan.exit。

工具	功能	Plan	Agent
`skill.find`	发现 Skills	✓	✓
`skill.load`	加载 Skill 指令	✓	✓
`skill.create`	创建 Skill	—	✓

Skill 搜索和加载是只读操作；创建 Skill 属于写操作，需要 Agent 模式。

MCP 元工具仅在 Agent 模式提供。

mcp.call 可以包装有副作用的远程工具，因此默认进入审批。服务器工具若声明 readOnlyHint，权限策略可将其视为只读操作。

Agent 模式还提供以下工具，服务于 Changes 面板、/review 和运行结果汇总：

工具	功能	Plan	Agent
`changeset.list_groups`	列出 Changeset 分组	—	✓
`changeset.read_group_patchset`	读取分组的 patch 详情	—	✓
`changeset.commit_context`	生成提交上下文	—	✓
`execution.summary`	汇总运行结果	—	✓
`tracing.group`	追踪分组信息	—	✓
`julia.interpreter`	Julia 代码解释执行；取决于构建配置	—	✓

只读工具可以并行执行；有副作用的工具会按运行时策略串行和审批。完整审批语义见工具审批与权限策略。

会话具备所需官方服务与场景模型时，Plan 和 Agent 可提供 image.understand、image.ocr。仅登录账号并不保证任意自定义 provider 会话具备这些工具。见文件与图片输入。