技能

技能是使智能体更聪明的可复用知识。它们包含领域专长、编码规范、审查清单，或任何您希望智能体始终遵循的指令。

当您与 Themis 对话时，它会自动加载所有对您可用的技能 —— 无需手动引用。

浏览技能

前往侧边栏中的技能查看您空间中所有可用的技能。您可以按以下条件筛选：

  • 已启用 / 已禁用 —— 活跃技能与已停用技能
  • 我的 —— 您的个人技能
  • 空间 —— 与所有空间成员共享的技能
  • 系统 —— 跨所有空间可用的技能（由管理员创建）

每个技能显示其名称、范围、描述、创建者和最后更新日期。点击任何技能查看其完整内容和附件。

在对话中使用技能

您无需做任何特殊操作 —— 智能体会在对话过程中自动发现并应用相关技能。例如，如果您的空间有一个”代码审查清单”技能，智能体在审查 PR 时会自动遵循它。

斜杠命令面板

要显式调用某个技能，请在聊天输入框的空白处或新行开头输入 /。会打开一个面板，列出当前空间内您可用的所有技能及其描述和示例提示。

  • 输入更多字符进行筛选（例如 /code）。
  • 方向键导航，Enter 或 Tab 将 /<skill-name> 插入消息中。
  • 列表使用与 Themis 加载技能时相同的优先级（个人 > 空间 > 系统）进行去重。如果您和您的空间都有名为 summary 的技能，面板会显示（并插入）个人版本。

在手机上，面板保持隐藏，因为软键盘的自动补全已经满足了同样的需求。

示例提示

每个技能最多可携带 10 条示例提示（每条 200 字符以内）。它们会在斜杠命令面板中显示，让用户无需打开技能就能了解它擅长什么。

在技能表单的示例字段中添加，或通过对话添加（”给我的 deployment-checklist 添加一个示例提示：’带我走一遍部署支付服务的流程’“）。示例与技能一起保存，并通过同一个版本历史更新。

好的示例是用户实际会输入的具体提示，而不是抽象的描述：

  • ✅ “带我走一遍部署支付服务的流程”
  • ❌ “一份部署指南”

您也可以直接在对话中让智能体管理您的个人技能：

  • “创建一个名为 deployment-checklist 的技能，包含以下步骤…“ —— 使用您的指令创建个人技能
  • “更新我的 deployment-checklist 技能，加入数据库迁移步骤” —— 替换 SKILL.md 内容
  • “将 deployment-checklist 的版本改为 v0.2” —— 快速查找替换编辑，无需重写整个文件
  • “列出我的技能” —— 显示您所有个人技能及链接

在对话中管理技能文件

技能可以包含 SKILL.md 以外的多个文件 —— 模板、脚本、参考文档、配置文件。所有这些都可以通过对话管理：

  • “列出 deployment-checklist 的文件” —— 显示所有文件的路径、大小和是否可编辑
  • “在 deployment-checklist 中添加 references/api.md 文件，内容如下…“ —— 在技能中创建新文件
  • “将 deployment-checklist 中 template.html 的颜色从 #333 改为 #1a1a1a” —— 使用查找替换编辑任何文本文件（HTML、CSS、Python、JS、YAML 等）
  • “从 deployment-checklist 中删除 old-notes.md” —— 删除文件（SKILL.md 不可删除）

通过对话创建的技能始终为个人范围。使用技能 UI 可创建空间或系统级技能。

通过 UI 创建技能

  1. 前往技能，点击新建
  2. 填写以下信息：
    • 名称 —— 小写加连字符（例如 api-design-guidelines）
    • 描述 —— 帮助智能体判断该技能何时相关
    • 示例 —— 最多 10 条简短的示例提示（每条 200 字符以内），将显示在斜杠命令面板中
    • SKILL.md —— Markdown 格式的主要指令
    • 文件 —— 可选上传补充文档文件夹
  3. 选择范围：
    • 个人 —— 仅您自己可用
    • 空间 —— 与所有空间成员共享（经理和所有者）
    • 系统 —— 跨所有空间可用（仅管理员）
  4. 保存 —— 技能立即对智能体可用

协作编辑（签出 / 签入）

空间技能和系统技能是共享资源。为防止编辑冲突，Themis 使用签出/签入工作流 —— 同一时间只有一人可以编辑。

工作原理

  1. 签出 —— 点击空间技能或系统技能上的签出。技能将被锁定（阻止他人编辑），并为您创建一个个人副本。
  2. 编辑 —— 通过 UI 或对话修改您的个人副本。个人副本会自动遮蔽原始版本，因此测试时智能体会使用您的版本。
  3. 签入 —— 满意后，点击原始技能上的签入。您将看到变更的差异预览。确认后，共享技能将被替换为您的版本。
  4. 放弃 —— 改变主意？点击放弃可删除个人副本并解锁技能，不做任何更改。

谁可以签出

  • 空间技能 —— 只有经理和所有者可以签出。普通成员可以查看但不能锁定技能进行编辑。
  • 系统技能 —— 只有管理员可以签出。系统技能在所有空间之间共享，因此编辑需要管理员权限。

强制解锁

如果某人的签出长时间未处理，经理可以强制解锁空间技能，管理员可以强制解锁系统技能，以丢弃签出并释放技能。清理任务也会自动使超过 7 天的锁过期。

对话工具

您也可以通过对话管理签出：

  • “签出 code-review-checklist 技能” —— 锁定并创建个人副本
  • “签入我的 code-review-checklist 更改” —— 将编辑应用到共享技能
  • “放弃我的 code-review-checklist 签出” —— 不做更改直接解锁
  • “将 code-review-checklist 的版本改为 v0.2” —— 快速查找替换编辑（避免重写整个文件）

版本历史

技能的每次更改都会被追踪，并显示在技能详情页面上。版本历史部分显示：

  • 谁做了更改以及何时做的
  • 来源 —— 更改来自 Web UI、对话还是签入
  • 更改内容 —— 每个修改字段的标签（描述、SKILL.md 等）
  • 差异预览 —— 点击”显示更改”查看并排的前后对比

版本历史是审计日志 —— 帮助您了解技能如何随时间演变。注意：仅追踪元数据和 SKILL.md 内容的更改；其他附件文件的更改不包含在版本历史中。

启用 / 禁用

从技能表格中切换技能的启用或禁用状态，无需删除。已禁用的技能不会被智能体加载。

示例

适合作为技能的内容：

  • 编码规范 —— 特定语言的风格指南和模式
  • 审查清单 —— 安全检查、性能考量、可访问性要求
  • 领域知识 —— 业务规则、API 文档、系统架构
  • 工作流指令 —— 如何分类 Bug、编写用户故事或组织报告