# Tools 与 Workspace

状态：todo  
期望阶段：P2

## 目标

让单 Agent 在隔离工作区中使用文件与 Shell 完成真实任务。

## 已确定

- Tool 是 Agent 主动调用的外部能力。
- 第一批能力：读写文件、目录浏览、文本搜索和 Shell 执行。
- 每个 Task 有独立 Workspace；Shell 默认在该目录执行。
- Tool 调用参数、输出、错误和生成脚本文本写入 Run 日志。
- Agent 通过模型 Tool Calling 自主选择、调用并读取 Tool 结果。
- 初期不建设复杂审批或权限语言；真实破坏性操作出现后再增强。

## 待细化

- Shell 超时、取消、后台进程和大输出处理。
- 文件写入与补丁的交互方式。
- Tool 描述和参数 Schema 的具体格式。