文档导航
文档 / Skills

Skills

Skills 是任务专属的指令包和脚本。它们让 OpenSquilla 只在任务需要时才加载相关指引,而不是把每一种可能的指令都塞进每个 prompt。

Skills 与记忆是分开的。记忆存储事实;skills 描述可复用的工作方式。

Skills 的用途

将 skills 用于可复用的工作模式,例如:

  • 深度研究;
  • 摘要;
  • GitHub 与 PR 工作流;
  • 文档生成;
  • 表格、幻灯片、PDF 与 DOCX 工作;
  • Web 搜索;
  • 天气查询;
  • 终端或 tmux 监控;
  • subagent 委派;
  • skill 创建与审阅。

如果 workflow 组合了多个 skill 或一个可复用的多步骤计划,请改用 meta-skill。

发现已安装的 Skills

列出当前安装中可用的 skills:

opensquilla skills list

查看某个 skill:

opensquilla skills view <skill-name>

搜索社区来源:

opensquilla skills search pdf

当可选依赖缺失或 skill 本身是仅用于演示时,部分 skills 可能不符合启用条件。skills list 是当前安装状态的唯一来源。

安装、更新和移除 Skills

安装一个受管 skill:

opensquilla skills install <skill-name>

更新单个 skill 或所有受管 skills:

opensquilla skills update <skill-name>
opensquilla skills update --all

移除一个受管 skill:

opensquilla skills uninstall <skill-name>

管理 Skill 来源

自定义来源仓库称为 taps:

opensquilla skills tap list
opensquilla skills tap add <owner/repo>
opensquilla skills tap remove <owner/repo>

当你的团队维护自己的 skill 目录时,使用 taps。

发布与检查

发布一个 skill 目录:

opensquilla skills publish <path-to-skill>

检查 meta-skill 的已编译 composition:

opensquilla skills inspect <meta-skill-name>

对于普通的 skill 内容,使用:

opensquilla skills view <skill-name>

如何请求一个 Skill

请求结果:

Create a PowerPoint deck summarizing this report.

比下面这种方式更好:

Load the pptx skill and run its script.

当任务与某个 skill 的 description 和 triggers 相匹配时,OpenSquilla 可以从当前目录中选择符合条件的 skills。

内置 Skill 系列

系列示例
Research深度研究、多源搜索、摘要
DocumentsDOCX、PPTX、XLSX、PDF、HTML-to-PDF
Operationscron、GitHub、终端监控、subagents
Memory面向记忆的辅助工具与历史探索
Creationskill creator、skill review、提案辅助

排障

如果某个 skill 未被选中:

  1. 确认它出现在已安装的目录中:

    opensquilla skills list
  2. 检查其 description 和 eligibility:

    opensquilla skills view <skill-name>
  3. 用普通语言描述结果。Skill 名称可以提供帮助,但用户意图仍应清晰。

  4. 如果缺少可选依赖,安装或更新 skill 后重试。

关于组合式 workflows,请阅读 meta-skills.md。完整的 MetaSkill 用户指南请阅读 meta-skill-user-guide.md。编写规则请阅读 ../authoring/meta-skills.md


文档索引 · 产品指南 · 改进此页面 · 报告文档问题

在 GitHub 上编辑此页(英文原稿) OpenSquilla 文档 · 中文社区翻译