概述

Skill Workshop 是实验性的工作区技能过程记忆插件(默认禁用)。它让 Agent 将可复用工作流、用户纠正、难得的修复方法和反复出现的陷阱转化为 SKILL.md 文件,存储在 <workspace>/skills/<skill-name>/SKILL.md。与长期记忆的区别:记忆存储事实/偏好/实体,技能存储 Agent 在未来任务中应遵循的可复用过程。

核心功能

  • 三种捕获路径:工具建议(模型直接调用 skill_workshop)、启发式捕获(扫描”next time”/“from now on”等纠正短语)、LLM 审查器(阈值触发的嵌入式审查运行)
  • 提案生命周期:pending(等待审批)→ applied(已写入)/ rejected(已拒绝)/ quarantined(被安全扫描器阻止)
  • 安全扫描器:检测提示注入(ignore-instructions/system/tool)、curl 管道到 shell、密钥外泄等关键发现,自动隔离
  • 审批策略:pending(推荐,需手动 apply)或 auto(可信工作区,安全提案自动写入)
  • 热刷新:技能写入后立即刷新内存快照,无需重启 Gateway
  • 工具操作:status、list_pending、list_quarantine、inspect、suggest、apply、reject、write_support_file

配置/使用

推荐起步配置(保守,需审批):

{
  plugins: {
    entries: {
      "skill-workshop": {
        enabled: true,
        config: {
          autoCapture: true,
          approvalPolicy: "pending",
          reviewMode: "hybrid"
        }
      }
    }
  }
}

关键配置项:

字段默认值说明
approvalPolicy"pending""pending" 或 "auto"
reviewMode"hybrid""off"/"heuristic"/"llm"/"hybrid"
reviewInterval15每 N 次成功轮次运行审查器
maxPending50每工作区最大待处理提案数

避免在以下场景使用 auto 策略:工作区含敏感过程、Agent 处理不可信输入、技能跨团队共享。

相关页面

  • concepts/tool-skills — Skills 技能系统总览
  • concepts/tool-creating-skills — 手动创建 Skill 指南
  • concepts/plugin-system — 插件系统