把OpenCode接入GitHub：让AI助手在Issues和PR里跑起来

作为OpenCode的高级专家，经常有人问：这工具跟GitHub到底怎么配合？能不能像叫同事一样，在评论区喊一声就让AI干活？答案是肯定的。

OpenCode跟GitHub的集成方式其实挺直接——在Issue或PR的评论里提一句/opencode或者/oc，它就会在GitHub Actions的运行环境里把任务给执行了。整个过程不复杂，但有些细节值得拎出来说说。

能干什么活？

先说几个常见的用法场景。

解释问题（Triage issues）：扔一个Issue给OpenCode，让它读一遍整个讨论串，然后给出一份清晰的说明。这对于刚接手项目或者对某块逻辑不熟的时候特别有用。

动手修Bug或开发功能（Fix and implement）：跟它说“把这个修了”，OpenCode会自己切一个新分支，把代码改好，最后提交一个Pull Request。从改代码到提PR，一条龙。

安全性：因为OpenCode跑在GitHub自己的Runner里面，所以访问权限、密钥这些东西都跟着仓库的配置走，不需要额外操心。

怎么装上去？

有两种方式：自动安装和手动配置。

自动安装

在项目根目录（得是一个GitHub仓库）下执行：

opencode github install            

然后跟着提示走——安装GitHub App、创建工作流文件、设置密钥，一路下一步就行。

手动配置

如果喜欢自己动手，也可以分三步来。

第一步：安装GitHub App

浏览器打开 github.com/apps/opencode-agent，确认把它安装到目标仓库上。

第二步：添加工作流

在仓库的.github/workflows/opencode.yml里放一个工作流文件。内容大致如下：

name: opencode            on:            issue_comment:            types: [created]            pull_request_review_comment:            types: [created]            jobs:            opencode:            if: |            contains(github.event.comment.body, '/oc') ||            contains(github.event.comment.body, '/opencode')            runs-on: ubuntu-latest            permissions:            id-token: write            steps:            - name: Checkout repository            uses: actions/checkout@v6            with:            fetch-depth: 1            persist-credentials: false            - name: Run OpenCode            uses: anomalyco/opencode/github@latest            env:            ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}            with:            model: anthropic/claude-sonnet-4-20250514            

注意在env里面把要用到的模型和API密钥配上。

第三步：存储密钥

在组织或者项目的设置页面里，左侧找到“Secrets and variables” → “Actions”，然后把需要的API密钥（比如上面的ANTHROPIC_API_KEY）添加进去。

配置项说明

手动配置的时候，with下面有几个关键参数：

·model（必填）：格式是 provider/model，告诉OpenCode用哪个模型。

·agent（可选）：指定用哪个主代理。如果不填，就回落到配置文件里的default_agent，再找不到就用"build"。

·share（可选）：是否共享OpenCode会话。对于公开仓库，默认是true。

·prompt（可选）：自定义的提示词，可以覆盖默认行为。比如定制OpenCode处理请求的方式。

·token（可选）：GitHub访问令牌，用来创建评论、提交变更、发起PR等操作。默认情况下OpenCode会用自己App的安装令牌，所以提交、评论和PR都显示为来自这个App。

如果不打算安装OpenCode的GitHub App，也可以直接用GitHub Action自带的GITHUB_TOKEN。不过需要确保工作流里有对应的权限：

permissions:            id-token: write            contents: write            pull-requests: write            issues: write            

当然，用个人访问令牌（PAT）也是可以的。

支持哪些事件触发？

OpenCode可以响应多种GitHub事件，下面这个表格说得比较清楚：

几个典型的场景示例

定时任务

比如每周一上午9点跑一次，扫一下代码里所有的TODO注释，然后汇总成摘要。如果发现值得处理的问题，就开一个Issue来跟踪。

工作流文件大概长这样：

name: Scheduled OpenCode Task            on:            schedule:            - cron: "0 9 * * 1"            jobs:            opencode:            runs-on: ubuntu-latest            permissions:            id-token: write            contents: write            pull-requests: write            issues: write            steps:            - name: Checkout repository            uses: actions/checkout@v6            with:            persist-credentials: false            - name: Run OpenCode            uses: anomalyco/opencode/github@latest            env:            ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}            with:            model: anthropic/claude-sonnet-4-20250514            prompt: |            Review the codebase for any TODO comments and create a summary.            If you find issues worth addressing, open an issue to track them.            

定时事件因为没有评论来提取指令，所以prompt是必填的。另外，这种定时工作流运行的时候没有用户上下文来做权限校验，所以工作流必须自己配上contents: write和pull-requests: write，才能让OpenCode去创建分支或PR。

PR自动审查

每次PR被打开、更新、重新打开或者变成“ready for review”状态时，自动跑一遍审查：

name: opencode-review            on:            pull_request:            types: [opened, synchronize, reopened, ready_for_review]            jobs:            review:            runs-on: ubuntu-latest            permissions:            id-token: write            contents: read            pull-requests: read            issues: read            steps:            - uses: actions/checkout@v6            with:            persist-credentials: false            - uses: anomalyco/opencode/github@latest            env:            ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}            GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}            with:            model: anthropic/claude-sonnet-4-20250514            use_github_token: true            prompt: |            Review this pull request:            - Check for code quality issues            - Look for potential bugs            - Suggest improvements            

对于pull_request事件，如果没有提供prompt，OpenCode默认就会去审查这个PR。

Issue自动分流（Triage）

比如新开了一个Issue，先检查提Issue的账号注册时间是否超过30天——这样可以过滤掉一部分垃圾信息。满足条件再让OpenCode去处理：

name: Issue Triage            on:            issues:            types: [opened]            jobs:            triage:            runs-on: ubuntu-latest            permissions:            id-token: write            contents: write            pull-requests: write            issues: write            steps:            - name: Check account age            id: check            uses: actions/github-script@v7            with:            script: |            const user = await github.rest.users.getByUsername({            username: context.payload.issue.user.login            });            const created = new Date(user.data.created_at);            const days = (Date.now() - created) / (1000 * 60 * 60 * 24);            return days >= 30;            result-encoding: string            - uses: actions/checkout@v6            if: steps.check.outputs.result == 'true'            with:            persist-credentials: false            - uses: anomalyco/opencode/github@latest            if: steps.check.outputs.result == 'true'            env:            ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}            with:            model: anthropic/claude-sonnet-4-20250514            prompt: |            Review this issue. If there's a clear fix or relevant docs:            - Provide documentation links            - Add error handling guidance for code examples            Otherwise, do not comment.            

注意，对于issues事件，因为没有现成的评论来提取指令，所以prompt也是必填的。

自定义提示词

有时候默认的行为不满足需求，可以通过prompt覆盖掉。比如在PR审查时可以强制要求检查某些特定内容：

- uses: anomalyco/opencode/github@latest            with:            model: anthropic/claude-sonnet-4-5            prompt: |            Review this pull request:            - Check for code quality issues            - Look for potential bugs            - Suggest improvements            

这样做的好处是可以针对项目的具体规范来定制审查标准，比如要求检查测试覆盖率、特定的代码风格、日志规范等等。

日常使用小例子

说几个最常用的操作。

解释一个Issue：直接在GitHub Issue下面留一条评论：

/opencode explain this issue            

OpenCode会把整个讨论串（包括所有评论）从头到尾读一遍，然后回复一段清晰的解释。

修复一个Issue：在Issue里说：

/opencode fix this            

然后OpenCode会创建一个新分支，把该改的代码改好，最后自动提交一个PR。

审查PR并顺手改点东西：在PR下面写一条评论，比如：

Delete the attachment from S3 when the note is removed /oc            

OpenCode就会按要求实现这个修改，并把改动提交到同一个PR里。

针对某几行代码进行审查：在PR的“Files”标签页里，直接在代码行上留评论。OpenCode会自动识别出文件路径、具体的代码行、周围的diff上下文和行号信息。这时候只要写：

/oc add error handling here            

就不用手动再重复一遍文件路径和行号了，非常方便。

小结

整体上，OpenCode跟GitHub的集成覆盖了从Issue解释、Bug修复到PR审查、定时维护的常见场景。配置起来并不复杂——要么一行命令装完，要么手动加个工作流文件再配好密钥。对于日常开发来说，相当于在代码托管平台里养了一个随时可以调用的AI助手。