跳转到内容

技能

技能是用 Markdown 编写的可复用工作流程,适合代码审查、桌面问题诊断、发布检查等重复任务。它给 agent 一套针对任务的步骤,但不保证结果正确,也不授予额外权限。

在桌面输入框输入 /skills,打开技能目录。你可以搜索发现的技能、查看源码,并对允许用户调用的技能选择 Try now。技能也会出现在斜杠菜单中,名称后可以附带参数:

/release-check 2026.9.1

从菜单或目录选择技能后,输入框会插入带有显式身份信息的 /skill 草稿。请保留身份信息,在其下方补充请求。项目内技能绑定来源工作区和仓库相对指令路径,实际使用对话所选检出版本中的正文与资源;新工作树的首次发送也遵循这一规则。浏览目录不会创建工作树。用户技能、插件技能及其他外部技能保留绝对路径身份。提交时,Wuu 只从已发现且允许使用的目录条目中匹配技能,再调用模型;禁止自动选择的技能也支持这种显式调用。缺失、超出作用域或跨项目的选择会被拒绝,已有绝对路径草稿不会被静默重定位。直接输入 /review、/compact 等内置命令仍保持原有行为。

Wuu 引擎会向模型提供技能名称和描述。任务匹配时,模型可以通过 load_skill 读取完整流程。缺少描述的技能不会进入自动选择目录。设置 disable-model-invocation: true 还会阻止模型按名称加载该技能;user-invocable 则独立控制用户直接调用。

技能是否可用取决于工作区、发现来源和当前工具集。所需工具不可用的技能可能被过滤。工具要求可以填写可用内置工具、插件工具或 MCP 工具的准确公开名称,包括延迟加载和 PTC 工具。会话工具限制同样适用于这些要求,不因工具尚未发现或加载而失效;它不会启用已禁用的工具,也不会授予权限。如果出现的版本不对,检查它的来源路径。

Twin 的主对话和回复输入框通过 / 展示可由用户调用的技能。继续输入可筛选,上下方向键切换,Enter 或 Tab 选择,然后补充请求并发送。Escape 关闭菜单,Shift+Enter 换行。/settings 打开现有 Twin 设置面板,不发送消息。

将 Twin 技能安装到 $WUU_HOME/user-spaces/<space>/personal/files/.agents/skills/<name>/SKILL.md,默认本地空间是 local。本地 Twin 也会发现 Coding 的用户级技能目录;同名时优先使用 Twin 自己的技能。项目技能仍只属于对应项目,共享技能使用 Twin 自己的工具和权限。其他用户空间和经过验证的隔离主机只发现各自的 Twin 技能。现有 skills.enabled 设置须启用。安装技能后重新打开 Twin 可刷新菜单;提交时仍会重新校验技能身份和可用性。目录读取失败会保留草稿并提供重试。

只有经过身份校验的用户消息会展开技能。消息被接纳时保存技能内容,因此排队消息和回执重试保留原指令及附件。插件唤醒消息仍按字面处理。未知命令、文件路径和多行文本仍作为普通消息。

项目技能和用户技能修改后无需重启运行时。浏览目录时会重新读取本地目录,并使用短时缓存;模型在下一轮安全步骤边界采用变更,仅在可见目录变化时追加目录更新。加载本地技能时会读取已准入文件的当前正文,并重新检查调用规则和工具要求。文件缺失、改名、链接目标变化或格式损坏时,不会静默返回旧指令,也不会把这次加载切换到其他同名来源。

已经加载进历史的指令保留原文,包括已提交到队列的显式技能选择。插件技能仍固定在所属包版本,遵循扩展更新生命周期。后续步骤采用新目录时,本地发现仍遵守已说明的来源优先级。

使用第三方技能前,应阅读正文和配套脚本。正常的 load_skill 路径只替换参数并加载指令,不会在加载时执行内联 shell 表达式或代码块。但指令仍可能要求 agent 后续运行命令或访问网络,这些操作受会话工具和权限边界约束。

AGENTS.md 等项目指令会在适用范围内持续生效;技能按具体流程加载;记忆则保存值得跨任务保留的信息。

需要与贡献者共享的技能放在项目中,跨项目复用的个人技能放在用户技能目录。编写指南介绍发现顺序、元数据、参数和检查方法。

Terminal window
wuu skills lint path/to/skill
wuu skills lint --json path/to/skills-root

Lint 检查结构和元数据能否加载。除此之外,还应使用低风险任务验证流程实际表现。