The Harness ／公式情報・ツール比較

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

· 執筆: The Harness 編集部
THE HARNESS LAB
GitHubとAIエージェントで安全に開発する方法｜fork…

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

    公式ソース

    関連ガイド

    Academy会員はコピペ実行用プロンプトと演習を開くと、同じ手順をAIへ渡して実機で進められます。