---
title: Skill 与工具
summary: 可复用工作流与工具能力、Skill 管理以及已加载 Agent 指引之间的关系。
order: 40
---

# Skill 与工具

Skill 是以 `SKILL.md` 文件为入口的可复用工作流。工具（Tool）则是运行时开放的操作接口，例如读取文件、执行系统命令或搜索记忆。Agent 通过阅读 Skill 了解具体工作流程，再使用可用工具将其落实。

例如，一个代码审查 Skill 可以要求每条发现都必须附带证据。Agent 可以调用命令行工具查看 diff 并运行测试。安装该 Skill 本身并不会为 Agent 开通终端执行权限、代码仓库凭据或提交审查结果的权限。

## Skill 如何发挥作用

Skill 的管理与实际调用发生在不同阶段：

1. Skill Library（技能库）登记可被统一管理的 Skill。
2. 为特定 Agent 启用技能库中的某项 Skill，使其对该 Agent 可见。
3. 发现机制向 Agent 展示包含名称、描述与文件路径的目录项。
4. 匹配到对应任务时，Agent 打开 `SKILL.md` 并遵照其中的步骤执行。

目录中还可以包含在当前工作区发现的本地 Skill。目录项对 Agent 可见，仅说明 Agent 能够找到它，并不意味着全部指引正文已预先载入上下文，更不意味着该工作流已经被执行。

理清这层区别有助于排查问题：如果找不到 Skill，应检查发现机制与启用状态；如果 Agent 跳过了规定步骤，应检查它是否读取了该 Skill；如果某条命令执行失败，应排查工具、认证凭据和运行环境，而不要盲目重新安装该 Skill。

## 指引与权限边界

`AGENTS.md` 规定长期职责与项目约定。Skill 则在既定范围内提供可重复执行的操作流程。[Agent 模板](./agent-templates.md)可以将角色契约与 Skill 依赖组合在一起，让新初始化的 Agent 具备预期能力。

Skill 中描述的某些步骤，可能并不在当前任务的授权范围内。例如在只读审查任务中，即便 Skill 包含发布逻辑，也不应当执行。Skill 正文无法强行开启被运行时策略禁用的工具，也无法把不可信的外部输入提升为操作者指令。Skill 附带的脚本属于待执行代码，与常规命令遵循相同的安全限制。

## 更新与共享来源

技能库管理与单个 Agent 的启用是解耦的。修改或删除公共技能库的内容，可能波及依赖该 Skill 的其他 Agent。为某一 Agent 禁用 Skill，只影响该 Agent 的启用名单。

软链接方式安装的 Skill 会直接反映源文件的修改；而作为受控副本（copy）安装的 Skill 则有独立的更新周期。应根据需要决定是共享持续演进的源目录还是保留稳定独立的副本。修改后记得核对生效的 Skill 列表；在本地创建链接并不会自动同步修改到上游仓库。

## 对工具的合理预期

工具的可用性取决于运行时能力与安全策略。特定模型服务商或执行环境可能带来附加限制：图像观察需要有效的视觉路由，命令执行则需要对应的系统环境。Skill 工作流可以说明这些要求，但单靠安装 Skill 无法自动满足它们。

工具的回执（Receipt）构成了操作发生的客观证据。阅读过 Skill 不等于测试已通过；请求被运行时接受也不等于后台任务已完成。评估进展时，应检查对应操作的真实回执。

## 下一步

- [安装、启用与更新 Skill](../guides/use-skills.md)
- [编写与验证 Skill](../guides/write-skill.md)
- [Skill 管理与清单参考](../reference/skills.md)
- [工具 Schema 参考](../reference/model-tool-schema-inventory.md)
- [执行边界](./security-and-execution-boundaries.md)