跳转至

专业领域技能包 (Skills)

技能包 (Skills) 是采用 Markdown 格式组织的领域知识指令库，它赋予了智能体专属于特定业务场景的操作规范、代码范式或专业领域知识体系。技能包不仅在引擎启动时被自动扫描加载，而且在每次运行时均会动态热重载，这意味着你对技能文档所做的任何编辑修改无需重启软件即可即刻生效。

Griptape Nodes 出厂即随附了一套专门用于自动搭建、排查与运行工作流的原生技能包；你可以在其并排路径下自由扩充企业私有技能。

技能包物理文件存放目录规范 (Where to put skills)

在当前工作空间物理根目录下创建名为 .agents/skills/ 的文件夹，并为每一个独立的技能包创建一个子文件夹，文件夹内部放置核心定义文件 SKILL.md：

<workspace_directory>/
└── .agents/
    └── skills/
        ├── my-skill/
        │   └── SKILL.md
        └── another-skill/
            └── SKILL.md

系统默认的工作空间目录通常位于启动引擎处的 GriptapeNodes/ 文件夹下。你可以通过顶部菜单 Settings → File System → Workspace Directory 查看你当前确切的物理绝对路径。

技能文件语法格式 (Skill file format)

每一份 SKILL.md 均由顶部的 YAML Frontmatter 元数据块与正文 Markdown 规范组成：

---
name: my-skill-name
description: 阐明该技能的具体用途、适用场景以及智能体何时应当自主激活它。
---

# 技能标题 (Skill title)

此处撰写智能体在该技能被命中激活时应当严格遵循的作业指导、参考资料或特定专业领域知识。
可使用清晰直白的自然语言描述——智能体在运行时会将整篇文档作为高权重上下文进行阅读与理解。
  • name：必须与所在的子文件夹名称严格保持一致；
  • description：向智能体的大模型语义调度器简要说明本技能的解决场景，帮助智能体精准做出激活决策；
  • Markdown 正文：篇幅不受限制——可自由组织代码范例、多步排查手册、参数对照表格等。

实战示范：企业文案规范技能包 (House style guide)

---
name: writing-style
description: 在拟定文案、撰写文档或审阅编辑文本时应用我们团队的统一行文规范。
---

# 企业技术文档撰写规范指南

- 标题统一采用句首大写（Sentence case），切勿全大写。
- 优先选用主动语态，减少冗长的被动句式。
- 杜绝晦涩的内部黑话；专业技术术语在首次出现时必须附带简明释义。
- 单个句子的长度尽量控制在 25 个单词（或 40 个中文字符）以内，保持节奏紧凑。

零重启即时热重载 (Hot reload)

无需重启引擎

技能包系统具备全自动监听能力。只要在 .agents/skills/ 下新建或编辑了技能文档，你在对话面板中发送的下一条消息便会立即享受到最新技能的赋能，开发调试极其顺畅。

扩展学习资源