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-issue 和 issue-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 管理的日常开发场景。