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

34 lines
4.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 项目所属本地技能
2026-10-30。1.12接入本地SKILL.md登记、来源核对、显式启停、版本记录和实际模型按需读取;完整发行和正式部署见[1.12验收](QA-1.12.md)。本地stdio MCP另见[项目MCP](MCP.md),远程插件与任意附件/脚本自动运行仍单独开发。
## 使用与边界
在“项目技能”填写已审查的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真实模型请求。验证器此前字段/格式假设导致的三个末尾失败目录保留,没有改动产品协议以迎合测试。
完整回归在后续源码冻结时单独封存,不以本地夹具证明真实模型使用技能后的业务完成率。