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 | 深度研究、多源搜索、摘要 |
| Documents | DOCX、PPTX、XLSX、PDF、HTML-to-PDF |
| Operations | cron、GitHub、终端监控、subagents |
| Memory | 面向记忆的辅助工具与历史探索 |
| Creation | skill creator、skill review、提案辅助 |
排障
如果某个 skill 未被选中:
-
确认它出现在已安装的目录中:
opensquilla skills list -
检查其 description 和 eligibility:
opensquilla skills view <skill-name> -
用普通语言描述结果。Skill 名称可以提供帮助,但用户意图仍应清晰。
-
如果缺少可选依赖,安装或更新 skill 后重试。
关于组合式 workflows,请阅读 meta-skills.md。完整的 MetaSkill 用户指南请阅读 meta-skill-user-guide.md。编写规则请阅读 ../authoring/meta-skills.md。