Tools 与 Skills
最近更新：
工具（Tool）负责具体操作，例如读取文件；Skill 提供完成某类任务的说明、资源和可选工具。为 Agent 选择能力时，先确定任务需要读什么、改什么，再配置相应工具和说明。
以下步骤面向已有自定义 Agent 和 Project 的用户。外部 Agent 的能力需要按其自身支持的方式配置。
添加能力
- 在 Agent 或 Project 的 Tools 标签中查看可选工具：ToolBlock 卡片显示用途说明、包含的成员工具，可能需要审批时还会显示 Approval 标记；单个工具在下拉列表中显示名称、说明和分类。
- 在 Skills 管理可用 Skill，阅读其说明与前提。
- 在 Agent 中绑定本次任务需要的工具和 Skills。
- 在正确的 Project 中开始新回合，先验证读取类任务，再验证确实需要的写操作。
每个工具显式声明 AgwToolPermission。运行权限由执行管线检查；提示词写“允许”不会跳过权限或资源归属验证。
内置 ToolBlock
| ToolBlock | 用途 | 可配置在 |
|---|---|---|
| Todo | 用持久保存的待办清单跟踪多步骤工作 | Agent、Project |
| Mode | 在 Plan 与 Execute 之间切换，见 Plan 与 Execute 模式 | Agent、Project |
| File Access | 读取和修改 Project 工作目录中的文件 | Agent、Project |
| User Memory | 当前用户跨 Project 使用的记忆 | Agent、Project |
| Project Memory | 当前 Project 共享的记忆，保存在数据库或主目录中，见记忆 | Agent、Project |
| Background Agents | 把工作委派给明确允许的 Agent，需要在 Allowed delegation targets 中选择目标 | 仅 Agent |
File Access 中的 file_access_read、file_access_read_lines、file_access_ls 和 file_access_grep 是只读工具，可以在 Plan 模式中使用；file_access_write、file_access_delete、file_access_replace 和 file_access_replace_lines 需要写入权限。
Local 与 Remote Skill
创建 Skill 时，可以按内容的维护方式选择模式：
| 模式 | 内容来源 | 更新方式 |
|---|---|---|
| Local（本地） | 上传包含 SKILL.md 的 ZIP 包，文件保存在 AGW 服务端 | 编辑 Skill 并上传新版 ZIP 包 |
| Remote（远程） | 填写可通过 HTTP 或 HTTPS 下载 Skill ZIP 包的网址 | 在远程更新内容，AGW 按缓存规则重新获取；编辑并保存 Remote Skill 也会重新获取内容 |
Local 中的“本地”指 AGW 服务端，不是浏览器所在的电脑。Remote 表示说明内容来自远程地址，任务仍由 Agent 执行。
- 在 Skills 中创建 Skill，选择 Local 或 Remote。
- Local 填写名称和描述，上传含
SKILL.md的 ZIP 包；Remote 填写 ZIP 下载地址，无需上传文件。AGW 以不带认证信息的 GET 请求下载 Remote 地址，需要登录或 Token 才能访问的地址无法使用。 - Remote 包中必须恰好有一个
SKILL.md，其中的 YAML 元信息需包含name、description，正文需包含使用说明。名称和描述由远程文件提供。 - 保存成功后，在 Agent 或 Project 中选择该 Skill，再用一个相关的小任务验证说明是否可用。
Remote Skill 当前读取包内的说明，不会下载并运行包中的脚本，也不会提供包内其他资源文件。需要这些文件时应选择 Local 模式，并准备好执行环境。
Remote Skill 缓存
AGW 在创建或保存 Remote Skill 时获取内容，并将其缓存到数据库中，缓存有效期为 1 小时。
- 有效期内读取同一个 Skill 时，直接使用缓存，减少重复下载。
- 缓存过期后，在下一次需要读取该 Skill 时重新获取；不是每小时定时下载。
- 远程内容更新后，可以等待缓存过期，或编辑并保存该 Remote Skill 来重新获取内容。
- 刷新失败时会报错，不会延长旧缓存的有效期或继续使用过期内容。先检查服务端能否访问下载地址，以及 ZIP 和
SKILL.md格式是否正确。
自动刷新时，远程 name 必须与已保存的 Skill 名称一致。若远程改了名称，需要编辑并保存 Skill 以更新定义。缓存刷新也不会改写已经加载到当前对话中的内容，验证新版说明时应让 Agent 重新读取 Skill。
Skill 专属工具
Skill 拥有的工具只通过该 Skill 注册，在运行时绑定 Project，不是全局工具目录条目。没有在全局列表看到它，不代表它不可用。
例如 agw-job 提供 agw_job_list、agw_job_get、agw_job_create、agw_job_update、agw_job_delete。读取在 Plan 模式可用，写入在 Plan 模式禁止。
检查结果
查看工具活动的名称、参数及返回值，确认使用了预期的 Project。能力缺失时检查 Skill 绑定和运行模式；实际需要外部服务时，继续配置 MCP 或 Integrations。