「このIssue、誰かに投げられないか」と思った際に、人間だと「この人今タスク大丈夫かな・・・?」とか「こんなことお願いして大丈夫かな?」と思うことがある。
仕様は固まっている。変更範囲も狭い。軽微と言える修正。でも手を動かすのが億劫なタスク。それをいちいち手を止めてどうしようか・・・と考えるのは結構なストレスになると思う。
今回整理するのは、LinearのIssue担当者をCodex用のBotに変えるだけで、実装からPRまで自動で流れる仕組みだ。特別なインフラは不要。Linearが一番初期設定が楽だが、他のツールでも工夫すれば作れるはずなので、ぜひ参考にしてみなさんのタスクツール上でもAIと連携できる仕組みを構築してみてほしい。
ちなみにこのタスク、codexが対処できるものであればなんでも対応できるのでかなり汎用性が高い。今後はCloude CodeやGeminiでも似たようなことができる(今も手間はかかるが実現可能)ようになるので、テキスト修正やデザイン修正など、人間の担当者のように役割をアサインできるようになるだろう。そうなるといよいよ企業の中で人間と同じようにAIが働く、というのが現実の世界としてやってくると言える。今回はそれを一足先に体験してもらうというのも狙いだ。
Linearの担当をCodexに変えたら、PRまで自動で進む仕組みを作る
全体像を先に把握する
構成は6ステップで、順番に並べるとこうなる。

見た目は複雑に映るが、やっていることはバトンを渡しているだけだ。それぞれのレイヤーは独立していて、どこかで止めても問題ない。運用しやすい形に調整してもらえれば。
なぜこの3つを選ぶのか
冒頭で申し上げたが、今回はLinear、GitHub、Codexの組み合わせをご紹介する。これは一番構築が手っ取り早いからだ。
Linearのwebhookは「何が変わったか」を教えてくれる
LinearはIssueが更新されるたびにHTTPS POST通知を送る。ここで重要なのが、`updatedFrom`フィールドだ。
"We'll also let you know what the previous values for all changed properties were."
たとえば担当者が変わったとき、payloadには以下のような構造が含まれる。
{
"action": "update",
"type": "Issue",
"data": {
"assigneeId": "codex-bot-id"
},
"updatedFrom": {
"assigneeId": "previous-user-id"
}
}
`data.assigneeId`が新しい担当者、`updatedFrom.assigneeId`が変更前の担当者。
この差分を見ることで、「Codex Botが新しく割り当てられた瞬間だけ」に限定したトリガーが作れる。
GitHubのrepository_dispatchが外部からのキックに対応している
GitHub Actionsには`repository_dispatch`というトリガーがある。外部からHTTP POSTを受け取って、特定のworkflowを起動できる仕組みだ。
"The trigger is called repository_dispatch and you can limit the scope to only specific webhooks with a type."
Webhook受信サーバーからのリクエストはこんな形になる。
curl -X POST \
-H "Authorization: token YOUR_GITHUB_TOKEN" \
-H "Accept: application/vnd.github.v3+json" \
https://api.github.com/repos/{owner}/{repo}/dispatches \
-d '{
"event_type": "linear-codex-assigned",
"client_payload": {
"issue_title": "ユーザー認証APIの実装",
"issue_body": "...",
"issue_identifier": "ENG-123"
}
}'
Linearのwebhookを受け取ったサーバーが、このcurlを叩く。それだけでGitHub Actionsが動き出す。
Codexは「実装」と「レビュー」を分けて使える
Codexには2つの使い方がある。
`openai/codex-action`をGitHub Actionsで動かして実装させる
PRができた後にGitHubのレビュー機能としてコードレビューさせる
"Automate Codex feedback on pull requests or releases without managing the CLI yourself."
この2つを別のworkflowとして設計できるのが、Codexの大きな強みだ。実装担当のCodexと、レビュー担当のCodexを、同じツールでも役割として分離できる。ひとり二役より、役割ごとに担当を変えたほうがミスが見えやすい。これは人間でも同じだ。
実装の中身
Step 1:Webhook受信サーバー
Node.jsで書く場合、こんな構造になる。
app.post('/webhook/linear', async (req, res) => {
// Linearのシグネチャ検証
const signature = createHmac('sha256', process.env.WEBHOOK_SECRET)
.update(JSON.stringify(req.body))
.digest('hex');
if (signature !== req.headers['linear-signature']) {
return res.status(400).send('Invalid signature');
}
const { action, type, data, updatedFrom } = req.body;
// ここが肝:「担当者がCodex Botに変わった瞬間だけ」を検出
const CODEX_BOT_ID = process.env.CODEX_BOT_USER_ID;
const isAssignedToCodex =
type === 'Issue' &&
action === 'update' &&
data.assigneeId === CODEX_BOT_ID &&
updatedFrom?.assigneeId !== CODEX_BOT_ID; // 変更前はCodexじゃなかった
if (!isAssignedToCodex) {
return res.status(200).json({ skipped: true });
}
// GitHub Actionsをキック
await triggerGitHubAction({
issue_title: data.title,
issue_body: data.description,
issue_identifier: data.identifier,
});
res.status(200).json({ triggered: true });
});
`updatedFrom.assigneeId !== CODEX_BOT_ID`の条件が二重起動を防ぐ。
Linearはコメント追加やラベル変更でも通知を飛ばしてくるので、ここを省くと同じIssueでCodexが何度も走り出す。
Step 2:GitHub Actionsのworkflow
`.github/workflows/codex-implement.yml`に書く。
name: Codex Auto Implementation
on:
repository_dispatch:
types: [linear-codex-assigned]
jobs:
implement:
runs-on: ubuntu-latest
permissions:
contents: write
pull-requests: write
steps:
- uses: actions/checkout@v5
- name: Run Codex implementation
uses: openai/codex-action@v1
with:
openai-api-key: ${{ secrets.OPENAI_API_KEY }}
prompt: |
以下のIssueを実装してください。
タイトル: ${{ github.event.client_payload.issue_title }}
説明: ${{ github.event.client_payload.issue_body }}
識別子: ${{ github.event.client_payload.issue_identifier }}
- テストも必ず書くこと
- 既存のコードスタイルに合わせること
safety-strategy: drop-sudo
sandbox: workspace-write
- name: Create Pull Request
uses: peter-evans/create-pull-request@v6
with:
token: ${{ github.token }}
title: "[${{ github.event.client_payload.issue_identifier }}] ${{ github.event.client_payload.issue_title }}"
body: |
Linear Issue: ${{ github.event.client_payload.issue_identifier }}
Codexによる自動実装。レビューをお願いします。
branch: "codex/${{ github.event.client_payload.issue_identifier }}"
reviewers: "your-team-reviewer" # 人間レビュアーを必須でアサイン
`reviewers`に人間のレビュアーを設定することを忘れない。自動化しながら、責任の所在だけは手放さないのが安全な運用の基本だ。
Step 3:Codexのレビューworkflow
PRが作られた後は、別のworkflowでCodexにレビューさせる。実装とレビューを別のjobに分けることで、どちらかが失敗しても他方に影響しない。
name: Codex PR Review
on:
pull_request:
types: [opened, synchronize, reopened]
jobs:
review:
runs-on: ubuntu-latest
permissions:
contents: read
pull-requests: write
steps:
- uses: actions/checkout@v5
with:
ref: refs/pull/${{ github.event.pull_request.number }}/merge
- name: Pre-fetch refs
run: |
git fetch --no-tags origin \
${{ github.event.pull_request.base.ref }} \
+refs/pull/${{ github.event.pull_request.number }}/head
- name: Run Codex review
id: run_codex
uses: openai/codex-action@v1
with:
openai-api-key: ${{ secrets.OPENAI_API_KEY }}
prompt-file: .github/codex/prompts/review.md
output-file: codex-review.md
safety-strategy: drop-sudo
sandbox: read-only
- name: Post review comment
uses: actions/github-script@v7
with:
github-token: ${{ github.token }}
script: |
const fs = require('fs');
const review = fs.readFileSync('codex-review.md', 'utf8');
await github.rest.issues.createComment({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: context.issue.number,
body: `## Codex Auto Review\n\n${review}`
});
"The sample workflow below reviews new pull requests, captures Codex's response, and posts it back on the PR."
Step 4:AGENTS.mdでレビュー基準を固定する
レビューが毎回ぶれる問題は、`AGENTS.md`を置くことで解決できる。
"Codex searches your repository for AGENTS.md files and follows any Review guidelines you include."
リポジトリルートに置くと、Codexはタスク開始前に必ずこのファイルを読む。
## Review guidelines
- PII(個人情報)のログ出力を禁止する
- すべてのAPIエンドポイントに認証ミドルウェアが適用されているか確認する
- テストカバレッジが下がるような変更をP0として扱う
- 型定義が不明瞭なコードをP1として指摘する
## Implementation guidelines
- `npm test`を必ず実行してからコミットする
- 既存の命名規則に従うこと
- 新しい外部依存を追加する前に確認を求めること
"Codex applies guidance from the closest AGENTS.md to each changed file."
ディレクトリ階層に合わせてファイルを分散配置することもできる。パッケージごとに違う基準を持ちたい場合に便利だ。
ハマりやすい4つのポイント
1. 二重起動
冒頭のコード例で示したように、`updatedFrom`との差分チェックを必ず入れること。Linearは担当者変更以外でも通知を飛ばす。コメント追加、ラベル変更、ステータス更新、すべてにwebhookが走る。条件を絞らないと、同じIssueでCodexが何度も起動する。
2. Issueの粒度
Codexに渡すIssueの本文がふくらみすぎると、実装範囲が曖昧になる。「1 Issue 1責務」に寄せること。「ユーザー認証周りをリファクタしてほしい」は渡せない。「`/api/users`エンドポイントのJWTバリデーションを`auth.middleware.ts`に分離する」なら渡せる。
これはAI相手に限らず、人間でも同じだ。ただ、人間は「だいたいわかった」で動けてしまうのに対し、Codexは文脈の補完に限界がある。この部分は人間側が学ばなければいかない部分であり、大変な部分ではあるが、AIで楽になる分、こういう学びを積み重ねることがスキルアップにもつながるのでぜひ挑戦してほしい。
3. セキュリティ設定
`openai/codex-action`には`safety-strategy`の設定がある。
"drop-sudo — Drops sudo permissions after setup, so Codex cannot access its own OpenAI API key."
パブリックリポジトリで使う場合は`drop-sudo`を必ず設定すること。設定しないと、CodexがAPIキーを読み取れる状態になる。APIキーが読み取れる状態は今一番多いセキュリティミスと言えるので、ここは必ず丁寧に。
4. レビュー担当者の明示
PRを自動作成しただけでは「誰が最後に見届けるか」が曖昧になる。`create-pull-request`の`reviewers`フィールドに人間のレビュアーを必ず指定すること。Codexレビューはあくまで一次チェックで、承認権限は人間が持つ。これを省いてしまうと、自動化したはずのPRが結局押し付け合いになる。人間が確認するのは最終確認だけなので、ここはちゃんとやろう。
段階的に始めるおすすめの進め方
最初からフル自動実装に行く必要はない。むしろ、最初から全部つなごうとすると、どこで失敗したか追いにくくなるし、時間もかかる。順番にやっていくことがコツ。
Phase 1(Webhook + Issue作成のみ)
Linear担当変更 → Webhook受信 → GitHub Issueの雛形作成 → 人が実装
Webhookが正しく動いているかを確認するだけの段階。GitHub Issueにタイトルと説明が飛んでくるだけでも、手間は減る。
Phase 2(Codex実装 + 人レビュー)
Linear担当変更 → Webhook → Codex実装 → PR作成 → 人がレビュー・承認
ここで初めてCodexに手を動かさせる。Codexが作ったPRを人間がちゃんとレビューできる状態を確保してから次に進む。
Phase 3(Codexレビュー + 人が最終承認)
Linear担当変更 → Webhook → Codex実装 → PR作成 → Codexレビュー → 人が最終承認 → Slack通知
Codexが一次レビューまで担う。人間は最終承認だけでよくなる。
📌 ここに図を入れる(3フェーズの段階図)
Phase 2で一度踏みしめてからPhase 3に進んだほうがいい。自動化は、成功の速度より失敗の見え方のほうが大事だったりする。何かがおかしくなったとき、どのレイヤーで止まっているかわかるか。それが設計の肝だ。
まとめ
この仕組みの構造はシンプル。
Linear → Webhookで開始条件を作る(`updatedFrom`で差分を取る)
Webhook受信サーバー → 条件判定してGitHub Actionsをキック
GitHub Actions → Codexを実行、PRを作成
Codex → 実装担当と、レビュー担当を別のjobで役割分担
AGENTS.md → レビュー基準を固定し、毎回ぶれないようにする
人間 → 最終承認と、責任の所在を持ち続ける
うまくハマると「小さな定型開発」は本当に一段軽くなる。全部自動にするより、人間が判断すべき場所を守りながら、それ以外を委ねる。そのバランスをどこに引くかを探るのがとても大事だが、それはしばらくの自分のテーマでもある・・・汗
今回は少し難解な解説が多くなってしまったので、ご要望いただければ、無償で勉強会を実施したいと思う。ご希望あればぜひ下記Contactより、問い合わせカテゴリ「その他」を選び「勉強会希望」と送っていただければ後日開催のお知らせをお送りさせていただきたいと思うのでぜひ。
参考リンク
Linear Docs / Webhooks:https://linear.app/developers/webhooks
Linear Docs / API and Webhooks:https://linear.app/docs/api-and-webhooks
OpenAI / Introducing Codex:https://openai.com/index/introducing-codex/
OpenAI / Codex GitHub Action:https://developers.openai.com/codex/github-action/
OpenAI / codex-action(GitHub):https://github.com/openai/codex-action
OpenAI / Custom instructions with AGENTS.md:https://developers.openai.com/codex/guides/agents-md/
OpenAI / Use Codex in GitHub(レビュー設定):https://developers.openai.com/codex/integrations/github/
GitHub Docs / repository_dispatch:https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows
Linear webhook payload examples:https://inventivehq.com/blog/linear-webhooks-guide
