Files
Agent-Workbench/docs/SKILLS.md
T
2026-10-30 20:59:18 +08:00

4.2 KiB
Raw Blame History

项目所属本地技能

2026-10-30。1.12接入本地SKILL.md登记、来源核对、显式启停、版本记录和实际模型按需读取;完整发行和正式部署见1.12验收。本地stdio MCP另见项目MCP,远程插件与任意附件/脚本自动运行仍单独开发。

使用与边界

在“项目技能”填写已审查的SKILL.md绝对路径、名称、用途和版本。登记只读取UTF-8常规文本,最多64KB;默认停用。审查保存的原文后显式启用,后续任务才能从项目目录按需读取。管理、来源核对和查看旧修订均不请求模型。

每项目最多32项注册、8项同时启用,每项最多20修订,全部注册元数据最多8MB。来源使用规范路径与实际文件SHA256,快照正文脱敏后独立保存散列;版本字符串是用户声明,SHA256才是本次实际字节身份。来源内容改变或无法读取时显示明确状态,不自动采用新文件。登记新修订保留旧文本并自动停用,用户审查后重新启用。configurationRevision防止旧页签迟到启停覆盖当前状态。

技能是用户选择的参考流程。注册内容不授予文件、命令或其他工具权限,不能覆盖原用户目标或既有审查;文本里的命令不会在注册或读取时执行。本切片只登记SKILL.md,正文中的相对附件、脚本、网站或其他技能没有因此自动加载/执行。原文审查使用纯文本,不渲染HTML。

实际请求与追溯

每轮模型请求前重新读取来源字节并核对,只为当前项目启用项生成目录。目录最多8项/12000个转义UTF-8 JSON字节,仅使用原目标、完整工具配对和当前代码选择后的剩余预算;空间不足的整项省略,已启用不保证每次请求都有预算。目录保留来源状态,变化项不可调用。

发送目录保存为context-skill-catalog工件,绑定消费Session/Task/Run;请求计划保留ID/SHA/条数,verifyPlanEvidence核对原工件、归属、预算和实际消息正文。之后停用、更新来源或重启不改写旧请求证据,旧工件损坏直接拒绝。

模型通过read_registered_skill按本次已发送目录的ID/revision/source_sha256读取,宿主复核完整请求证据、当前启用状态和来源。不能猜测跨项目或被省略的技能ID。原文以脱敏后的skill-instructions工件保存,绑定当前Task/Run并按已有工具JSON预算分页;后续使用read_artifact和next_offset读取同一快照,避免重新读取变化后的来源。完整工具调用和结果沿用原账本,重复区间沿用读取进展限制。技能文字不作为任务计划的工程完成证明。

凭据在注册和发送时由当前Provider已知秘密脱敏。程序不扫描用户Skills目录、不导入第三方登录态或环境变量,也不会因目录通知自动安装代码。配置写入事务失败保留原注册状态,快照损坏阻止目录消费,原任务和工件保持可核对。

API与本地验收

  • GET /api/projects/:projectId/skills:当前项目列表和来源核对。
  • POST /api/projects/:projectId/skills:登记path/name/description/version,默认停用。
  • POST /api/projects/:projectId/skills/toggle:id/revision/configurationRevision/enabled,项目执行时拒绝。
  • POST /api/projects/:projectId/skills/refresh:id/revision/configurationRevision/version,保留旧修订并停用新修订。
  • GET /api/projects/:projectId/skills/content?id=…&revision=…:查看保存的原文,不读取附带文件或执行内容。

10项专项覆盖真实本地HTTP目录/正文读取、脱敏、项目隔离、停用/来源变化、长Unicode分页、预算、事务失败、原工件损坏、SQLite重开和API。现有升级2项扩充技能注册对象重建/失败回滚,12/12通过。桌面1440px/390px四组通过并目视核对,证据.qa/skills-ui-aa3ba90d-1038-442b-9729-d41a00ac65c0;2次自有本地HTTP请求,0真实模型请求。验证器此前字段/格式假设导致的三个末尾失败目录保留,没有改动产品协议以迎合测试。

完整回归在后续源码冻结时单独封存,不以本地夹具证明真实模型使用技能后的业务完成率。