GitHubとAIエージェントで安全に開発する方法｜fork・clone・小さなPR

forkとclone、実装調査、変更の分割まで、AIエージェントとGitHubで作業を戻せる単位に保つ基本手順です。 GitHub CLIでforkを作り、originとupstreamを自動設定します。 READMEだけでなく、package.json、CLI、Wrangler、migrationを根拠に作業させます。 1目的1branch・1PRでAIに実装させます。

この記事はHarness Academyの教材データを基に、各Harnessの公式リポジトリにある実装箇所と照合して構成しています。秘密情報や本番データを記事・AIチャットへ貼らず、外部送信は必ず検証対象を限定してください。

最初に確認すること

• forkとcloneをAIに任せる: 自分の改造を保存でき、本家更新も受け取れる構成にする
• リポジトリの実装をAIに読ませる: 古いブログ記事や推測のコマンドを使わない
• 変更を戻せる単位に分ける: 本家更新や不具合時に自社変更だけを切り離せるようにする

forkとcloneをAIに任せる

GitHub CLIでforkを作り、originとupstreamを自動設定します。

この工程のゴール: 自分の改造を保存でき、本家更新も受け取れる構成にする

forkはGitHub上の自分用コピー、cloneはMac上の作業コピーです。originは自分のfork、upstreamはShudesu本家に固定します。

公式CLIだけで導入する場合はfork不要です。カスタマイズする人だけ、この章のfork構成を作ります。

手順

1. 対象を決める

LINEまたはIGのどちらを改造するか決めます。

2. AIへforkを依頼

下のプロンプトの【対象】だけ置き換えます。

3. 向きを確認

git remote -vとdefault branchをAIに報告させます。

完了条件

• originが自分のGitHub URL
• upstreamがShudesuの本家URL
• 作業branch上でgit statusがclean

Academy教材: GitHubと作業コピーを整える / Lesson 2-1

リポジトリの実装をAIに読ませる

READMEだけでなく、package.json、CLI、Wrangler、migrationを根拠に作業させます。

この工程のゴール: 古いブログ記事や推測のコマンドを使わない

Harnessは更新が速いため、READMEだけではなく実際のpackage.jsonとセットアップCLIが正解です。

LINEは公式release bundleとmanifestを使い、リポジトリを対象releaseへ固定します。IGは保存済みdeployed stateを使ってupdateします。教材内の固定versionではなく、作業時に本家と稼働環境を読み直します。

手順

1. 構造を読む

apps、packages、scripts、.github/workflowsの役割を抽出します。

2. 入口を特定

setup、update、build、test、deployの実コマンドをpackage.jsonから取得します。

3. 調査メモを作る

作業で使うファイルだけを一覧化します。

完了条件

• setup/updateの実コマンドがpackage.jsonと一致する
• Worker・Pages・D1・R2・Cronの関係が分かる
• 根拠ファイルが示される

Academy教材: GitHubと作業コピーを整える / Lesson 2-2

変更を戻せる単位に分ける

1目的1branch・1PRでAIに実装させます。

この工程のゴール: 本家更新や不具合時に自社変更だけを切り離せるようにする

画面変更、DB変更、配信ロジック変更を一つのcommitへ混ぜると、upstream更新時の衝突が増えます。

AIには最初に変更範囲と完了条件を出させ、commit前にdiffをレビューさせます。

手順

1. branch作成

feature/短い目的名を作ります。

2. 小さく実装

一つの目的だけを変更します。

3. PRを作成

テスト結果とrollback方法を本文へ入れます。

完了条件

• 変更が一つの目的に限定される
• migrationとrollbackの要否が先に分かる
• PR本文にテスト結果が入る

Academy教材: GitHubと作業コピーを整える / Lesson 2-3

公式ソース

• L Harness GitHub — LINE本家
• IG Harness GitHub — IG本家
• L Harness / packages/create-line-harness/src/index.ts — LINE CLI入口
• IG Harness / packages/create-ig-harness/src/index.ts — IG CLI入口
• L Harness / .github/workflows/worker-ci.yml — LINEのPR検査
• IG Harness / CONTRIBUTING.md — IGの開発ルール

関連ガイド

• Harnessシリーズ公式ガイド索引
• /about/