OpenCode 支持通过 SKILL.md 标准格式加载 agent skills,社区已经积累了一批现成的 GitHub Issue skill。本文记录选型考量、安装步骤和基本用法。

可选方案 链接到标题

社区中几个主流选择:

Skill 来源 特点
gh-issue latitude-dev/latitude-llm 单文件,专注 issue 创建,LLM 友好格式
github-cli doug-skinner 全功能 gh 套件,覆盖 PR/workflow/release
issue-management constellos 完整 CRUD + 模板
make-issue rvanbaalen 智能创建,自动 label 推荐
gh-issues OpenClaw 官方 issue→PR 自动化流水线

为何选 gh-issue 链接到标题

  • 单文件:只有 SKILL.md,无脚本、无子文档,安装即用
  • 聚焦:只做 issue 创建一件事,不混入 PR/workflow 等逻辑
  • 结构规范:强调 issue 供 LLM 消费,模板包含 Problem / Impact / Solution / Acceptance Criteria
  • 兼容性:标准 SKILL.md 格式,OpenCode、Claude Code、Cursor 通用

其他方案各有特色。github-cli 功能最全但体积大;gh-issues(OpenClaw)能力最强但属于 OpenClaw 生态;make-issueissue-management 侧重不同场景。如果需要完整的 issue→fix→PR 自动化,推荐 OpenClaw 官方的 gh-issues。

安装 链接到标题

OpenCode 自动扫描以下几个位置加载 skills:

  • ~/.config/opencode/skills/<name>/SKILL.md
  • ~/.claude/skills/<name>/SKILL.md
  • ~/.agents/skills/<name>/SKILL.md
# 创建目录
mkdir -p ~/.agents/skills/gh-issue

# 下载 SKILL.md
curl -o ~/.agents/skills/gh-issue/SKILL.md \
  https://raw.githubusercontent.com/latitude-dev/latitude-llm/main/.agents/skills/gh-issue/SKILL.md

# 重启 opencode 使 skill 生效

重启后可用 opencode debug skill 验证:

opencode debug skill --print-logs --log-level DEBUG
# 输出应包含 count=1 及 gh-issue 条目

基本用法 链接到标题

安装后 agent 会自动在 <available_skills> 中看到 gh-issue。在对话中自然描述需求即可触发,例如:

给这个仓库创建一个 issue,描述 API 限流的问题

agent 会按 skill 指导的结构化流程执行 gh issue create,始终附带 llm label,并按模板组织 issue 正文。

支持的场景:

  • Bug:描述问题、影响范围、复现步骤
  • Feature:新功能需求、预期行为
  • Tech-debt:重构、清理、安全修复
  • Schema 变更:数据库迁移等

总结 链接到标题

社区 skill 生态已经成熟,直接复用现成 SKILL.md 即可给 OpenCode 增加 GitHub Issue 能力。gh-issue 轻量聚焦,适合需要结构化 issue 管理的日常开发场景。