跳转到内容
案例 生态 源码解读 文档

构建自定义 Skill 工作流

把可重复的多步骤工作流封装成 OpenCode Skill，让智能体按需运行。Skills 让你把最佳实践编码成可复用、可触发的流程。

何时使用此案例

  • 反复运行同一个多步骤工作流。
  • 希望智能体每次都遵循团队的确切流程。
  • 想在项目或队友间共享一个工作流。

前置配置

  • 已安装 OpenCode。
  • 一个能拆解为离散步骤的工作流。

步骤

  1. 拆解你的工作流

    把手工执行的步骤写下来，这就成为 Skill 的主体。

    • 阅读该 issue
    • 本地复现
    • 写一个失败的测试
    • 实现修复
    • 验证并开启 PR 草稿

  2. 创建 skill 文件

    在你的 skills 目录中按 skill 格式放置 SKILL.md。

    # Fix-and-PR

## When to use
Use when asked to fix a GitHub issue end to end.

## Steps
1. Read the issue and summarize the problem.
2. Reproduce it locally with a test.
3. Implement the minimal fix.
4. Run the full test suite.
5. Open a draft PR with a summary referencing the issue.

  3. 定义触发条件

    说明 Skill 何时激活，让智能体在合适时机调用。

  4. 测试 skill

    用一个真实 issue 触发它，观察每一步执行。

  5. 迭代

    调整措辞，直到智能体无需额外提示就能可靠遵循每一步。

关键提示词

我有一个反复出现的工作流：处理一个 GitHub issue、复现、修复、测试，然后开 PR。写一个 SKILL.md 把它编码下来，这样我给你一个 issue 编号你就能跑完整个流程。

常见坑点

  • 触发条件过宽：如果触发太松，Skill 会在不想要时启动。把”When to use”收紧。
  • 隐含步骤：智能体会跳过任何没写下来的步骤。每一步都要写明，包括验证。
  • 跳过测试阶段：始终包含一个”验证”步骤，否则 Skill 可能交付不完整的工作。

相关文档

  • Skills — 完整的 Skills 参考与编写格式
  • 命令 — 为可重复操作定义自定义斜杠命令

相关案例

相关文档

下一步