安装与使用技能

Skill 提供工作方法

Skill 描述什么时候使用、按什么步骤执行，以及怎样检查交付。它可以附带脚本、模板和资料。安装一个 Skill 不代表已经给它需要的外部服务授权。

从技能库开始

进入 能力 → 技能，搜索名称、标签或分类，打开详情查看说明。优先确认适用任务、来源、依赖和可能执行的脚本。

技能库管理全局资源，Agent 是否使用某项技能由各自的启用状态决定。scope: room 的技能在 Room 设置中启用。

导入 Git 或 ZIP

桌面版实图，导入前先确认技能来源与内容。

1. 打开 导入 Skill。
2. 使用 Git 方式时填写 HTTPS 仓库地址；可选分支，技能不在根目录时填写子目录，例如 skills/report-review。
3. 使用 ZIP 方式时选择包含 SKILL.md 的压缩包。
4. 完成导入后重新打开详情，检查名称、说明和来源。
5. 在目标 Agent 或 Room 中启用，再发一个适合它的小任务。

技能压缩包必须包含 SKILL.md。导入多层目录时系统会寻找靠近根部的技能入口，导入前应确认目录对应所需技能。

把仓库地址拆成导入字段

一个仓库可以包含多个技能。假设技能位于仓库的 skills/report-review/SKILL.md，Git 导入需要指定技能目录。

示例仓库仅说明填写方式。先检查目录里有没有所需脚本和资料，再导入。只取得 SKILL.md 而漏掉它引用的文件，可能导致安装成功但任务执行失败。

ZIP 内容怎样组织

report-review/
  SKILL.md
  references/
    checklist.md
  scripts/
    check-report.py

SKILL.md 是入口，其他目录按该技能的实际需要提供，不必为简单技能建空目录。ZIP 中的相对引用应能在解压后找到对应文件。外层套有仓库目录时，确认最终导入的是目标技能，不能只凭压缩包名字判断。

安装、启用和本次使用分别检查

名称相似的技能可能来自不同来源。试用前打开详情检查内容，再在请求中明确指定技能和交付物。不要通过安装多个同名条目尝试修复启用问题。

使用和验证

请使用已启用的报告复核技能检查这份草稿。
先列出事实缺口，再检查结构；交付 review.md，不直接发布。

检查 Agent 是否遵循技能中的步骤，以及相关工具是否能运行。未调用时核对适用条件、启用范围和当前上下文，并确认该技能适用于所选运行引擎。

在输入框输入 /skills 可以为当前请求临时选择技能，不改变 Agent 的长期启用设置。系统必需的技能可能显示为锁定，不能像普通技能一样关闭。

如何判断技能确实起作用

用一份有已知问题的教学草稿测试，例如故意缺少日期或来源。技能要求先检查事实时，输出应指出这些缺口；要求保存复核文件时，应能打开对应文件。

任务未按方法执行时，依次检查入口内容、适用条件、启用范围和依赖。技能需要连接器或脚本运行环境时，分别验证这些依赖。修改权限模式不会安装缺少的程序。

更新与移除

使用技能页的更新检查查看外部导入技能的新版本。更新前阅读来源变化，尤其是脚本和外部访问。保存或更新完成但目录未刷新时，先刷新当前状态，避免重复导入。

不再需要时先从使用它的 Agent 或 Room 停用，再根据需要移除全局条目。移除技能不会撤销它此前已经写入的文件或外部结果。

更新后的回归检查

更新前保留当前技能来源、分支和关键要求，阅读新增脚本或外部访问。更新后用同一份教学材料再跑一次，比较检查结果和交付格式，避免把方法变化误认作模型随机变化。

固定工作流程需要稳定版本时，应由技能维护者管理仓库版本，不把“已检查更新”当成内容永远不变的保证。需要自己编写完整入口，阅读Agent Skill 编写。

自己编写

一套方法经过任务验证后，就可以整理成Agent Skill。多人协作的交接、汇总和停止规则使用Room Skill。