Skip to main content
Skill 是由指令和可选支持文件组成的可复用包。它们让你的团队只需定义一次完成某项任务的可重复方式，便可在 Flowglad 中一致地加以应用。 每个 Skill 都有一个名称、一个斜杠命令 slug、一段描述，以及用 Markdown 编写的指令。支持文件可以提供执行这些指令所需的额外上下文或资源。

​
将 Flowglad 用作团队的 Skill 库

Flowglad 将每个 Skill 保存为带版本的包。发布变更会创建一个新的修订版本，而不是原地替换之前的包。组织管理员可以打开 Skill 的 History，在相应操作可用时检查其修订版本、比较变更、恢复较早的修订版本或丢弃草稿。 这为你的团队提供了一个受管控的地方来维护可复用指令，同时保留在任意时间点处于活跃状态的版本记录。草稿和被拒绝的修订版本不会替换活跃版本。

​
通过 MCP 管理 Skill

连接 Flowglad MCP server 后，agent 可以代你检查和管理组织的 Skill 库：
  • skills.list 返回该连接可见的 Skill。
  • skills.get 返回单个 Skill 的最新修订版本和活跃修订版本元数据。
  • skills.create 提交一个新的 Skill 包。
  • skills.create_candidate 为现有 Skill 提交一个新的修订版本。
  • skills.publish_revision 验证并发布一个延迟的修订版本。
  • skills.create_package_upload_session 和 skills.finalize_package_upload_session 用于传输过大而无法内联发送的包。
  • skills.get 报告已接受请求的验证和提升结果。
创建或更新 Skill 需要团队成员的组织 membership 和 MCP 连接的授权同时具有 skills:write 权限。如果你在连接 server 之后才添加该权限，请重新连接 Flowglad MCP 并授权 skills:write，以便写入工具可用。 权限： 管理员默认拥有 Skill 编写权限。要为 Contributor 授予相同的权限，请打开 Settings → Team，选择该团队成员，然后启用 Skill Authoring。这会授予创建和更新组织 Skill 的权限，而无需将该团队成员设为管理员。

​
将 Flowglad MCP Skill 加载到你的 agent 中

Flowglad MCP server 在 MCP 初始化期间通告 io.modelcontextprotocol/skills。这会告知兼容的客户端该 server 实现了 agent Skill 方法 skills/list 和 skills/get。每个返回的 Skill 都包含 skill:// 资源 URI 和内容摘要；客户端可以使用 resources/read 获取这些文件。 连接 server 并不能保证客户端会调用 skills/list 或安装返回的包。客户端支持情况各不相同。如果你希望 agent 在每次会话开始时刷新 Flowglad 注册表，请向 ChatGPT / Codex 或 Claude 添加启动指令。 MCP 命名： 这些名称是有意区分的。带点的 skills.list 是一个 Flowglad 工具，用于访问组织中带版本的 Skill 记录。带斜杠的 skills/list 是一个 MCP 协议扩展方法，用于发现面向 agent 的 Skill 包。

​
添加启动指令

在开始新会话之前先创建一次目标目录，然后添加下面对应的指令块。

​
ChatGPT / Codex

使用 mkdir -p ~/.agents/skills 创建 ChatGPT / Codex 目标目录。 将以下代码块放入 ~/.codex/AGENTS.md 以应用于所有项目，或放入某个仓库的 AGENTS.md 以与该仓库的团队共享。
AGENTS.md

​
Claude

使用 mkdir -p ~/.claude/skills 创建 Claude 目标目录。 将以下代码块放入 ~/.claude/CLAUDE.md 以应用于所有项目，或放入某个仓库的 CLAUDE.md 以与该仓库的团队共享。
CLAUDE.md
你可以让 ChatGPT / Codex 或 Claude 将相应的代码块添加到其用户级指令文件中。由于该文件会影响之后的会话，请在接受之前审查所提议的修改。该指令是尽力而为的 agent 引导；如果你的环境必须确定性地刷新 Skill，请在受信任的 SessionStart hook 或你的 MCP 客户端集成中实现相同的同步逻辑。

​
Skill 的使用场景

Skill 目前有两类使用方：
  • 兼容的外部 agent 通过 Flowglad MCP 发现并同步已启用的包，然后自动匹配或按名称调用它们。
  • Automation 将某个确切的已发布 Skill 修订版本固定为 OWS skill-revision 代码资源。Automation 选择包路径和入口点；agent 步骤只会收到经密封运行能力集授权的 Skill。
第一种方式为外部 agent 提供可复用的指令。第二种方式为可重复的 Automation 运行提供不可变的代码和支持文件。已发布的 Skill 在整个组织范围内可用，因此获得授权的 Automation 可以在任何 Space 中选择同一个 Skill 修订版本。使用 Skill 的 Automation 及其运行仍归其所在的 Space 所有；选择某个 Skill 不会改变这一边界。

​
创建和维护 Skill

打开 组织菜单 → Skills → New Skill。在 Skill 选项卡中，输入 Name、Slug、可选的 Description，以及 Markdown 格式的可复用指令。使用 Files 选项卡添加任何支持性包文件，然后选择 Create Skill。 Slug 由小写字母、数字和连字符组成，以字母或数字开头，即用户在 / 之后输入的内容。 创建或编辑 Skill 会生成一个草稿。在 Skill 详情页上，编辑内容会自动保存；选择 Publish Draft 以验证并发布草稿。如果验证失败，请根据显示的诊断信息修正草稿并重新发布。 在相应操作可用时，使用 History 检查修订版本、恢复已被取代的修订版本或丢弃可变草稿。Disable Skill 会将其从外部 agent 发现和 Automation 解析中移除，但不会删除修订历史；Enable Skill 可使其重新可用。

​
使用 MCP 创建或编辑 Skill

使用已连接的外部 MCP 客户端进行以包为先的编写。在编辑现有 Skill 之前，先调用 skills.get。对新包使用 skills.create，对基于当前活跃修订版本的新修订版本使用 skills.create_candidate。 小型包可以内联提供。对于较大的包，请调用 skills.create_package_upload_session，上传所请求的对象，最后调用 skills.finalize_package_upload_session。如果验证被延迟，请调用 skills.publish_revision。轮询 skills.get 以获取已接受的生命周期请求及其验证或提升结果。 发布 Skill 不会创建、修订或激活 Automation；需要时请显式使用 Automation MCP 生命周期。

​
从 Skill 模板开始

Skills 页面包含 Skill Templates。搜索或筛选目录，预览模板，然后选择 Copy Skill。副本会成为一个组织 Skill，可以像其他任何 Skill 一样编辑和发布。

​
Skill 与 Automation

Skill 定义如何执行可复用的工作，但并不决定这些工作何时运行。 当工作需要手动运行、按计划运行或响应事件运行时，请使用 Automation。Automation 可以固定一个或多个 Skill 修订版本，以便在多次运行中复用同一实现。