<?xml version="1.0" encoding="utf-8"?><?xml-stylesheet type="text/xsl" href="rss.xsl"?>
<rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/">
    <channel>
        <title>sawara.me Blog</title>
        <link>https://sawara.me/ko/blog</link>
        <description>sawara.me Blog</description>
        <lastBuildDate>Sun, 15 Nov 2026 00:00:00 GMT</lastBuildDate>
        <docs>https://validator.w3.org/feed/docs/rss2.html</docs>
        <generator>https://github.com/jpmonette/feed</generator>
        <language>ko</language>
        <item>
            <title><![CDATA[SwiftPM製macOSアプリをDeveloper ID署名・Apple公証してHomebrew Tapへ自動公開する]]></title>
            <link>https://sawara.me/ko/blog/macos-app-notarization-homebrew-release</link>
            <guid>https://sawara.me/ko/blog/macos-app-notarization-homebrew-release</guid>
            <pubDate>Sun, 15 Nov 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[macOS 向けのネイティブアプリケーションを App Store を経由せず GitHub Releases や Homebrew で配布する場合、適切なコード署名と Apple による公証（Notarization）を行わなければ、利用者の環境で Gatekeeper による警告（「開発元を検証できないため開けません」など）が表示されてしまいます。]]></description>
            <content:encoded><![CDATA[<p>macOS 向けのネイティブアプリケーションを App Store を経由せず GitHub Releases や Homebrew で配布する場合、適切なコード署名と Apple による公証（Notarization）を行わなければ、利用者の環境で Gatekeeper による警告（「開発元を検証できないため開けません」など）が表示されてしまいます。</p>
<p>また、手元の Mac で毎回アーカイブの作成、署名、<code>notarytool</code> による公証申請、Staple（公証チケットの埋め込み）、そして Homebrew Tap リポジトリの更新を手作業で繰り返すと、作業の負担が大きいだけでなく手順漏れなどのヒューマンエラーも起きやすくなります。</p>
<p>今回 <a href="https://github.com/sawarame/Wintch" target="_blank" rel="noopener noreferrer" class="">Wintch</a> という Swift Package Manager（SwiftPM）製の macOS アプリを作成し、その中で Developer ID 署名・Apple 公証・Staple 付きのビルドから GitHub Releases 公開、自作の Homebrew Tap（<code>sawarame/homebrew-tap</code>）更新までを GitHub Actions で自動化する仕組みを実践しましたので、その手順を紹介します。</p>
<a class="linkCard_fEEo" href="https://sawara.me/ko/wintch"><div class="emojiWrapper_T8JQ"><span>🪟</span></div><div class="content_cWRx"><div class="title_KDn0">Wintch — macOS 向けウィンドウ単位スイッチャー＆検索ランチャー</div><div class="description_qJNw">今回自動リリース環境を構築したアプリの紹介・インストールページです。</div></div></a>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="自動リリースパイプラインの全体像">自動リリースパイプラインの全体像<a href="https://sawara.me/ko/blog/macos-app-notarization-homebrew-release#%E8%87%AA%E5%8B%95%E3%83%AA%E3%83%AA%E3%83%BC%E3%82%B9%E3%83%91%E3%82%A4%E3%83%97%E3%83%A9%E3%82%A4%E3%83%B3%E3%81%AE%E5%85%A8%E4%BD%93%E5%83%8F" class="hash-link" aria-label="自動リリースパイプラインの全体像에 대한 직접 링크" title="自動リリースパイプラインの全体像에 대한 직접 링크" translate="no">​</a></h2>
<p>本記事で構築するリリース自動化パイプラインは、リポジトリの <code>VERSION</code> ファイル更新（または手動実行・タグ push）を起点として、テストから Homebrew Tap の更新までを一貫して実行します。</p>
<ol>
<li class=""><strong>検証とタグ作成（<code>prepare</code> ジョブ）</strong>: <code>VERSION</code> の SemVer 形式チェックと <code>swift test</code> を実行し、タグ（<code>vX.Y.Z</code>）を自動作成・push する</li>
<li class=""><strong>証明書復元</strong>: ランナー内の一時キーチェーンへ Developer ID 証明書をインポートする</li>
<li class=""><strong>ビルドと署名</strong>: <code>scripts/build-app.sh</code> で Universal Binary（<code>arm64</code> + <code>x86_64</code>）の <code>.app</code> をビルドし、Hardened Runtime 付きで署名する</li>
<li class=""><strong>公証と Staple</strong>: <code>xcrun notarytool</code> で Apple 公証サーバーへ提出・完了待機したあと、<code>xcrun stapler</code> で公証チケットを添付し <code>spctl</code> で検証する</li>
<li class=""><strong>GitHub Releases 公開</strong>: 公証済み ZIP と SHA256 を生成し、GitHub Releases を作成・公開する</li>
<li class=""><strong>Homebrew Tap 更新</strong>: <code>homebrew-tap</code> リポジトリの Cask ファイル（<code>version</code> / <code>sha256</code>）を自動で書き換えて push する</li>
</ol>
<p>以降の手順では、初回のみ必要な証明書・キー・リポジトリの準備から、ワークフローの実装・日常運用まで順に見ていきます。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="前提とするプロジェクト構成">前提とするプロジェクト構成<a href="https://sawara.me/ko/blog/macos-app-notarization-homebrew-release#%E5%89%8D%E6%8F%90%E3%81%A8%E3%81%99%E3%82%8B%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%EF%BF%BD%E3%82%AF%E3%83%88%E6%A7%8B%E6%88%90" class="hash-link" aria-label="前提とするプロジェクト構成에 대한 직접 링크" title="前提とするプロジェクト構成에 대한 직접 링크" translate="no">​</a></h2>
<p>実例となる <a href="https://github.com/sawarame/Wintch" target="_blank" rel="noopener noreferrer" class="">Wintch</a> は、Xcode のプロジェクトファイル（<code>.xcodeproj</code>）を持たず、SwiftPM（<code>Package.swift</code>）とシェルスクリプト（<code>scripts/build-app.sh</code>）で <code>.app</code> バンドルを組み立てる構成を採用しています。</p>
<ul>
<li class=""><strong>ビルド方式</strong>: SwiftPM（<code>Package.swift</code>）および <code>scripts/build-app.sh</code></li>
<li class=""><strong>Bundle ID</strong>: <code>dev.wintch.Wintch</code>（<code>Resources/Info.plist</code> で定義）</li>
<li class=""><strong>最小対応 OS</strong>: macOS 14.0 Sonoma 以降（<code>LSMinimumSystemVersion</code> = <code>14.0</code>）</li>
<li class=""><strong>App Sandbox</strong>: オフ（ウィンドウ操作用 API である <code>AXUIElement</code> や <code>CGEventTap</code>、<code>SMAppService.mainApp</code> を使用するため）</li>
<li class=""><strong>Hardened Runtime</strong>: リリースビルド時に <code>codesign --options runtime</code> で有効化</li>
</ul>
<div class="theme-admonition theme-admonition-info admonition_xJq3 alert alert--info"><div class="admonitionHeading_Gvgb"><span class="admonitionIcon_Rf37"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M7 2.3c3.14 0 5.7 2.56 5.7 5.7s-2.56 5.7-5.7 5.7A5.71 5.71 0 0 1 1.3 8c0-3.14 2.56-5.7 5.7-5.7zM7 1C3.14 1 0 4.14 0 8s3.14 7 7 7 7-3.14 7-7-3.14-7-7-7zm1 3H6v5h2V4zm0 6H6v2h2v-2z"></path></svg></span>.xcodeproj を使わない構成での署名について</div><div class="admonitionContent_BuS1"><p><code>.xcodeproj</code> が存在しない構成では、Xcode GUI の「Signing &amp; Capabilities」や <code>xcodebuild archive</code> ではなく、<code>scripts/build-app.sh</code> 内の <code>codesign</code> コマンドと GitHub Actions ワークフロー（<code>.github/workflows/release.yml</code>）側で署名・公証を制御します。</p></div></div>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="developer-id-application-証明書の作成とエクスポート">Developer ID Application 証明書の作成とエクスポート<a href="https://sawara.me/ko/blog/macos-app-notarization-homebrew-release#developer-id-application-%E8%A8%BC%E6%98%8E%E6%9B%B8%E3%81%AE%E4%BD%9C%E6%88%90%E3%81%A8%E3%82%A8%E3%82%AF%E3%82%B9%E3%83%9D%E3%83%BC%E3%83%88" class="hash-link" aria-label="Developer ID Application 証明書の作成とエクスポート에 대한 직접 링크" title="Developer ID Application 証明書の作成とエクスポート에 대한 직접 링크" translate="no">​</a></h2>
<p>Apple 外（GitHub Releases や Homebrew）でアプリを配布するには、Apple Developer Program に登録した上で <strong>Developer ID Application</strong> 証明書を発行する必要があります。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="証明書の作成">証明書の作成<a href="https://sawara.me/ko/blog/macos-app-notarization-homebrew-release#%E8%A8%BC%E6%98%8E%E6%9B%B8%E3%81%AE%E4%BD%9C%E6%88%90" class="hash-link" aria-label="証明書の作成에 대한 직접 링크" title="証明書の作成에 대한 직접 링크" translate="no">​</a></h3>
<p>Xcode の <strong>Settings... &gt; Accounts</strong> から Apple Developer Program 登録済みのアカウントを選択し、<strong>Manage Certificates...</strong> から <strong><code>+</code></strong> ＞ <strong>Developer ID Application</strong> を選んで証明書を作成します。</p>
<div class="theme-admonition theme-admonition-tip admonition_xJq3 alert alert--success"><div class="admonitionHeading_Gvgb"><span class="admonitionIcon_Rf37"><svg viewBox="0 0 12 16"><path fill-rule="evenodd" d="M6.5 0C3.48 0 1 2.19 1 5c0 .92.55 2.25 1 3 1.34 2.25 1.78 2.78 2 4v1h5v-1c.22-1.22.66-1.75 2-4 .45-.75 1-2.08 1-3 0-2.81-2.48-5-5.5-5zm3.64 7.48c-.25.44-.47.8-.67 1.11-.86 1.41-1.25 2.06-1.45 3.23-.02.05-.02.11-.02.17H5c0-.06 0-.13-.02-.17-.2-1.17-.59-1.83-1.45-3.23-.2-.31-.42-.67-.67-1.11C2.44 6.78 2 5.65 2 5c0-2.2 2.02-4 4.5-4 1.22 0 2.36.42 3.22 1.19C10.55 2.94 11 3.94 11 5c0 .66-.44 1.78-.86 2.48zM4 14h5c-.23 1.14-1.3 2-2.5 2s-2.27-.86-2.5-2z"></path></svg></span>Xcode から作成できない場合の対処法</div><div class="admonitionContent_BuS1"><p>Xcode 上で「Communication with Apple failed / This operation can only be performed by the Account Holder.」といったエラーが出る場合は、以下の手順を確認します。</p><ol>
<li class=""><a href="https://developer.apple.com/account" target="_blank" rel="noopener noreferrer" class="">Apple Developer Account</a> にサインインし、未同意の規約（License Agreement）や更新通知があれば承認する。</li>
<li class="">それでも Xcode から作成できない場合は、Web ブラウザ（Apple Developer Portal）から直接発行する。<!-- -->
<ul>
<li class=""><strong>キーチェーンアクセス</strong> アプリのメニューから <strong>キーチェーンアクセス ＞ 証明書アシスタント ＞ 認証局に証明書を要求...</strong> を開く。</li>
<li class="">Apple ID のメールアドレスと任意の通称を入力し、<strong>ディスクに保存</strong> を選んで <code>.certSigningRequest</code>（CSR）ファイルを保存する。</li>
<li class=""><a href="https://developer.apple.com/account/resources/certificates/list" target="_blank" rel="noopener noreferrer" class="">Apple Developer Portal の Certificates</a> を開き、<strong><code>+</code></strong> ＞ <strong>Developer ID Application</strong>（G2 Sub-CA）を選択して CSR をアップロードし、生成された <code>.cer</code> ファイルをダウンロードする。</li>
<li class="">ダウンロードした <code>.cer</code> をダブルクリックして「ログイン」キーチェーンへ追加すると、CSR 作成時の秘密鍵と自動で紐づく。</li>
</ul>
</li>
</ol></div></div>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="証明書名の確認と-p12-エクスポート">証明書名の確認と .p12 エクスポート<a href="https://sawara.me/ko/blog/macos-app-notarization-homebrew-release#%E8%A8%BC%E6%98%8E%E6%9B%B8%E5%90%8D%E3%81%AE%E7%A2%BA%E8%AA%8D%E3%81%A8-p12-%E3%82%A8%E3%82%AF%E3%82%B9%E3%83%9D%E3%83%BC%E3%83%88" class="hash-link" aria-label="証明書名の確認と .p12 エクスポート에 대한 직접 링크" title="証明書名の確認と .p12 エクスポート에 대한 직접 링크" translate="no">​</a></h3>
<p>証明書を GitHub Actions へ渡すため、秘密鍵を含んだ <code>.p12</code> 形式で書き出します。</p>
<ol>
<li class="">macOS の <strong>キーチェーンアクセス</strong> を開き、左ペインで「ログイン」＞「自分の証明書」を選択します。</li>
<li class=""><code>Developer ID Application: &lt;Your Name&gt; (&lt;TEAM_ID&gt;)</code> の行を探し、左の <code>&gt;</code> を展開して配下に「秘密鍵」が紐づいていることを確認します。この証明書名の文字列は、後の Secret 設定（<code>MACOS_SIGN_IDENTITY</code>）でそのまま使用します。</li>
<li class="">秘密鍵ではなく <strong>証明書の行を選択した状態</strong> で右クリックし、<strong>書き出す...</strong> からフォーマット <strong>個人情報交換 (.p12)</strong> を選んで保存します。このとき設定したパスワードは <code>MACOS_CERT_PASSWORD</code> 用に控えておきます。</li>
</ol>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="base64-文字列への変換">Base64 文字列への変換<a href="https://sawara.me/ko/blog/macos-app-notarization-homebrew-release#base64-%E6%96%87%E5%AD%97%E5%88%97%E3%81%B8%E3%81%AE%E5%A4%89%E6%8F%9B" class="hash-link" aria-label="Base64 文字列への変換에 대한 직접 링크" title="Base64 文字列への変換에 대한 직접 링크" translate="no">​</a></h3>
<p>書き出した <code>.p12</code> ファイルを GitHub Secrets へ登録できるよう、以下のコマンドで Base64 文字列へ変換します（macOS の <code>pbcopy</code> でそのままクリップボードへ入ります）。</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">base64 -i /path/to/certificate.p12 | tr -d '\n' | pbcopy</span><br></div></code></pre></div></div>
<p>コピーされた文字列は <code>MACOS_CERT_BASE64</code> 用に控えておきます。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="app-store-connect-api-key公証用の発行">App Store Connect API Key（公証用）の発行<a href="https://sawara.me/ko/blog/macos-app-notarization-homebrew-release#app-store-connect-api-key%E5%85%AC%E8%A8%BC%E7%94%A8%E3%81%AE%E7%99%BA%E8%A1%8C" class="hash-link" aria-label="App Store Connect API Key（公証用）の発行에 대한 직접 링크" title="App Store Connect API Key（公証用）の発行에 대한 직접 링크" translate="no">​</a></h2>
<p>GitHub Actions 上から <code>xcrun notarytool</code> で公証を実行するには、Apple ID のパスワードではなく <strong>App Store Connect API Key</strong> を使用すると安定します。API Key 方式であれば、2 要素認証（2FA）の対話入力やアプリ用パスワードの再発行に影響されず CI を運用できます。</p>
<ol>
<li class=""><a href="https://appstoreconnect.apple.com/" target="_blank" rel="noopener noreferrer" class="">App Store Connect</a> にアクセスし、<strong>ユーザーとアクセス ＞ 統合（Integrations） ＞ App Store Connect API</strong> を開きます。</li>
<li class=""><strong><code>+</code></strong> ボタンから新規キーを作成します。<!-- -->
<ul>
<li class=""><strong>名前</strong>: 用途が分かるラベル（例：<code>Wintch GitHub Actions Notary</code>）</li>
<li class=""><strong>アクセス（ロール）</strong>: <strong>Developer</strong>（公証用途であれば最小権限である Developer ロールで動作します）</li>
</ul>
</li>
<li class="">一覧に表示される <strong>Issuer ID</strong> と <strong>Key ID</strong> を控えます。</li>
<li class=""><strong>API キーをダウンロード</strong> から <code>.p8</code> ファイルを保存します（<code>.p8</code> ファイルのダウンロードは 1 回のみ可能です）。</li>
<li class="">以下のコマンドで <code>.p8</code> ファイルを Base64 文字列へ変換し、<code>NOTARY_KEY_BASE64</code> 用に控えておきます。</li>
</ol>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">base64 -i /path/to/AuthKey_XXXXXXXXXX.p8 | tr -d '\n' | pbcopy</span><br></div></code></pre></div></div>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="homebrew-tap-リポジトリの作成とトークン発行">homebrew-tap リポジトリの作成とトークン発行<a href="https://sawara.me/ko/blog/macos-app-notarization-homebrew-release#homebrew-tap-%E3%83%AA%E3%83%9D%E3%82%B8%E3%83%88%E3%83%AA%E3%81%AE%E4%BD%9C%E6%88%90%E3%81%A8%E3%83%88%E3%83%BC%E3%82%AF%E3%83%B3%E7%99%BA%E8%A1%8C" class="hash-link" aria-label="homebrew-tap リポジトリの作成とトークン発行에 대한 직접 링크" title="homebrew-tap リポジトリの作成とトークン発行에 대한 직접 링크" translate="no">​</a></h2>
<p>続いて、利用者が <code>brew install --cask sawarame/tap/wintch</code> のようにインストールできるようにするための専用リポジトリを用意します。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="tap-用リポジトリと初期-cask-の作成">Tap 用リポジトリと初期 Cask の作成<a href="https://sawara.me/ko/blog/macos-app-notarization-homebrew-release#tap-%E7%94%A8%E3%83%AA%E3%83%9D%E3%82%B8%E3%83%88%E3%83%AA%E3%81%A8%E5%88%9D%E6%9C%9F-cask-%E3%81%AE%E4%BD%9C%E6%88%90" class="hash-link" aria-label="Tap 用リポジトリと初期 Cask の作成에 대한 직접 링크" title="Tap 用リポジトリと初期 Cask の作成에 대한 직접 링크" translate="no">​</a></h3>
<p>GitHub 上で自分のアカウント配下に <code>homebrew-tap</code> という名前の <strong>新規パブリックリポジトリ</strong> を作成します（ブランチではなく独立したリポジトリとして作成します）。リポジトリ名を <code>homebrew-</code> プレフィックスにすることで、Homebrew 側で <code>ユーザー名/tap</code> という短縮指定が使えるようになります。</p>
<p>作成した <code>homebrew-tap</code> リポジトリの <code>main</code> ブランチに <code>Casks/wintch.rb</code> を配置し、コミットしておきます。初回リリース前の段階では <code>sha256 :no_check</code> としておき、初回リリース時に GitHub Actions から実際の値へ書き換えられるようにします。</p>
<div class="language-ruby codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-ruby codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">cask "wintch" do</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  version "0.1.0"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  sha256 :no_check</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  url "https://github.com/sawarame/Wintch/releases/download/v#{version}/Wintch-v#{version}.zip"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  name "Wintch"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  desc "Simple and lightweight window switcher for macOS"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  homepage "https://github.com/sawarame/Wintch"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  depends_on macos: "&gt;= :sonoma"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  app "Wintch.app"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  zap trash: [</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    "~/Library/Preferences/dev.wintch.Wintch.plist",</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  ]</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">end</span><br></div></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="更新用-fine-grained-pat-の発行">更新用 Fine-grained PAT の発行<a href="https://sawara.me/ko/blog/macos-app-notarization-homebrew-release#%E6%9B%B4%E6%96%B0%E7%94%A8-fine-grained-pat-%E3%81%AE%E7%99%BA%E8%A1%8C" class="hash-link" aria-label="更新用 Fine-grained PAT の発行에 대한 직접 링크" title="更新用 Fine-grained PAT の発行에 대한 직접 링크" translate="no">​</a></h3>
<p>アプリ側（<code>sawarame/Wintch</code>）の GitHub Actions から別リポジトリ（<code>sawarame/homebrew-tap</code>）へ Cask の更新を push するため、スコープを絞った Fine-grained Personal Access Token を発行します。</p>
<ol>
<li class="">GitHub の <strong>Settings &gt; Developer settings &gt; Personal access tokens &gt; Fine-grained tokens</strong> を開き、<strong>Generate new token</strong> をクリックします。</li>
<li class="">以下の内容を設定してトークンを発行し、<code>HOMEBREW_TAP_TOKEN</code> 用に控えておきます。<!-- -->
<ul>
<li class=""><strong>Token name</strong>: 例 <code>wintch-homebrew-tap-updater</code></li>
<li class=""><strong>Expiration</strong>: 運用しやすい有効期限（例：90 days 〜 1 year）</li>
<li class=""><strong>Repository access</strong>: <strong>Only select repositories</strong> を選び、<code>homebrew-tap</code> リポジトリのみを指定</li>
<li class=""><strong>Permissions &gt; Repositories</strong>: <code>+ Add permissions</code> から <strong>Contents</strong> を追加し、権限を <strong>Read and write</strong> に設定</li>
</ul>
</li>
</ol>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="github-secrets-の登録">GitHub Secrets の登録<a href="https://sawara.me/ko/blog/macos-app-notarization-homebrew-release#github-secrets-%E3%81%AE%E7%99%BB%E9%8C%B2" class="hash-link" aria-label="GitHub Secrets の登録에 대한 직접 링크" title="GitHub Secrets の登録에 대한 직접 링크" translate="no">​</a></h2>
<p>アプリ側リポジトリの <strong>Settings &gt; Secrets and variables &gt; Actions &gt; New repository secret</strong> から、以下の 7 つの Secret を登録します。</p>
<ul>
<li class=""><strong>MACOS_CERT_BASE64</strong>: Base64 化した <code>.p12</code> 証明書の文字列</li>
<li class=""><strong>MACOS_CERT_PASSWORD</strong>: <code>.p12</code> 書き出し時に設定したパスワード</li>
<li class=""><strong>MACOS_SIGN_IDENTITY</strong>: 証明書名（<code>Developer ID Application: &lt;Your Name&gt; (&lt;TEAM_ID&gt;)</code>）</li>
<li class=""><strong>NOTARY_KEY_BASE64</strong>: Base64 化した <code>.p8</code> API キーの文字列</li>
<li class=""><strong>NOTARY_KEY_ID</strong>: App Store Connect API の Key ID</li>
<li class=""><strong>NOTARY_ISSUER_ID</strong>: App Store Connect API の Issuer ID（Team API Key の場合は必須）</li>
<li class=""><strong>HOMEBREW_TAP_TOKEN</strong>: <code>homebrew-tap</code> 更新用に発行した Fine-grained PAT</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="ビルドスクリプトと-github-actions-ワークフローの実装">ビルドスクリプトと GitHub Actions ワークフローの実装<a href="https://sawara.me/ko/blog/macos-app-notarization-homebrew-release#%E3%83%93%E3%83%AB%E3%83%89%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%97%E3%83%88%E3%81%A8-github-actions-%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC%E3%81%AE%E5%AE%9F%E8%A3%85" class="hash-link" aria-label="ビルドスクリプトと GitHub Actions ワークフローの実装에 대한 직접 링크" title="ビルドスクリプトと GitHub Actions ワークフローの実装에 대한 직접 링크" translate="no">​</a></h2>
<p>事前準備が完了したら、リポジトリ側で署名・公証・Tap 更新を行うスクリプトとワークフローを整備します。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="バンドル組み立て署名スクリプトscriptsbuild-appsh">バンドル組み立て＆署名スクリプト（scripts/build-app.sh）<a href="https://sawara.me/ko/blog/macos-app-notarization-homebrew-release#%E3%83%90%E3%83%B3%E3%83%89%E3%83%AB%E7%B5%84%E3%81%BF%E7%AB%8B%E3%81%A6%E7%BD%B2%E5%90%8D%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%97%E3%83%88scriptsbuild-appsh" class="hash-link" aria-label="バンドル組み立て＆署名スクリプト（scripts/build-app.sh）에 대한 직접 링크" title="バンドル組み立て＆署名スクリプト（scripts/build-app.sh）에 대한 직접 링크" translate="no">​</a></h3>
<p>ローカル開発時は証明書なしで手軽にテストビルドできるようアドホック署名（<code>--sign -</code>）を行い、環境変数 <code>WINTCH_SIGN_IDENTITY</code> が渡された CI ビルド時のみ Developer ID 署名（Hardened Runtime とセキュアタイムスタンプ付き）へ切り替わる構成にしています。</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain"># 署名識別子が指定されている場合は Developer ID 署名（Hardened Runtime）、未指定時はアドホック署名を適用する</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">if [ -n "${WINTCH_SIGN_IDENTITY:-}" ]; then</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    echo "[Wintch] Developer ID 署名（Hardened Runtime）を適用しています..."</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    # 公証対応のため実行バイナリとアプリバンドルを順にタイムスタンプ付きで署名する</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    codesign --force --options runtime --timestamp \</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        --sign "${WINTCH_SIGN_IDENTITY}" \</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        "${MACOS_DIR}/${APP_NAME}"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    codesign --force --options runtime --timestamp \</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        --sign "${WINTCH_SIGN_IDENTITY}" \</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        "${APP_BUNDLE}"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    codesign --verify --deep --strict --verbose=2 "${APP_BUNDLE}"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">elif command -v codesign &gt;/dev/null 2&gt;&amp;1; then</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    echo "[Wintch] アドホック署名を適用しています..."</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    codesign --force --deep --sign - "${APP_BUNDLE}"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">fi</span><br></div></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="自動リリースワークフローgithubworkflowsreleaseyml">自動リリースワークフロー（.github/workflows/release.yml）<a href="https://sawara.me/ko/blog/macos-app-notarization-homebrew-release#%E8%87%AA%E5%8B%95%E3%83%AA%E3%83%AA%E3%83%BC%E3%82%B9%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BCgithubworkflowsreleaseyml" class="hash-link" aria-label="自動リリースワークフロー（.github/workflows/release.yml）에 대한 직접 링크" title="自動リリースワークフロー（.github/workflows/release.yml）에 대한 직접 링크" translate="no">​</a></h3>
<p>ワークフローは <code>prepare</code> ジョブと <code>release</code> ジョブの 2 段階に分かれており、どちらも <code>macos-15</code> ランナー上で動作します。</p>
<ul>
<li class=""><strong>prepare ジョブ</strong>: <code>VERSION</code> ファイルがセマンティックバージョニング形式（<code>X.Y.Z</code> など）であることを検証し、<code>swift test</code> を実行した上で、タグが未作成なら注釈付きタグ（<code>vX.Y.Z</code>）を自動作成・push します。</li>
<li class=""><strong>release ジョブ</strong>: 必要な Secret の存在を確認した上で、以下の処理を実行します。</li>
</ul>
<ol>
<li class=""><strong>一時キーチェーン構築</strong>: ランナー内の一時領域にキーチェーンを作成し、<code>MACOS_CERT_BASE64</code> を復元してインポートします（<code>security set-key-partition-list</code> で <code>codesign</code> からの参照を許可）。作成したキーチェーンはジョブ末尾の <code>if: always()</code> ステップで必ず削除します。</li>
<li class=""><strong>Universal Binary ビルド・検証</strong>: <code>./scripts/build-app.sh release --universal</code> を実行後、<code>Info.plist</code> のバージョン一致と <code>lipo -archs</code> による <code>arm64</code> / <code>x86_64</code> 両対応を確認します。</li>
<li class=""><strong>公証・Staple・Gatekeeper 検証</strong>:<!-- -->
<ul>
<li class=""><code>ditto -c -k --keepParent</code> で一時 ZIP を作成し、<code>xcrun notarytool submit --wait --output-format json</code> で公証結果を待機します（<code>Accepted</code> 以外の場合は自動で <code>xcrun notarytool log</code> を出力して失敗させます）。</li>
<li class=""><code>xcrun stapler staple</code> で公証チケットを <code>.app</code> へ埋め込みます（Apple 側の反映遅延に備え、10 秒間隔で最大 5 回リトライします）。</li>
<li class=""><code>xcrun stapler validate</code> および <code>spctl -a -vvv -t exec</code> で検証したのち、配布用の最終 ZIP を生成して SHA256 を算出します。</li>
</ul>
</li>
</ol>
<p>ワークフロー後半の公証・Staple 処理および <code>homebrew-tap</code> 更新の主要部分は次のとおりです。</p>
<div class="language-yaml codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-yaml codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain"> </span><span class="token key atrule" style="color:#00a4db">name</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> Notarize</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> staple</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> and package release ZIP</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token key atrule" style="color:#00a4db">id</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> package</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token key atrule" style="color:#00a4db">env</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token key atrule" style="color:#00a4db">NOTARY_KEY_BASE64</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> $</span><span class="token punctuation" style="color:#393A34">{</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> secrets.NOTARY_KEY_BASE64 </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token key atrule" style="color:#00a4db">NOTARY_KEY_ID</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> $</span><span class="token punctuation" style="color:#393A34">{</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> secrets.NOTARY_KEY_ID </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token key atrule" style="color:#00a4db">NOTARY_ISSUER_ID</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> $</span><span class="token punctuation" style="color:#393A34">{</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> secrets.NOTARY_ISSUER_ID </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token key atrule" style="color:#00a4db">run</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">|</span><span class="token scalar string" style="color:#e3116c"></span><br></div><div class="token-line" style="color:#393A34"><span class="token scalar string" style="color:#e3116c">          set -euo pipefail</span><br></div><div class="token-line" style="color:#393A34"><span class="token scalar string" style="color:#e3116c">          TAG_NAME="${{ needs.prepare.outputs.tag_name }}"</span><br></div><div class="token-line" style="color:#393A34"><span class="token scalar string" style="color:#e3116c">          NOTARIZE_ZIP="./.build/Wintch-notarize.zip"</span><br></div><div class="token-line" style="color:#393A34"><span class="token scalar string" style="color:#e3116c">          FINAL_ZIP="./.build/Wintch-${TAG_NAME}.zip"</span><br></div><div class="token-line" style="color:#393A34"><span class="token scalar string" style="color:#e3116c">          KEY_PATH="${RUNNER_TEMP}/AuthKey.p8"</span><br></div><div class="token-line" style="color:#393A34"><span class="token scalar string" style="color:#e3116c">          trap 'rm -f "${KEY_PATH}" "${NOTARIZE_ZIP}"' EXIT</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          ditto </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">c </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">k </span><span class="token punctuation" style="color:#393A34">-</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">keepParent ./.build/Wintch.app "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">NOTARIZE_ZIP</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          printf '%s' "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">NOTARY_KEY_BASE64</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">" </span><span class="token punctuation" style="color:#393A34">|</span><span class="token plain"> tr </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">d '</span><span class="token punctuation" style="color:#393A34">[</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain">space</span><span class="token punctuation" style="color:#393A34">:</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain">' </span><span class="token punctuation" style="color:#393A34">|</span><span class="token plain"> base64 </span><span class="token punctuation" style="color:#393A34">-</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">decode </span><span class="token punctuation" style="color:#393A34">&gt;</span><span class="token plain"> "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">KEY_PATH</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          chmod 600 "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">KEY_PATH</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          NOTARY_AUTH_ARGS=(</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">            </span><span class="token punctuation" style="color:#393A34">-</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">key "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">KEY_PATH</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">            </span><span class="token punctuation" style="color:#393A34">-</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">key</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">id "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">NOTARY_KEY_ID</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          )</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          if </span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">n "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">NOTARY_ISSUER_ID</span><span class="token punctuation" style="color:#393A34">:</span><span class="token punctuation" style="color:#393A34">-</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">" </span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain">; then</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">            NOTARY_AUTH_ARGS+=(</span><span class="token punctuation" style="color:#393A34">-</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">issuer "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">NOTARY_ISSUER_ID</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">")</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          fi</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          set +e</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          SUBMIT_JSON="$(xcrun notarytool submit "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">NOTARIZE_ZIP</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">" "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">NOTARY_AUTH_ARGS</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">@</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">" </span><span class="token punctuation" style="color:#393A34">-</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">wait </span><span class="token punctuation" style="color:#393A34">-</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">output</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">format json)"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          SUBMIT_EXIT=$</span><span class="token punctuation" style="color:#393A34">?</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          set </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">e</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          echo "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">SUBMIT_JSON</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          PARSED_RESULT="$(SUBMIT_JSON="$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">SUBMIT_JSON</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">" python3 </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">c 'import json</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> os; d = json.loads(os.environ.get("SUBMIT_JSON") or "</span><span class="token punctuation" style="color:#393A34">{</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">"); print(d.get("status"</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> "")); print(d.get("id"</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> ""))')"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          NOTARY_STATUS="$(printf '%s\n' "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">PARSED_RESULT</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">" </span><span class="token punctuation" style="color:#393A34">|</span><span class="token plain"> sed </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">n '1p')"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          SUBMISSION_ID="$(printf '%s\n' "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">PARSED_RESULT</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">" </span><span class="token punctuation" style="color:#393A34">|</span><span class="token plain"> sed </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">n '2p')"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          if </span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain"> "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">SUBMIT_EXIT</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">" </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">ne 0 </span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">|</span><span class="token punctuation" style="color:#393A34">|</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain"> "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">NOTARY_STATUS</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">" </span><span class="token tag" style="color:#00009f">!=</span><span class="token plain"> "Accepted" </span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain">; then</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">            echo "</span><span class="token punctuation" style="color:#393A34">:</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain">error</span><span class="token punctuation" style="color:#393A34">:</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain">Apple 公証に失敗しました (status=$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">NOTARY_STATUS</span><span class="token punctuation" style="color:#393A34">:</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">unknown</span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> id=$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">SUBMISSION_ID</span><span class="token punctuation" style="color:#393A34">:</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">unknown</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">)。"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">            if </span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">n "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">SUBMISSION_ID</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">" </span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain">; then</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">              xcrun notarytool log "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">SUBMISSION_ID</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">" "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">NOTARY_AUTH_ARGS</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">@</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">" </span><span class="token punctuation" style="color:#393A34">|</span><span class="token punctuation" style="color:#393A34">|</span><span class="token plain"> true</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">            fi</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">            exit 1</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          fi</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token comment" style="color:#999988;font-style:italic"># チケット反映遅延に備えてリトライしながら Staple を実行する</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          STAPLED="false"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          for attempt in 1 2 3 4 5; do</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">            if xcrun stapler staple ./.build/Wintch.app; then</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">              STAPLED="true"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">              break</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">            fi</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">            echo "stapler staple のリトライを待機しています ($</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">attempt</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">/5)</span><span class="token punctuation" style="color:#393A34">...</span><span class="token plain">"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">            sleep 10</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          done</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          if </span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain"> "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">STAPLED</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">" </span><span class="token tag" style="color:#00009f">!=</span><span class="token plain"> "true" </span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain">; then</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">            echo "</span><span class="token punctuation" style="color:#393A34">:</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain">error</span><span class="token punctuation" style="color:#393A34">:</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain">公証チケットの添付 (stapler staple) に失敗しました。"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">            exit 1</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          fi</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          xcrun stapler validate ./.build/Wintch.app</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          spctl </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">a </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">vvv </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">t exec ./.build/Wintch.app</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token comment" style="color:#999988;font-style:italic"># 公証チケット添付済みの最終配布 ZIP と SHA256 を生成する</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          ditto </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">c </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">k </span><span class="token punctuation" style="color:#393A34">-</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">keepParent ./.build/Wintch.app "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">FINAL_ZIP</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          SHA256="$(shasum </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">a 256 "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">FINAL_ZIP</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">" </span><span class="token punctuation" style="color:#393A34">|</span><span class="token plain"> awk '</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">print $1</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">')"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          echo "sha256=$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">SHA256</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">" </span><span class="token punctuation" style="color:#393A34">&gt;</span><span class="token punctuation" style="color:#393A34">&gt;</span><span class="token plain"> "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">GITHUB_OUTPUT</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">"</span><br></div></code></pre></div></div>
<p>公証済み ZIP を <code>gh release create</code>（既存時は <code>gh release upload --clobber</code>）で GitHub Releases へ公開したあと、安定版リリースの場合は <code>homebrew-tap</code> リポジトリを clone して <code>Casks/wintch.rb</code> の <code>version</code> と <code>sha256</code> を自動更新し、コミット・push します。全体像は <a href="https://github.com/sawarame/Wintch/blob/main/.github/workflows/release.yml" target="_blank" rel="noopener noreferrer" class="">Wintch の release.yml</a> から参照できます。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="日常のリリース運用と実機確認">日常のリリース運用と実機確認<a href="https://sawara.me/ko/blog/macos-app-notarization-homebrew-release#%E6%97%A5%E5%B8%B8%E3%81%AE%E3%83%AA%E3%83%AA%E3%83%BC%E3%82%B9%E9%81%8B%E7%94%A8%E3%81%A8%E5%AE%9F%E6%A9%9F%E7%A2%BA%E8%AA%8D" class="hash-link" aria-label="日常のリリース運用と実機確認에 대한 직접 링크" title="日常のリリース運用と実機確認에 대한 직접 링크" translate="no">​</a></h2>
<p>初回セットアップ後は、以下のいずれかの操作を行うだけでリリースから Homebrew Tap 更新までが自動で完了します。</p>
<ul>
<li class=""><strong>VERSION ファイルの更新（通常運用）</strong>: ルートの <code>VERSION</code> ファイルを新しいバージョン（例：<code>0.1.0</code> → <code>0.1.1</code>）へ書き換えて <code>main</code> ブランチへ push する</li>
<li class=""><strong>手動実行</strong>: GitHub リポジトリの <strong>Actions &gt; Release &gt; Run workflow</strong> から実行する（同一バージョンで再リリースしたい場合などに有効）</li>
<li class=""><strong>タグ直接 push</strong>: <code>VERSION</code> と一致する <code>vX.Y.Z</code> タグを直接 push する</li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="homebrew-からのインストールと実機確認">Homebrew からのインストールと実機確認<a href="https://sawara.me/ko/blog/macos-app-notarization-homebrew-release#homebrew-%E3%81%8B%E3%82%89%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB%E3%81%A8%E5%AE%9F%E6%A9%9F%E7%A2%BA%E8%AA%8D" class="hash-link" aria-label="Homebrew からのインストールと実機確認에 대한 직접 링크" title="Homebrew からのインストールと実機確認에 대한 직접 링크" translate="no">​</a></h3>
<p>リリースワークフロー完了後、手元に開発版のアプリがある場合は一度削除した上で、Homebrew 経由でインストールして動作を確認します。</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">brew install --cask sawarame/tap/wintch</span><br></div></code></pre></div></div>
<p>インストール後、以下の点を確認しておくと確実です。</p>
<ol>
<li class="">ターミナル上で Gatekeeper 評価が通ること（任意確認）：<!-- -->
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">spctl -a -vvv -t exec /Applications/Wintch.app</span><br></div></code></pre></div></div>
</li>
<li class="">アプリを起動した際に Gatekeeper のブロック警告が出ず、そのまま開けること。</li>
<li class="">「システム設定 ＞ プライバシーとセキュリティ ＞ アクセシビリティ」で権限を許可したあと、基本機能やログイン時自動起動（<code>SMAppService.mainApp</code>）が正常に動作すること。</li>
</ol>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="まとめ">まとめ<a href="https://sawara.me/ko/blog/macos-app-notarization-homebrew-release#%E3%81%BE%E3%81%A8%E3%82%81" class="hash-link" aria-label="まとめ에 대한 직접 링크" title="まとめ에 대�한 직접 링크" translate="no">​</a></h2>
<p>Developer ID 証明書・App Store Connect API Key・<code>homebrew-tap</code> 更新用 PAT の 3 点を初回だけ GitHub Secrets に登録しておくことで、以降は <code>VERSION</code> ファイルを書き換えて push するだけで「ビルド → 署名 → 公証 → Staple → GitHub Releases 公開 → Homebrew Cask 更新」までを人手なしで完結できました。</p>
<p>特に SwiftPM 単体で構成されたアプリであっても、バンドル組み立てと <code>codesign</code> をシェルスクリプトへ切り出しておけば、ローカル開発時の手軽さを保ったまま CI でのリリース品質を担保しやすいと感じました。macOS アプリを Homebrew 経由で配布する際の参考になれば幸いです。</p>
<p>なお、本記事の手順でリリースしているアプリ <strong>Wintch</strong> の機能詳細や導入方法については、以下の紹介ページにまとめています。</p>
<a class="linkCard_fEEo" href="https://sawara.me/ko/wintch"><div class="emojiWrapper_T8JQ"><span>🪟</span></div><div class="content_cWRx"><div class="title_KDn0">Wintch 紹介・インストールページ</div><div class="description_qJNw">macOS 14.0 以降対応のウィンドウ単位スイッチャー＆検索ランチャー。機能プレビューやショートカット一覧も掲載しています。</div></div></a>]]></content:encoded>
            <category>macOS</category>
            <category>Swift</category>
            <category>Homebrew</category>
            <category>GitHub Actions</category>
            <category>CI/CD</category>
            <category>Wintch</category>
        </item>
        <item>
            <title><![CDATA[通常指示と何が違うのか？Antigravity CLI の /boost コマンドによるエッジケース網羅とリファクタリング実践]]></title>
            <link>https://sawara.me/ko/blog/antigravity-cli-boost-command-refactoring</link>
            <guid>https://sawara.me/ko/blog/antigravity-cli-boost-command-refactoring</guid>
            <pubDate>Sun, 20 Sep 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[AIアシスタントを活用したコーディングでは、「動作するコード」を素早く生成できる一方で、非同期処理の競合状態（レースコンディション）やアンマウント時のメモリリーク、境界条件のエラーハンドリングといったエッジケースの対応が漏れてしまうことがあります。]]></description>
            <content:encoded><![CDATA[<p>AIアシスタントを活用したコーディングでは、「動作するコード」を素早く生成できる一方で、非同期処理の競合状態（レースコンディション）やアンマウント時のメモリリーク、境界条件のエラーハンドリングといったエッジケースの対応が漏れてしまうことがあります。</p>
<p>こうした潜在的なバグを防ぐためには、人間側が細かく前提条件を指定するか、レビュー時に手動で指摘を重ねる必要がありました。</p>
<p>Antigravity CLI に搭載されている <code>/boost</code> コマンドを使用すると、タスクに対して深層思考と多角的な視点による検証が自動的に行われ、エッジケースまで考慮された堅牢なコードを導出できます。本記事では、非同期データ取得を行う React カスタムフックのリファクタリングを題材に、通常指示との違いと具体的な効果を紹介します。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="boost-コマンドの仕組みと通常指示との違い">/boost コマンドの仕組みと通常指示との違い<a href="https://sawara.me/ko/blog/antigravity-cli-boost-command-refactoring#boost-%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89%E3%81%AE%E4%BB%95%E7%B5%84%E3%81%BF%E3%81%A8%E9%80%9A%E5%B8%B8%E6%8C%87%E7%A4%BA%E3%81%A8%E3%81%AE%E9%81%95%E3%81%84" class="hash-link" aria-label="/boost コマンドの仕組みと通常指示との違い에 대한 직접 링크" title="/boost コマンドの仕組みと通常指示との違い에 대한 직접 링크" translate="no">​</a></h2>
<p><code>/boost</code> は、通常のターミナルコマンドではなく、<strong>Antigravity CLI の対話画面（チャットインターフェース）内</strong> で実行するスラッシュコマンドです。</p>
<p>通常のチャット指示では、入力されたプロンプトに対して最も確からしい実装を迅速に出力することが優先されます。一方、プロンプトの先頭に <code>/boost</code> を付与すると、エージェントは即座にコードを生成せず、以下のような多角的な検証ステップを経てから回答を導出します。</p>
<!-- -->
<p>この処理プロセスにより、表面的なコードの清書にとどまらず、プロダクション環境で問題になりやすい並行処理や境界条件の欠陥を未然に防ぐことが可能になります。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="検証題材非同期検索を行うカスタムフック">検証題材：非同期検索を行うカスタムフック<a href="https://sawara.me/ko/blog/antigravity-cli-boost-command-refactoring#%E6%A4%9C%E8%A8%BC%E9%A1%8C%E6%9D%90%E9%9D%9E%E5%90%8C%E6%9C%9F%E6%A4%9C%E7%B4%A2%E3%82%92%E8%A1%8C%E3%81%86%E3%82%AB%E3%82%B9%E3%82%BF%E3%83%A0%E3%83%95%E3%83%83%E3%82%AF" class="hash-link" aria-label="検証題材：非同期検索を行うカスタムフック에 대한 직접 링크" title="検証題材：非同期検索を行うカスタムフック에 대한 직접 링크" translate="no">​</a></h2>
<p>今回検証する題材は、検索キーワードに応じて外部APIから候補を取得する React のカスタムフック（<code>useSearch</code>）です。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="改善前のコード">改善前のコード<a href="https://sawara.me/ko/blog/antigravity-cli-boost-command-refactoring#%E6%94%B9%E5%96%84%E5%89%8D%E3%81%AE%E3%82%B3%E3%83%BC%E3%83%89" class="hash-link" aria-label="改善前のコード에 대한 직접 링크" title="改善前のコード에 대한 직접 링크" translate="no">​</a></h3>
<p>以下は、初期実装としてよく見られるコードです。</p>
<div class="language-typescript codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-typescript codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> useState</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> useEffect </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">from</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">'react'</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">export</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">function</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">useSearch</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">query</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">string</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">data</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> setData</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token generic-function function" style="color:#d73a49">useState</span><span class="token generic-function generic class-name operator" style="color:#393A34">&lt;</span><span class="token generic-function generic class-name builtin">string</span><span class="token generic-function generic class-name punctuation" style="color:#393A34">[</span><span class="token generic-function generic class-name punctuation" style="color:#393A34">]</span><span class="token generic-function generic class-name operator" style="color:#393A34">&gt;</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">[</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">loading</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> setLoading</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token generic-function function" style="color:#d73a49">useState</span><span class="token generic-function generic class-name operator" style="color:#393A34">&lt;</span><span class="token generic-function generic class-name builtin">boolean</span><span class="token generic-function generic class-name operator" style="color:#393A34">&gt;</span><span class="token punctuation" style="color:#393A34">(</span><span class="token boolean" style="color:#36acaa">false</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token function" style="color:#d73a49">useEffect</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=&gt;</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">if</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token operator" style="color:#393A34">!</span><span class="token plain">query</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token function" style="color:#d73a49">setData</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">[</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token keyword" style="color:#00009f">return</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token function" style="color:#d73a49">setLoading</span><span class="token punctuation" style="color:#393A34">(</span><span class="token boolean" style="color:#36acaa">true</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token function" style="color:#d73a49">fetch</span><span class="token punctuation" style="color:#393A34">(</span><span class="token template-string template-punctuation string" style="color:#e3116c">`</span><span class="token template-string string" style="color:#e3116c">/api/search?q=</span><span class="token template-string interpolation interpolation-punctuation punctuation" style="color:#393A34">${</span><span class="token template-string interpolation function" style="color:#d73a49">encodeURIComponent</span><span class="token template-string interpolation punctuation" style="color:#393A34">(</span><span class="token template-string interpolation">query</span><span class="token template-string interpolation punctuation" style="color:#393A34">)</span><span class="token template-string interpolation interpolation-punctuation punctuation" style="color:#393A34">}</span><span class="token template-string template-punctuation string" style="color:#e3116c">`</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">.</span><span class="token function" style="color:#d73a49">then</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">res</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=&gt;</span><span class="token plain"> res</span><span class="token punctuation" style="color:#393A34">.</span><span class="token function" style="color:#d73a49">json</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">.</span><span class="token function" style="color:#d73a49">then</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">result</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=&gt;</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token function" style="color:#d73a49">setData</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">result</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token function" style="color:#d73a49">setLoading</span><span class="token punctuation" style="color:#393A34">(</span><span class="token boolean" style="color:#36acaa">false</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">query</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">return</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> data</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> loading </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></div></code></pre></div></div>
<p>この実装には、実運用上で以下のような課題が潜んでいます。</p>
<ul>
<li class=""><strong>競合状態（レースコンディション）</strong>: ユーザーが素早くタイピングした場合、リクエストの送信順とレスポンスの受信順が一致しないことがあります。古いリクエストの応答が最新の入力を上書きしてしまうリスクがあります。</li>
<li class=""><strong>リクエストのキャンセル処理の欠如</strong>: 次のリクエストが走った際や、コンポーネントがアンマウントされた際にも通信が継続してしまい、不要なネットワーク負荷が発生します。</li>
<li class=""><strong>エラーハンドリングの欠落</strong>: 通信エラー発生時に <code>loading</code> が <code>true</code> のまま停止し、エラー情報も呼び出し元に通知されません。</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="通常指示によるリファクタリング結果before">通常指示によるリファクタリング結果（Before）<a href="https://sawara.me/ko/blog/antigravity-cli-boost-command-refactoring#%E9%80%9A%E5%B8%B8%E6%8C%87%E7%A4%BA%E3%81%AB%E3%82%88%E3%82%8B%E3%83%AA%E3%83%95%E3%82%A1%E3%82%AF%E3%82%BF%E3%83%AA%E3%83%B3%E3%82%B0%E7%B5%90%E6%9E%9Cbefore" class="hash-link" aria-label="通常指示によるリファクタリング結果（Before）에 대한 직접 링크" title="通常指示によるリファクタリング結果（Before）에 대한 직접 링크" translate="no">​</a></h2>
<p>まずは <code>/boost</code> を付けず、通常のチャット指示でリファクタリングを依頼しました。</p>
<p><strong>入力プロンプト:</strong></p>
<blockquote>
<p><code>useSearch フックをリファクタリングしてください。エラーハンドリングとローディング状態を追加し、TypeScript の型定義を整えてください。</code></p>
</blockquote>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="生成されたコード">生成されたコード<a href="https://sawara.me/ko/blog/antigravity-cli-boost-command-refactoring#%E7%94%9F%E6%88%90%E3%81%95%E3%82%8C%E3%81%9F%E3%82%B3%E3%83%BC%E3%83%89" class="hash-link" aria-label="生成されたコード에 대한 직접 링크" title="��生成されたコード에 대한 직접 링크" translate="no">​</a></h3>
<div class="language-typescript codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-typescript codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> useState</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> useEffect </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">from</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">'react'</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">interface</span><span class="token plain"> </span><span class="token class-name">SearchResult</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  items</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">string</span><span class="token punctuation" style="color:#393A34">[</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">export</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">function</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">useSearch</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">query</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">string</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">data</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> setData</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token generic-function function" style="color:#d73a49">useState</span><span class="token generic-function generic class-name operator" style="color:#393A34">&lt;</span><span class="token generic-function generic class-name builtin">string</span><span class="token generic-function generic class-name punctuation" style="color:#393A34">[</span><span class="token generic-function generic class-name punctuation" style="color:#393A34">]</span><span class="token generic-function generic class-name operator" style="color:#393A34">&gt;</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">[</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">loading</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> setLoading</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token generic-function function" style="color:#d73a49">useState</span><span class="token generic-function generic class-name operator" style="color:#393A34">&lt;</span><span class="token generic-function generic class-name builtin">boolean</span><span class="token generic-function generic class-name operator" style="color:#393A34">&gt;</span><span class="token punctuation" style="color:#393A34">(</span><span class="token boolean" style="color:#36acaa">false</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">error</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> setError</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token generic-function function" style="color:#d73a49">useState</span><span class="token generic-function generic class-name operator" style="color:#393A34">&lt;</span><span class="token generic-function generic class-name">Error </span><span class="token generic-function generic class-name operator" style="color:#393A34">|</span><span class="token generic-function generic class-name"> </span><span class="token generic-function generic class-name keyword" style="color:#00009f">null</span><span class="token generic-function generic class-name operator" style="color:#393A34">&gt;</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">null</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token function" style="color:#d73a49">useEffect</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=&gt;</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">if</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token operator" style="color:#393A34">!</span><span class="token plain">query</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token function" style="color:#d73a49">setData</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">[</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token function" style="color:#d73a49">setError</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">null</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token keyword" style="color:#00009f">return</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token function" style="color:#d73a49">setLoading</span><span class="token punctuation" style="color:#393A34">(</span><span class="token boolean" style="color:#36acaa">true</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token function" style="color:#d73a49">setError</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">null</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token function" style="color:#d73a49">fetch</span><span class="token punctuation" style="color:#393A34">(</span><span class="token template-string template-punctuation string" style="color:#e3116c">`</span><span class="token template-string string" style="color:#e3116c">/api/search?q=</span><span class="token template-string interpolation interpolation-punctuation punctuation" style="color:#393A34">${</span><span class="token template-string interpolation function" style="color:#d73a49">encodeURIComponent</span><span class="token template-string interpolation punctuation" style="color:#393A34">(</span><span class="token template-string interpolation">query</span><span class="token template-string interpolation punctuation" style="color:#393A34">)</span><span class="token template-string interpolation interpolation-punctuation punctuation" style="color:#393A34">}</span><span class="token template-string template-punctuation string" style="color:#e3116c">`</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">.</span><span class="token function" style="color:#d73a49">then</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">res</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=&gt;</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token keyword" style="color:#00009f">if</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token operator" style="color:#393A34">!</span><span class="token plain">res</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">ok</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token keyword" style="color:#00009f">throw</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> </span><span class="token class-name">Error</span><span class="token punctuation" style="color:#393A34">(</span><span class="token template-string template-punctuation string" style="color:#e3116c">`</span><span class="token template-string string" style="color:#e3116c">検索に失敗しました: </span><span class="token template-string interpolation interpolation-punctuation punctuation" style="color:#393A34">${</span><span class="token template-string interpolation">res</span><span class="token template-string interpolation punctuation" style="color:#393A34">.</span><span class="token template-string interpolation">status</span><span class="token template-string interpolation interpolation-punctuation punctuation" style="color:#393A34">}</span><span class="token template-string template-punctuation string" style="color:#e3116c">`</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token keyword" style="color:#00009f">return</span><span class="token plain"> res</span><span class="token punctuation" style="color:#393A34">.</span><span class="token function" style="color:#d73a49">json</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">as</span><span class="token plain"> </span><span class="token builtin">Promise</span><span class="token operator" style="color:#393A34">&lt;</span><span class="token plain">SearchResult</span><span class="token operator" style="color:#393A34">&gt;</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">.</span><span class="token function" style="color:#d73a49">then</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">result</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=&gt;</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token function" style="color:#d73a49">setData</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">result</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">items</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">.</span><span class="token function" style="color:#d73a49">catch</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">err</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">unknown</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=&gt;</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token function" style="color:#d73a49">setError</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">err </span><span class="token keyword" style="color:#00009f">instanceof</span><span class="token plain"> </span><span class="token class-name">Error</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">?</span><span class="token plain"> err </span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> </span><span class="token class-name">Error</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">'不明なエラー'</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">.</span><span class="token function" style="color:#d73a49">finally</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=&gt;</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token function" style="color:#d73a49">setLoading</span><span class="token punctuation" style="color:#393A34">(</span><span class="token boolean" style="color:#36acaa">false</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">query</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">return</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> data</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> loading</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> error </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></div></code></pre></div></div>
<p>指示通り <code>error</code> ステートの追加や HTTP ステータスのチェック、型定義の整理が行われ、構文上は整ったコードになりました。</p>
<p>しかし、<strong><code>AbortController</code> による通信のキャンセル処理</strong> や <strong>連続入力時のレスポンス逆転（競合状態）の防止</strong> は依然として考慮されていません。このコードをそのまま本番環境に適用すると、通信速度の揺らぎによって入力欄と検索結果が不一致になるバグが残ってしまいます。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="boost-コマンドによるリファクタリングafter">/boost コマンドによるリファクタリング（After）<a href="https://sawara.me/ko/blog/antigravity-cli-boost-command-refactoring#boost-%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89%E3%81%AB%E3%82%88%E3%82%8B%E3%83%AA%E3%83%95%E3%82%A1%E3%82%AF%E3%82%BF%E3%83%AA%E3%83%B3%E3%82%B0after" class="hash-link" aria-label="/boost コマンドによるリファクタリング（After）에 대한 직접 링크" title="/boost コマンドによるリファクタリング（After）에 대한 직접 링크" translate="no">​</a></h2>
<p>次に、同じコードに対して <code>/boost</code> コマンドを付与してリファクタリングを依頼しました。</p>
<p><strong>入力プロンプト:</strong></p>
<blockquote>
<p><code>/boost useSearch フックをリファクタリングしてください。本番環境で安全に動作するよう、エッジケースや設計上のトレードオフを多角的に検証し、堅牢な実装に改善してください。</code></p>
</blockquote>
<p>コマンドを実行すると、エージェントは直ちにコードを出力せず、内部で次のような検討プロセスを実行したログが表示されました。</p>
<ul>
<li class=""><strong>潜在課題の抽出</strong>: 非同期競合、アンマウント後の状態更新、<code>AbortError</code> と通常エラーの区別、空文字・空白文字のサニタイズ。</li>
<li class=""><strong>設計トレードオフの比較</strong>: <code>isCancelled</code> フラグ方式（受信後に破棄）と <code>AbortController</code> 方式（通信自体を中断）を比較し、ネットワークリソースの観点から <code>AbortController</code> を採用。</li>
<li class=""><strong>例外の選別</strong>: <code>fetch</code> を中断した際に発生する <code>AbortError</code> は正常系の中断動作であるため、エラー状態（<code>error</code>）として扱わない設計を採用。</li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="生成されたコード-1">生成されたコード<a href="https://sawara.me/ko/blog/antigravity-cli-boost-command-refactoring#%E7%94%9F%E6%88%90%E3%81%95%E3%82%8C%E3%81%9F%E3%82%B3%E3%83%BC%E3%83%89-1" class="hash-link" aria-label="生成されたコード에 대한 직접 링크" title="生成されたコード에 대한 직접 링크" translate="no">​</a></h3>
<div class="language-typescript codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-typescript codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> useState</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> useEffect </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">from</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">'react'</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token doc-comment comment" style="color:#999988;font-style:italic">/**</span><br></div><div class="token-line" style="color:#393A34"><span class="token doc-comment comment" style="color:#999988;font-style:italic"> * 検索結果の型定義</span><br></div><div class="token-line" style="color:#393A34"><span class="token doc-comment comment" style="color:#999988;font-style:italic"> */</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">export</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">interface</span><span class="token plain"> </span><span class="token class-name">SearchResult</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  items</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">string</span><span class="token punctuation" style="color:#393A34">[</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token doc-comment comment" style="color:#999988;font-style:italic">/**</span><br></div><div class="token-line" style="color:#393A34"><span class="token doc-comment comment" style="color:#999988;font-style:italic"> * useSearch フックの戻り値の型定義</span><br></div><div class="token-line" style="color:#393A34"><span class="token doc-comment comment" style="color:#999988;font-style:italic"> */</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">export</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">interface</span><span class="token plain"> </span><span class="token class-name">UseSearchResult</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  data</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">string</span><span class="token punctuation" style="color:#393A34">[</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  loading</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">boolean</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  error</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> Error </span><span class="token operator" style="color:#393A34">|</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">null</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token doc-comment comment" style="color:#999988;font-style:italic">/**</span><br></div><div class="token-line" style="color:#393A34"><span class="token doc-comment comment" style="color:#999988;font-style:italic"> * 非同期検索を安全に行うカスタムフック</span><br></div><div class="token-line" style="color:#393A34"><span class="token doc-comment comment" style="color:#999988;font-style:italic"> * </span><span class="token doc-comment comment keyword" style="color:#00009f;font-style:italic">@param</span><span class="token doc-comment comment" style="color:#999988;font-style:italic"> </span><span class="token doc-comment comment parameter" style="color:#999988;font-style:italic">query</span><span class="token doc-comment comment" style="color:#999988;font-style:italic"> - 検索キーワード</span><br></div><div class="token-line" style="color:#393A34"><span class="token doc-comment comment" style="color:#999988;font-style:italic"> * </span><span class="token doc-comment comment keyword" style="color:#00009f;font-style:italic">@returns</span><span class="token doc-comment comment" style="color:#999988;font-style:italic"> 検索結果、ローディング状態、エラーオブジェクト</span><br></div><div class="token-line" style="color:#393A34"><span class="token doc-comment comment" style="color:#999988;font-style:italic"> */</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">export</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">function</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">useSearch</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">query</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">string</span><span class="token punctuation" style="color:#393A34">)</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> UseSearchResult </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">data</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> setData</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token generic-function function" style="color:#d73a49">useState</span><span class="token generic-function generic class-name operator" style="color:#393A34">&lt;</span><span class="token generic-function generic class-name builtin">string</span><span class="token generic-function generic class-name punctuation" style="color:#393A34">[</span><span class="token generic-function generic class-name punctuation" style="color:#393A34">]</span><span class="token generic-function generic class-name operator" style="color:#393A34">&gt;</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">[</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">loading</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> setLoading</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token generic-function function" style="color:#d73a49">useState</span><span class="token generic-function generic class-name operator" style="color:#393A34">&lt;</span><span class="token generic-function generic class-name builtin">boolean</span><span class="token generic-function generic class-name operator" style="color:#393A34">&gt;</span><span class="token punctuation" style="color:#393A34">(</span><span class="token boolean" style="color:#36acaa">false</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">error</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> setError</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token generic-function function" style="color:#d73a49">useState</span><span class="token generic-function generic class-name operator" style="color:#393A34">&lt;</span><span class="token generic-function generic class-name">Error </span><span class="token generic-function generic class-name operator" style="color:#393A34">|</span><span class="token generic-function generic class-name"> </span><span class="token generic-function generic class-name keyword" style="color:#00009f">null</span><span class="token generic-function generic class-name operator" style="color:#393A34">&gt;</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">null</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token function" style="color:#d73a49">useEffect</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=&gt;</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> trimmedQuery </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> query</span><span class="token punctuation" style="color:#393A34">.</span><span class="token function" style="color:#d73a49">trim</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// 空白文字または空文字列の場合は即座にリセット</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">if</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token operator" style="color:#393A34">!</span><span class="token plain">trimmedQuery</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token function" style="color:#d73a49">setData</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">[</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token function" style="color:#d73a49">setLoading</span><span class="token punctuation" style="color:#393A34">(</span><span class="token boolean" style="color:#36acaa">false</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token function" style="color:#d73a49">setError</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">null</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token keyword" style="color:#00009f">return</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// 最新のリクエスト以外を中断するための AbortController</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> controller </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> </span><span class="token class-name">AbortController</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> signal </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> controller</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token function" style="color:#d73a49">setLoading</span><span class="token punctuation" style="color:#393A34">(</span><span class="token boolean" style="color:#36acaa">true</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token function" style="color:#d73a49">setError</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">null</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">async</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">function</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">executeSearch</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token keyword" style="color:#00009f">try</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> response </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">await</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">fetch</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token template-string template-punctuation string" style="color:#e3116c">`</span><span class="token template-string string" style="color:#e3116c">/api/search?q=</span><span class="token template-string interpolation interpolation-punctuation punctuation" style="color:#393A34">${</span><span class="token template-string interpolation function" style="color:#d73a49">encodeURIComponent</span><span class="token template-string interpolation punctuation" style="color:#393A34">(</span><span class="token template-string interpolation">trimmedQuery</span><span class="token template-string interpolation punctuation" style="color:#393A34">)</span><span class="token template-string interpolation interpolation-punctuation punctuation" style="color:#393A34">}</span><span class="token template-string template-punctuation string" style="color:#e3116c">`</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> signal </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token keyword" style="color:#00009f">if</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token operator" style="color:#393A34">!</span><span class="token plain">response</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">ok</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token keyword" style="color:#00009f">throw</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> </span><span class="token class-name">Error</span><span class="token punctuation" style="color:#393A34">(</span><span class="token template-string template-punctuation string" style="color:#e3116c">`</span><span class="token template-string string" style="color:#e3116c">HTTPエラー: ステータスコード </span><span class="token template-string interpolation interpolation-punctuation punctuation" style="color:#393A34">${</span><span class="token template-string interpolation">response</span><span class="token template-string interpolation punctuation" style="color:#393A34">.</span><span class="token template-string interpolation">status</span><span class="token template-string interpolation interpolation-punctuation punctuation" style="color:#393A34">}</span><span class="token template-string template-punctuation string" style="color:#e3116c">`</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> json</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> SearchResult </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">await</span><span class="token plain"> response</span><span class="token punctuation" style="color:#393A34">.</span><span class="token function" style="color:#d73a49">json</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token comment" style="color:#999988;font-style:italic">// 中断されていない場合のみ状態を更新</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token keyword" style="color:#00009f">if</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token operator" style="color:#393A34">!</span><span class="token plain">signal</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">aborted</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token function" style="color:#d73a49">setData</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">json</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">items</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">catch</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">err</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">unknown</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token comment" style="color:#999988;font-style:italic">// AbortController による中断は正常なキャンセル処理として無視</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token keyword" style="color:#00009f">if</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">err </span><span class="token keyword" style="color:#00009f">instanceof</span><span class="token plain"> </span><span class="token class-name">Error</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">&amp;&amp;</span><span class="token plain"> err</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">name </span><span class="token operator" style="color:#393A34">===</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">'AbortError'</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token keyword" style="color:#00009f">return</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token keyword" style="color:#00009f">if</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token operator" style="color:#393A34">!</span><span class="token plain">signal</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">aborted</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token function" style="color:#d73a49">setError</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">            err </span><span class="token keyword" style="color:#00009f">instanceof</span><span class="token plain"> </span><span class="token class-name">Error</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">              </span><span class="token operator" style="color:#393A34">?</span><span class="token plain"> err</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">              </span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> </span><span class="token class-name">Error</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">'検索処理中に予期せぬエラーが発生しました'</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">finally</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token keyword" style="color:#00009f">if</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token operator" style="color:#393A34">!</span><span class="token plain">signal</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">aborted</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token function" style="color:#d73a49">setLoading</span><span class="token punctuation" style="color:#393A34">(</span><span class="token boolean" style="color:#36acaa">false</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token function" style="color:#d73a49">executeSearch</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// クリーンアップ処理：クエリ変更時またはアンマウント時に通信を中断</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">return</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=&gt;</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      controller</span><span class="token punctuation" style="color:#393A34">.</span><span class="token function" style="color:#d73a49">abort</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">query</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">return</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> data</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> loading</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> error </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></div></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="boost-によってカバーされた具体的なポイント"><code>/boost</code> によってカバーされた具体的なポイント<a href="https://sawara.me/ko/blog/antigravity-cli-boost-command-refactoring#boost-%E3%81%AB%E3%82%88%E3%81%A3%E3%81%A6%E3%82%AB%E3%83%90%E3%83%BC%E3%81%95%E3%82%8C%E3%81%9F%E5%85%B7%E4%BD%93%E7%9A%84%E3%81%AA%E3%83%9D%E3%82%A4%E3%83%B3%E3%83%88" class="hash-link" aria-label="boost-によってカバーされた具体的なポイント에 대한 직접 링크" title="boost-によってカバーされた具体的なポイント에 대한 직접 링크" translate="no">​</a></h3>
<ol>
<li class=""><strong><code>AbortController</code> によるリクエストの中断</strong>:
クエリが更新されるたび、クリーンアップ関数で直前の通信を中断します。これにより、古い通信の完了待ちがなくなり、最新のクエリに対する結果のみが確実に反映されます。</li>
<li class=""><strong><code>AbortError</code> の適切な除外</strong>:
通信中断時にブラウザが投げる <code>AbortError</code> を捕捉し、これをアプリケーションエラーとして扱わない分岐を設けています。通常指示ではこの区別が見落とされ、画面に「エラーが発生しました」と誤表示されるケースが多く見られます。</li>
<li class=""><strong>入力値のトリム処理と早期リターン</strong>:
スペースのみが入力された場合の不要なAPIリクエストを防止し、ステートを安全に初期化しています。</li>
<li class=""><strong>JSDoc と型安全性の徹底</strong>:
関数の責務、引数、戻り値の型定義が網羅されており、プロジェクトの品質基準を満たす構造になっています。</li>
</ol>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="boost-のデメリットと注意点トレードオフ">/boost のデメリットと注意点（トレードオフ）<a href="https://sawara.me/ko/blog/antigravity-cli-boost-command-refactoring#boost-%E3%81%AE%E3%83%87%E3%83%A1%E3%83%AA%E3%83%83%E3%83%88%E3%81%A8%E6%B3%A8%E6%84%8F%E7%82%B9%E3%83%88%E3%83%AC%E3%83%BC%E3%83%89%E3%82%AA%E3%83%95" class="hash-link" aria-label="/boost のデメリットと注意点（トレードオフ）에 대한 직접 링크" title="/boost のデメリットと注意点（トレードオフ）에 대한 직접 링크" translate="no">​</a></h2>
<p><code>/boost</code> はエッジケースの網羅や堅牢な設計に非常に有効ですが、万能の特効薬ではなく、明確なトレードオフが存在します。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="応答待ち時間レイテンシの増加">応答待ち時間（レイテンシ）の増加<a href="https://sawara.me/ko/blog/antigravity-cli-boost-command-refactoring#%E5%BF%9C%E7%AD%94%E5%BE%85%E3%81%A1%E6%99%82%E9%96%93%E3%83%AC%E3%82%A4%E3%83%86%E3%83%B3%E3%82%B7%E3%81%AE%E5%A2%97%E5%8A%A0" class="hash-link" aria-label="応答待ち時間（レイテンシ）の増加에 대한 직접 링크" title="応答待ち時間（レイテンシ）の増加에 대한 직접 링크" translate="no">​</a></h3>
<p>通常指示では数秒〜十数秒でコードの出力が開始されますが、<code>/boost</code> を適用すると、内部で「潜在リスクの分析」「設計トレードオフの比較」「検証」といった複数の思考プロセス（Extended Thinking）を経由します。そのため、回答の生成完了までに通常の数倍の時間がかかります。テンポよく試行錯誤したい場面では待ち時間がストレスになり得ます。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="トークン消費量とコンテキストウィンドウの圧迫">トークン消費量とコンテキストウィンドウの圧迫<a href="https://sawara.me/ko/blog/antigravity-cli-boost-command-refactoring#%E3%83%88%E3%83%BC%E3%82%AF%E3%83%B3%E6%B6%88%E8%B2%BB%E9%87%8F%E3%81%A8%E3%82%B3%E3%83%B3%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E3%82%A6%E3%82%A3%E3%83%B3%E3%83%89%E3%82%A6%E3%81%AE%E5%9C%A7%E8%BF%AB" class="hash-link" aria-label="トークン消費量とコンテキストウィンドウの圧迫에 대한 직접 링크" title="トークン消費量とコンテキストウィンドウの圧迫에 대한 직접 링크" translate="no">​</a></h3>
<p>思考プロセス自体に大量のトークン（Thinking トークン）が消費されるほか、多角的な検討ログや詳細な型定義、テスト観点なども出力されるため、1回の指示で消費されるトークン数が通常指示の数倍〜十数倍に跳ね上がります。
これにより、APIの利用枠やレートリミット（TPM / RPM）を急激に消費しやすくなるほか、チャットセッション全体のコンテキスト上限に早く到達してしまう点に注意が必要です。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="オーバーエンジニアリング過剰設計のリスク">オーバーエンジニアリング（過剰設計）のリスク<a href="https://sawara.me/ko/blog/antigravity-cli-boost-command-refactoring#%E3%82%AA%E3%83%BC%E3%83%90%E3%83%BC%E3%82%A8%E3%83%B3%E3%82%B8%E3%83%8B%E3%82%A2%E3%83%AA%E3%83%B3%E3%82%B0%E9%81%8E%E5%89%B0%E8%A8%AD%E8%A8%88%E3%81%AE%E3%83%AA%E3%82%B9%E3%82%AF" class="hash-link" aria-label="オーバーエンジニアリング（過剰設計）のリスク에 대한 직접 링크" title="オーバーエンジニアリング（過剰設計）のリスク에 대한 직접 링크" translate="no">​</a></h3>
<p>「ボタンのスタイルを調整する」「型のプロパティを1つ足す」「タイポを直す」といった単純な定型作業に <code>/boost</code> を使用すると、不要な抽象化レイヤーや過度な防御的プログラミング、複雑な例外ハンドリングが導入され、かえってコードの見通しや保守性を損ねる（YAGNI原則に反する）可能性があります。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="boost-を使い分けるポイント">/boost を使い分けるポイント<a href="https://sawara.me/ko/blog/antigravity-cli-boost-command-refactoring#boost-%E3%82%92%E4%BD%BF%E3%81%84%E5%88%86%E3%81%91%E3%82%8B%E3%83%9D%E3%82%A4%E3%83%B3%E3%83%88" class="hash-link" aria-label="/boost を使い分けるポイント에 대한 직접 링크" title="/boost を使い分けるポイント에 대한 직접 링크" translate="no">​</a></h2>
<p>これらのトレードオフを踏まえ、タスクの難易度や性質に応じて通常指示と使い分けることが肝要です。</p>
<p>タスクの特性に応じて使い分けることが効率的です。</p>
<table><thead><tr><th style="text-align:left">指示タイプ</th><th style="text-align:left">適した作業内容</th><th style="text-align:left">例</th></tr></thead><tbody><tr><td style="text-align:left"><strong>通常指示</strong></td><td style="text-align:left">定型的なUI作成、単純なCRUD操作、テキストの編集、単一の明確な関数実装</td><td style="text-align:left">「ボタンのスタイルを変更して」「Propsの型を追加して」</td></tr><tr><td style="text-align:left"><strong>/boost</strong></td><td style="text-align:left">並行処理や非同期競合の制御、複雑な状態遷移の設計、難度の高いバグ修正、アーキテクチャ設計</td><td style="text-align:left">「状態管理ロジックのリファクタリング」「エッジケースを含めたAPIクライアントの実装」</td></tr></tbody></table>
<p>また、<code>/boost</code> を使用する際は、懸念している観点をプロンプトに一言添えると、さらに精度の高い分析が行われます。</p>
<p><strong>効果的なプロンプトの例:</strong></p>
<blockquote>
<p><code>/boost このキャッシュ管理クラスの並行アクセス制御をレビューしてください。デッドロックのリスクや、メモリリークの可能性について多角的に検証し、改善案を提示してください。</code></p>
</blockquote>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="まとめ">まとめ<a href="https://sawara.me/ko/blog/antigravity-cli-boost-command-refactoring#%E3%81%BE%E3%81%A8%E3%82%81" class="hash-link" aria-label="まとめ에 대한 직접 링크" title="まとめ에 대한 직접 링크" translate="no">​</a></h2>
<p>コード生成AIの利用において、「一見動いているがエッジケースで破綻するコード」のレビューは開発者の大きな負担となります。</p>
<p>Antigravity CLI の <code>/boost</code> コマンドを活用することで、エージェント側で事前に潜在リスクの洗い出しとトレードオフの比較が行われ、手戻りの少ない堅牢なコードを導出できました。</p>
<p>設計の堅牢性や品質が重視される局面では、通常の指示に <code>/boost</code> を組み合わせるアプローチが有効であると考えられます。</p>]]></content:encoded>
            <category>Antigravity</category>
            <category>CLI</category>
            <category>AI</category>
            <category>リファクタリング</category>
            <category>TypeScript</category>
            <category>React</category>
        </item>
        <item>
            <title><![CDATA[Antigravity CLI の /teamwork-preview で複数の自律エージェントを連携させる実践ガイド]]></title>
            <link>https://sawara.me/ko/blog/antigravity-cli-teamwork-preview</link>
            <guid>https://sawara.me/ko/blog/antigravity-cli-teamwork-preview</guid>
            <pubDate>Sat, 22 Aug 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[大規模な機能開発やリファクタリングを1つのエージェントにまとめて依頼すると、会話履歴（コンテキスト）が過度に肥大化して回答の精度が低下したり、タスクが順次処理されることで全体の待ち時間が長くなったりすることがあります。]]></description>
            <content:encoded><![CDATA[<p>大規模な機能開発やリファクタリングを1つのエージェントにまとめて依頼すると、会話履歴（コンテキスト）が過度に肥大化して回答の精度が低下したり、タスクが順次処理されることで全体の待ち時間が長くなったりすることがあります。</p>
<p>Antigravity CLI に搭載されている <code>/teamwork-preview</code> コマンドを使用すると、タスクを複数の専門サブエージェントに自動分割し、並行して作業を進めるチーム型のワークフローを構築できます。本記事では、この機能を活用して複数レイヤーの開発タスクを分担・並行処理させる具体的な実践方法を紹介します。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="チーム連携teamwork-previewの仕組み">チーム連携（/teamwork-preview）の仕組み<a href="https://sawara.me/ko/blog/antigravity-cli-teamwork-preview#%E3%83%81%E3%83%BC%E3%83%A0%E9%80%A3%E6%90%BAteamwork-preview%E3%81%AE%E4%BB%95%E7%B5%84%E3%81%BF" class="hash-link" aria-label="チーム連携（/teamwork-preview）の仕組み에 대한 직접 링크" title="チーム連携（/teamwork-preview）の仕組み에 대한 직접 링크" translate="no">​</a></h2>
<p><code>/teamwork-preview</code> は、通常のターミナルコマンドではなく、<strong>Antigravity CLI の対話画面（チャットインターフェース）内</strong> で実行するスラッシュコマンドです。</p>
<p>単一のエージェントがすべての作業を順番に行う従来の方式とは異なり、全体の進行を管理するエージェントがタスクを分析し、独立して実行可能な複数のサブエージェントをバックグラウンドで起動します。</p>
<!-- -->
<p>各サブエージェントは専用のプロンプトとツールセットを持ち、独立したワークスペース（ブランチや専用ディレクトリ）上で動作します。</p>
<p>エージェントごとに作業空間とコンテキストが切り離されるため、不要なファイル情報でコンテキスト上限を圧迫して回答精度が落ちる心配がありません。また、UIの実装、ロジック作成、テストコードの作成をすべて同時に進められるため、全体の所要時間を大幅に短縮できます。作業ディレクトリやブランチが分かれていることで、同一ファイルの編集による競合や意図しない上書きが発生しない点も大きなメリットです。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="実践例webツールの開発における役割分担">実践例：Webツールの開発における役割分担<a href="https://sawara.me/ko/blog/antigravity-cli-teamwork-preview#%E5%AE%9F%E8%B7%B5%E4%BE%8Bweb%E3%83%84%E3%83%BC%E3%83%AB%E3%81%AE%E9%96%8B%E7%99%BA%E3%81%AB%E3%81%8A%E3%81%91%E3%82%8B%E5%BD%B9%E5%89%B2%E5%88%86%E6%8B%85" class="hash-link" aria-label="実践例：Webツールの開発における役割分担에 대한 직접 링크" title="実践例：Webツールの開発における役割分担에 대한 직접 링크" translate="no">​</a></h2>
<p>ここでは、「正規表現チェッカー」を新規作成するケースを例に、<code>/teamwork-preview</code> によるチーム編成と作業の流れを整理します。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="コマンドの実行">コマンドの実行<a href="https://sawara.me/ko/blog/antigravity-cli-teamwork-preview#%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89%E3%81%AE%E5%AE%9F%E8%A1%8C" class="hash-link" aria-label="コマンドの実行에 대한 직접 링크" title="コマンドの実行에 대한 직접 링크" translate="no">​</a></h3>
<p>Antigravity CLI の対話画面で、目的とする開発内容を添えてコマンドを入力します。</p>
<p><strong>入力例:</strong></p>
<blockquote>
<p><code>/teamwork-preview ツール集に「正規表現チェッカー」を追加してください。正規表現とチェックするテキストの2つの入力欄を用意して、テキストが正規表現にマッチしているかどうかチェックする機能です。よくある正規表現のテンプレートも追加してください。Reactコンポーネント、ロジックと単体テスト、多言語辞書の登録および仕様書作成を並行して実装してください。</code></p>
</blockquote>
<p>コマンドを実行すると、まずエージェント側から要件や開発方針に関する質問が行われます。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="マッチング結果表示についての質問" src="https://sawara.me/ko/assets/images/antigravity-cli-teamwork-preview_001-068e26afa9df176169f536dec594b42a.webp" width="2410" height="470" class="img_ev3q">
<small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">対話画面での要件確認。ハイライト表示やキャプチャグループの対応レベルを選択します。</small></p></div>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="開発制限・インテグリティ方針の確認" src="https://sawara.me/ko/assets/images/antigravity-cli-teamwork-preview_002-2a94ff274e33e96c4596be2eb3f479d8.webp" width="2410" height="530" class="img_ev3q">
<small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">ライブラリの利用方針や既存ソース参照の可否など、開発制限を選択します。</small></p></div>
<p>質問への回答が終わると、チーム編成と各サブエージェントへの指示内容（<code>prompt_draft.md</code>）が生成され、承認（approve）を求められます。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="プロンプト案の確認と承認" src="https://sawara.me/ko/assets/images/antigravity-cli-teamwork-preview_003-88f10812551f9e08c2467ef6bd77461f.webp" width="2420" height="362" class="img_ev3q">
<small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">生成されたプロンプト案（prompt_draft.md）の内容を確認し、承認します。</small></p></div>
<p>承認を行うと、オーケストレーターと複数のサブエージェントがバックグラウンドで並行起動し、作業が開始されます。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="エージェントチームの起動と並行作業" src="https://sawara.me/ko/assets/images/antigravity-cli-teamwork-preview_004-45b05d1b67feb6155be60c882d7f1d04.webp" width="2414" height="782" class="img_ev3q">
<small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">サブエージェントが並行起動し、調査や実装、テストが進められます。</small></p></div>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="チーム編成と各エージェントの担当領域">チーム編成と各エージェントの担当領域<a href="https://sawara.me/ko/blog/antigravity-cli-teamwork-preview#%E3%83%81%E3%83%BC%E3%83%A0%E7%B7%A8%E6%88%90%E3%81%A8%E5%90%84%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88%E3%81%AE%E6%8B%85%E5%BD%93%E9%A0%98%E5%9F%9F" class="hash-link" aria-label="チーム編成と各エージェントの担当領域에 대한 직접 링크" title="チーム編成と各エージェントの担当領域에 대한 직접 링크" translate="no">​</a></h3>
<p>このユースケースでは、主に以下の4つの役割にタスクが分割されます。</p>
<table><thead><tr><th style="text-align:left">役割名</th><th style="text-align:left">主な担当作業</th><th style="text-align:left">主な利用ツール</th></tr></thead><tbody><tr><td style="text-align:left"><strong>進行管理（オーケストレーター）</strong></td><td style="text-align:left">仕様定義の整理、各サブエージェントへの指示出し、進捗監視、最終マージ</td><td style="text-align:left">エージェント管理ツール、メッセージ送受信</td></tr><tr><td style="text-align:left"><strong>フロントエンド担当</strong></td><td style="text-align:left">正規表現・テスト文字列の入力フォーム、マッチ結果やハイライト表示UIの実装</td><td style="text-align:left">ファイル作成・編集ツール</td></tr><tr><td style="text-align:left"><strong>ロジック・テスト担当</strong></td><td style="text-align:left">正規表現マッチング・バリデーション処理の実装、単体テストの作成</td><td style="text-align:left">ファイル編集、テスト実行コマンド</td></tr><tr><td style="text-align:left"><strong>多言語・ドキュメント担当</strong></td><td style="text-align:left">日英の辞書ファイル（i18n）へのテキスト登録、仕様書マークダウンの作成</td><td style="text-align:left">ファイル編集ツール</td></tr></tbody></table>
<p>各エージェントは独立して動作し、完了したタスクから順次、進行管理エージェントへと結果を通知します。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="指示出しプロンプト設計のポイント">指示出し（プロンプト設計）のポイント<a href="https://sawara.me/ko/blog/antigravity-cli-teamwork-preview#%E6%8C%87%E7%A4%BA%E5%87%BA%E3%81%97%E3%83%97%E3%83%AD%E3%83%B3%E3%83%97%E3%83%88%E8%A8%AD%E8%A8%88%E3%81%AE%E3%83%9D%E3%82%A4%E3%83%B3%E3%83%88" class="hash-link" aria-label="指示出し（プロンプト設計）のポイント에 대한 직접 링크" title="指示出し（プロンプト設計）のポイント에 대한 직접 링크" translate="no">​</a></h2>
<p>チーム連携を円滑に機能させるためには、エージェント間の作業境界と入出力の定義をあらかじめ明確にしておくことが重要です。</p>
<p>たとえばUI担当とロジック担当が連携する場合、関数の引数や戻り値といった型定義を事前に決めておくことで、後から成果物を結合する際の不整合を防げます。また、各サブエージェントが編集する対象ディレクトリやファイルを最初から分けておくと、マージ作業の自動化もスムーズになります。</p>
<p>さらに、ロジック担当には単体テストの実行、ドキュメント担当にはビルド確認といったように、各担当が個別に完了を判定できる検証手順を指示に含めておくと、手戻りを最小限に抑えられます。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="進捗のモニタリングと成果物の統合">進捗のモニタリングと成果物の統合<a href="https://sawara.me/ko/blog/antigravity-cli-teamwork-preview#%E9%80%B2%E6%8D%97%E3%81%AE%E3%83%A2%E3%83%8B%E3%82%BF%E3%83%AA%E3%83%B3%E3%82%B0%E3%81%A8%E6%88%90%E6%9E%9C%E7%89%A9%E3%81%AE%E7%B5%B1%E5%90%88" class="hash-link" aria-label="進捗のモニタリングと成果物の統合에 대한 직접 링크" title="進捗のモニタリングと成果物の統合에 대한 직접 링크" translate="no">​</a></h2>
<p>チーム連携が開始されると、対話画面には各サブエージェントが現在どのツールを実行しているか、あるいは完了待ちの状態かがリアルタイムで表示されます。</p>
<p>独立したワークスペース上で作業が進むため、途中でコミットされた変更差分を個別に確認することも可能です。すべてのサブエージェントがタスクを完了すると、進行管理エージェントがそれぞれの変更をメインブランチにマージし、型チェック（<code>yarn typecheck</code> など）やテストを実行して全体の整合性を自動で検証します。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="単一エージェントとの使い分け基準">単一エージェントとの使い分け基準<a href="https://sawara.me/ko/blog/antigravity-cli-teamwork-preview#%E5%8D%98%E4%B8%80%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88%E3%81%A8%E3%81%AE%E4%BD%BF%E3%81%84%E5%88%86%E3%81%91%E5%9F%BA%E6%BA%96" class="hash-link" aria-label="単一エージェントとの使い分け基準에 대한 직접 링크" title="単一エージェントとの使い分け基準에 대한 직접 링크" translate="no">​</a></h2>
<p>すべてのタスクでチーム連携を使用することが最適とは限りません。開発の規模や性質に応じて、単一エージェントでの対話と <code>/teamwork-preview</code> を適切に使い分けることが重要です。</p>
<table><thead><tr><th style="text-align:left">比較項目</th><th style="text-align:left">単一エージェント（通常対話）</th><th style="text-align:left">チーム連携（/teamwork-preview）</th></tr></thead><tbody><tr><td style="text-align:left"><strong>適したタスク規模</strong></td><td style="text-align:left">単一コンポーネントの修正、小規模なバグ修正</td><td style="text-align:left">複数レイヤーにまたがる機能追加、大規模リファクタリング</td></tr><tr><td style="text-align:left"><strong>実行速度</strong></td><td style="text-align:left">順次実行（小規模タスクでは最速）</td><td style="text-align:left">並行実行（大規模タスク全体の所要時間を短縮）</td></tr><tr><td style="text-align:left"><strong>コンテキスト管理</strong></td><td style="text-align:left">1つの会話履歴ですべてを保持</td><td style="text-align:left">各タスクに必要なコンテキストのみに分離</td></tr><tr><td style="text-align:left"><strong>トークン消費量</strong></td><td style="text-align:left">最小限に抑制可能</td><td style="text-align:left">複数エージェントが並行稼働するため相対的に増加</td></tr></tbody></table>
<p>日常的な細かな調整には通常の単一エージェントを用い、構造が明確で複数領域に分割可能な大規模タスクには <code>/teamwork-preview</code> を選択するアプローチが効果的であると考えられます。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="まとめ">まとめ<a href="https://sawara.me/ko/blog/antigravity-cli-teamwork-preview#%E3%81%BE%E3%81%A8%E3%82%81" class="hash-link" aria-label="まとめ에 대한 직접 링크" title="まとめ에 대한 직접 링크" translate="no">​</a></h2>
<p>Antigravity CLI の <code>/teamwork-preview</code> を活用することで、複雑な開発タスクを専門エージェントに分散し、並行して安全に進める環境が整います。</p>
<p>開発の規模やタスクの独立性を見極めながら適切なワークフローを選択することが、開発プロセスの効率化につながります。</p>]]></content:encoded>
            <category>Antigravity</category>
            <category>CLI</category>
            <category>AI</category>
            <category>チーム開発</category>
            <category>開発効率化</category>
        </item>
        <item>
            <title><![CDATA[Antigravity CLI の /learn コマンドで実現する、AIアシスタントの「ルール化」の実践例]]></title>
            <link>https://sawara.me/ko/blog/antigravity-cli-learn-command</link>
            <guid>https://sawara.me/ko/blog/antigravity-cli-learn-command</guid>
            <pubDate>Sun, 26 Jul 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[AIアシスタントに毎回同じような指示を出したり、過去と同じミスを繰り返されて非効率に感じた経験はないでしょうか。]]></description>
            <content:encoded><![CDATA[<p>AIアシスタントに毎回同じような指示を出したり、過去と同じミスを繰り返されて非効率に感じた経験はないでしょうか。</p>
<p>Antigravity CLI に搭載されている <code>/learn</code> コマンドを使用すると、AIにプロジェクト固有の文脈や暗黙のルールを定着させることができます。本記事では、この機能を活用して回答精度を向上させ、継続的に開発効率を高める具体的な実践例を紹介します。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="失敗からの学習">失敗からの学習<a href="https://sawara.me/ko/blog/antigravity-cli-learn-command#%E5%A4%B1%E6%95%97%E3%81%8B%E3%82%89%E3%81%AE%E5%AD%A6%E7%BF%92" class="hash-link" aria-label="失敗からの学習에 대한 직접 링크" title="失敗からの学習에 대한 직접 링크" translate="no">​</a></h2>
<p>開発を進める中で、AIがデザインのズレを引き起こしたり、予期せぬビルドエラーに繋がるコードを生成したりすることがあります。このような場合、人間が手動で修正を加えた直後に Gemini CLI の対話画面で <code>/learn</code> コマンドを実行することが有効です。</p>
<p><strong>入力例:</strong></p>
<blockquote>
<p><code>/learn 先ほどのUIの崩れは、CSSモジュールのクラス名の当て方が誤っていたためです。次回以降は必ず既存のスタイル定義に沿ってクラスを適用してください</code></p>
</blockquote>
<p>これにより、プロジェクト固有の挙動や回避策がルールとして保存されます。次回以降、AIは関連タスクを処理する際にそのルールを参照するため、同じミスの発生を防ぐことができます。エラーの再発防止をシステム的に解決できるため、確認の手間が大幅に削減されます。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="コーディングスタイルの統一">コーディングスタイルの統一<a href="https://sawara.me/ko/blog/antigravity-cli-learn-command#%E3%82%B3%E3%83%BC%E3%83%87%E3%82%A3%E3%83%B3%E3%82%B0%E3%82%B9%E3%82%BF%E3%82%A4%E3%83%AB%E3%81%AE%E7%B5%B1%E4%B8%80" class="hash-link" aria-label="コーディングスタイルの統一에 대한 직접 링크" title="コーディングスタイルの統一에 대한 직접 링크" translate="no">​</a></h2>
<p>プロジェクトには「コメントやドキュメントは必ず日本語にする」「コンポーネントは Functional Component で統一する」といった独自の規約が存在することがあります。</p>
<p>これらのコーディングスタイルや個人の設定も、 <code>/learn</code> コマンドを通じてルール化することが可能です。</p>
<p><strong>入力例:</strong></p>
<blockquote>
<p><code>/learn 今後 MUI の Button コンポーネントを使用する際は、プロジェクトのトンマナに合わせるため、必ず variant='contained' disableElevation をデフォルト設定にしてください</code></p>
</blockquote>
<p>一度設定ファイルとして保存されると、以降はプロンプトで明示的に指示を与えなくても、自動的に規約に沿ったコードが生成されます。チーム全体で統一されたフォーマットを維持する上で役立ちます。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="新しい仕様や独自設計の適用">新しい仕様や独自設計の適用<a href="https://sawara.me/ko/blog/antigravity-cli-learn-command#%E6%96%B0%E3%81%97%E3%81%84%E4%BB%95%E6%A7%98%E3%82%84%E7%8B%AC%E8%87%AA%E8%A8%AD%E8%A8%88%E3%81%AE%E9%81%A9%E7%94%A8" class="hash-link" aria-label="新しい仕様や独自設計の適用에 대한 직접 링크" title="新しい仕様や独自設計の適用에 대한 직접 링크" translate="no">​</a></h2>
<p>新規に追加したライブラリの使い方や、プロジェクト独自のディレクトリ構成といった新しい前提条件も、 <code>/learn</code> 経由で共有できます。</p>
<p><strong>入力例:</strong></p>
<blockquote>
<p><code>/learn 新しいWebツールを作成する際、画像やPDFなどのファイルはサーバーへ送信せず、必ずブラウザの Canvas API や Web Worker を使って完全ローカルで処理してください</code></p>
</blockquote>
<p>外部のナレッジや新しい設計思想をローカルのルールとして定着させることで、AIの出力を最新の状態に適応させます。これにより、古い仕様に基づいたコードが提案されることを防ぎ、即座にプロジェクト全体へ新しい方針を適用させることができます。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="コマンドの実行例とルールの保存先">コマンドの実行例とルールの保存先<a href="https://sawara.me/ko/blog/antigravity-cli-learn-command#%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89%E3%81%AE%E5%AE%9F%E8%A1%8C%E4%BE%8B%E3%81%A8%E3%83%AB%E3%83%BC%E3%83%AB%E3%81%AE%E4%BF%9D%E5%AD%98%E5%85%88" class="hash-link" aria-label="コマンドの実行例とルールの保存先에 대한 직접 링크" title="コマンドの実行例とルールの保存先에 대한 직접 링크" translate="no">​</a></h2>
<p><code>/learn</code> コマンドで指示を実行すると、AIが内容を解釈しルール化する内容の提案を行います。提案の内容は <code>/artifact</code> コマンドで確認が可能で、<code>approve</code> することでワークスペース内の <code>.agents/rules/</code> ディレクトリ配下にマークダウン形式のルールファイル（例：<code>coding-guidelines.md</code> など）として自動生成または更新されます。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="/learn コマンドの実行" src="https://sawara.me/ko/assets/images/antigravity-cli-learn-command_001-6402ace1ee5a234c06eebf952f99e34e.webp" width="1500" height="308" class="img_ev3q">
<small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">/learn コマンドの実行画面。提案が作成されるので、/artifact コマンドで内容を確認できます。</small></p></div>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="提案内容" src="https://sawara.me/ko/assets/images/antigravity-cli-learn-command_002-b5aa713a9a8df083ed43c864052010d1.webp" width="1510" height="413" class="img_ev3q">
<small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">提案内容の確認。既存の.agents/rules/design-guide.mdへの更新が提案されています。</small></p></div>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="提案のapprove" src="data:image/webp;base64,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" width="827" height="82" class="img_ev3q">
<small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">/artifact コマンドで approve を選択すれば反映されます。</small></p></div>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="すでにルール化されているものは学習されない" src="https://sawara.me/ko/assets/images/antigravity-cli-learn-command_004-9cf3569aef44dfed7dd07eb2d4651ce7.webp" width="1379" height="251" class="img_ev3q">
<small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">すでにルール化されているものは学習されない。</small></p></div>
<p>保存されたルールファイルは Git などのバージョン管理システムにコミットできるため、チームの他のメンバーが開発に参加した際にも、それぞれのAIアシスタントが同じルールセットを参照して一貫したサポートを行うことが可能になります。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="まとめ">まとめ<a href="https://sawara.me/ko/blog/antigravity-cli-learn-command#%E3%81%BE%E3%81%A8%E3%82%81" class="hash-link" aria-label="まとめ에 대한 직접 링크" title="まとめ에 대한 직접 링크" translate="no">​</a></h2>
<p><code>/learn</code> コマンドを活用することで、対話から生まれたルールがファイルとして保存・共有されます。なお、チャットの会話履歴自体は引き継がれませんが、永続化されたルールを通じて、AIはプロジェクトに適合した開発支援ツールとして機能するようになります。</p>
<p>実際のチャットインターフェースで <code>/learn</code> を実行し、小さなルールから設定を追加していくことで、その効果を検証できます。</p>]]></content:encoded>
            <category>Antigravity</category>
            <category>CLI</category>
            <category>AI</category>
            <category>開発効率化</category>
        </item>
        <item>
            <title><![CDATA[AIの逆インタビューで要件定義から実装までを完遂する（Antigravity/grill-me の実践）]]></title>
            <link>https://sawara.me/ko/blog/antigravity-cli-grill-me-workflow</link>
            <guid>https://sawara.me/ko/blog/antigravity-cli-grill-me-workflow</guid>
            <pubDate>Sat, 18 Jul 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[AIエージェントに自律的なコーディングを依頼する際、もっとも高いハードルとなるのが「要件定義（プロンプトの作成）」です。アイデアは頭にあっても、それを抜け漏れのない仕様書に落とし込むのは人間にとって骨の折れる作業です。]]></description>
            <content:encoded><![CDATA[<p>AIエージェントに自律的なコーディングを依頼する際、もっとも高いハードルとなるのが「要件定義（プロンプトの作成）」です。アイデアは頭にあっても、それを抜け漏れのない仕様書に落とし込むのは人間にとって骨の折れる作業です。</p>
<p>Antigravity CLI には、この問題を解決する強力なスラッシュコマンド <code>/grill-me</code> が搭載されています。人間が仕様を書き出すのではなく、AI側から人間に「質問攻め（逆インタビュー）」を行わせることで、曖昧なアイデアから仕様を固め、そのまま実装（自動コーディング）までを一気通貫で完遂させる機能です。</p>
<p>本記事では、この <code>/grill-me</code> を使って実際に当サイト（sawara.me）の新しいツール機能を追加した際の実践ログを通じ、AIによる要件定義の具体的なワークフローを紹介します。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="step-1-アイデア出し">STEP 1: アイデア出し<a href="https://sawara.me/ko/blog/antigravity-cli-grill-me-workflow#step-1-%E3%82%A2%E3%82%A4%E3%83%87%E3%82%A2%E5%87%BA%E3%81%97" class="hash-link" aria-label="STEP 1: アイデア出し에 대한 직접 링크" title="STEP 1: アイデア出し에 대한 직접 링크" translate="no">​</a></h2>
<p>新しいWebツールを追加しようと思い立ったものの、具体的なアイデアが固まっていなかったため、まずは <code>/grill-me このプロジェクトのツール集に何か新しいツールを追加したいです。</code> とだけ伝えました。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="機能追加依頼" src="data:image/webp;base64,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" width="638" height="64" class="img_ev3q">
<small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">AIに何かツールを追加したいと伝えてみる</small></p></div>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="ツールアイデアの提案" src="https://sawara.me/ko/assets/images/antigravity-cli-grill-me-workflow_001-47f6be741dc293ef272fae0c7d3015b1.webp" width="1015" height="284" class="img_ev3q">
<small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">AIからの初期提案（JSONフォーマッターやBase64エンコーダーなど）</small></p></div>
<p>すると、AI側から「プロジェクトのコンセプトに合いそうなツール候補」がいくつか提案されました。今回は、推奨された「JSONフォーマッター / バリデーター」を作成対象として選択しました。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="step-2-要件の深掘り">STEP 2: 要件の深掘り<a href="https://sawara.me/ko/blog/antigravity-cli-grill-me-workflow#step-2-%E8%A6%81%E4%BB%B6%E3%81%AE%E6%B7%B1%E6%8E%98%E3%82%8A" class="hash-link" aria-label="STEP 2: 要件の深掘り에 대한 직접 링크" title="STEP 2: 要件の深掘り에 대한 직접 링크" translate="no">​</a></h2>
<p>ツールの大枠が決まると、AIは即座に「それを実装するために決めなければならない技術的仕様」を洗い出し、ひとつずつ選択式で質問してきます。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="機能要件の質問" src="https://sawara.me/ko/assets/images/antigravity-cli-grill-me-workflow_002-fe17759c58c705e282821bdd77f5c7e4.webp" width="832" height="278" class="img_ev3q">
<small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">搭載する機能の取捨選択（ファイル入出力やツリー表示など）</small></p></div>
<p>次に、プロジェクトの既存ルール（状態のURL同期）を踏まえた仕様の確認がありました。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="状態管理の質問" src="https://sawara.me/ko/assets/images/antigravity-cli-grill-me-workflow_003-3bed7c81f6dcdf09d1cfdc8c23317e26.webp" width="1346" height="249" class="img_ev3q">
<small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">URL文字数制限への懸念と代替案（LocalStorage管理）の提示</small></p></div>
<p>他のツールでは入力したパラメーターをURLに反映して、そのURLをブックマークすれば、同じ入力状態を復元できるようにしています。
このルールを参考にAIが先回りして「JSONデータはサイズが大きくURL文字数制限を超えるリスクがある」という技術的懸念事項を提示してきました。
今回はJSONデータをURLに同期する必要はないので、「すべてLocalStorageのみで管理する」を選択しました。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="レイアウトとライブラリの質問" src="https://sawara.me/ko/assets/images/antigravity-cli-grill-me-workflow_004-5a38755d7b5028d9ea0504eb4441757e.webp" width="1115" height="260" class="img_ev3q">
<small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">レイアウト方針の決定（タブ切り替え式）</small></p></div>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="レイアウトとライブラリの質問2" src="https://sawara.me/ko/assets/images/antigravity-cli-grill-me-workflow_005-122f0c45b6388982c2d5781e049bf7dc.webp" width="1039" height="246" class="img_ev3q">
<small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">外部ライブラリ（react-json-view等）導入の許可確認</small></p></div>
<p>その後も、UIレイアウト（タブ式）や、パッケージ依存関係を増やすことへの許可（<code>react-json-view</code> 等の導入可否）など、実装に入る前に確認が必要な事項を確認していきます。</p>
<p>人間が仕様書に書く際に落としがちな箇所をAIが的確にフォローしてくれる印象です。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="step-3-仕様変更にも対応">STEP 3: 仕様変更にも対応<a href="https://sawara.me/ko/blog/antigravity-cli-grill-me-workflow#step-3-%E4%BB%95%E6%A7%98%E5%A4%89%E6%9B%B4%E3%81%AB%E3%82%82%E5%AF%BE%E5%BF%9C" class="hash-link" aria-label="STEP 3: 仕様変更にも対応에 대한 직접 링크" title="STEP 3: 仕様変更にも対応에 대한 직접 링크" translate="no">​</a></h2>
<p>すべての質問に回答すると、AIはこれまでの対話をまとめ、最終的な「仕様書（要件定義）」を提示してきます。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="仕様の最終確認" src="https://sawara.me/ko/assets/images/antigravity-cli-grill-me-workflow_006-8a018d396700545718772a852f01fc19.webp" width="986" height="373" class="img_ev3q">
<small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">要件定義のサマリ提示と実装開始の確認</small></p></div>
<p>通常であればここで「はい」と答えて実装を開始させますが、今回は「いいえ、まだ変更・追加したい点があります」を選択してみました。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="追加要望のヒアリング" src="https://sawara.me/ko/assets/images/antigravity-cli-grill-me-workflow_007-049123b3cd82b755c2cc3a0320fb53fe.webp" width="1005" height="271" class="img_ev3q">
<small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">型定義生成など、機能追加の提案</small></p></div>
<p>すると、AI側から「JSONからTypeScriptの型定義を自動生成する機能を追加したい」という追加アイデアが選択肢として提示されたため、この提案を採用することにしました。
これにより、TypeScript型定義の自動生成機能（<code>json-to-ts</code> の活用など）を含む新しいアプローチが取り込まれ、仕様書全体が再構築されました。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="仕様の再確認" src="https://sawara.me/ko/assets/images/antigravity-cli-grill-me-workflow_008-90c6e5141a49d0b4e17b8879473f8f91.webp" width="1230" height="392" class="img_ev3q">
<small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">追加要件を取り込んだ最終仕様の確定</small></p></div>
<p>このように、要件定義の最中に発生した仕様変更であっても、会話の流れを維持したまま自然に仕様全体へと反映・調整させることができました。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="step-4-仕様確定から自動コーディングへ">STEP 4: 仕様確定から自動コーディングへ<a href="https://sawara.me/ko/blog/antigravity-cli-grill-me-workflow#step-4-%E4%BB%95%E6%A7%98%E7%A2%BA%E5%AE%9A%E3%81%8B%E3%82%89%E8%87%AA%E5%8B%95%E3%82%B3%E3%83%BC%E3%83%87%E3%82%A3%E3%83%B3%E3%82%B0%E3%81%B8" class="hash-link" aria-label="STEP 4: 仕様確定から自動コーディングへ에 대한 직접 링크" title="STEP 4: 仕様確定から自動コーディングへ에 대한 직접 링크" translate="no">​</a></h2>
<p>最終仕様に合意して「はい、この仕様で実装を開始してください」を選択すると、AIは確定した要件をもとに即座にコーディングフェーズへと移行します。
人間が書いた曖昧なプロンプトではなく、AI自身が質問を通じて納得するまで固めた「完璧な仕様書」をベースに実装が進むため、手戻りや設計の破綻がほとんど発生しません。</p>
<p>実際にこのワークフローを経て、AIに完全自動で作成してもらったツールがこちらです。</p>
<ul>
<li class=""><strong><a class="" href="https://sawara.me/ko/tools/json-formatter">JSONフォーマッター ＆ バリデーター</a></strong>
（リアルタイム整形からTypeScriptの型定義生成まで、すべてブラウザ上で完結します）</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="まとめ">まとめ<a href="https://sawara.me/ko/blog/antigravity-cli-grill-me-workflow#%E3%81%BE%E3%81%A8%E3%82%81" class="hash-link" aria-label="まとめ에 대한 직접 링크" title="まとめ에 대한 직접 링크" translate="no">​</a></h2>
<p>本記事では、Antigravity CLI の <code>/grill-me</code> コマンドを用いた要件定義のワークフローを紹介しました。</p>
<ul>
<li class=""><strong>人間の負担軽減</strong>: 白紙からプロンプトを書く必要がなくなり、AIの質問に答えていくだけで要件がまとまる。</li>
<li class=""><strong>技術的懸念の先回り</strong>: 人間が見落としがちなエラー要因（データ長の超過や依存関係の追加など）をAIが事前にチェックしてくれる。</li>
<li class=""><strong>柔軟な仕様変更</strong>: 途中で新しいアイデアを思いついても、対話を通じて自然に設計をアップデートできる。</li>
</ul>
<p>仕様書を頑張って書いてからAIに「コードを書いて」と依頼するのではなく、まずは <code>/grill-me</code> で要件を徹底的に壁打ちさせることで、設計から実装までを一気通貫で任せられる高品質な自動コーディングを実践できると感じました。</p>]]></content:encoded>
            <category>AI</category>
            <category>Antigravity</category>
            <category>Workflow</category>
            <category>Requirements</category>
        </item>
        <item>
            <title><![CDATA[Antigravity CLIの /schedule コマンドによる非同期タスク管理]]></title>
            <link>https://sawara.me/ko/blog/antigravity-cli-schedule-command</link>
            <guid>https://sawara.me/ko/blog/antigravity-cli-schedule-command</guid>
            <pubDate>Sat, 27 Jun 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Antigravity CLIでは、ビルド処理やテストの実行など、時間のかかるタスクをAIエージェントに依頼することがよくあります。しかし、通常の同期処理では、タスクが完了するまでエージェントの応答がブロックされてしまい、その間他の指示を出すことができません。]]></description>
            <content:encoded><![CDATA[<p>Antigravity CLIでは、ビルド処理やテストの実行など、時間のかかるタスクをAIエージェントに依頼することがよくあります。しかし、通常の同期処理では、タスクが完了するまでエージェントの応答がブロックされてしまい、その間他の指示を出すことができません。</p>
<p>このような非同期タスクの監視や定期実行を効率化するために用意されているのが、Antigravity CLIのスケジュール機能です。本記事では、<strong>普段のチャット指示を通じた非同期タスク監視の基本ワークフロー</strong>と、エンジニア向けの明示的なパラメータ制御について解説します。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="スケジュール機能が必要とされる背景">スケジュール機能が必要とされる背景<a href="https://sawara.me/ko/blog/antigravity-cli-schedule-command#%E3%82%B9%E3%82%B1%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB%E6%A9%9F%E8%83%BD%E3%81%8C%E5%BF%85%E8%A6%81%E3%81%A8%E3%81%95%E3%82%8C%E3%82%8B%E8%83%8C%E6%99%AF" class="hash-link" aria-label="スケジュール機能が必要とされる背景에 대한 직접 링크" title="スケジュール機能が必要とされる背景에 대한 직접 링크" translate="no">​</a></h2>
<p>AIエージェントを活用した開発において、時間がかかる処理をバックグラウンドタスクとして実行させるケースが増えています。</p>
<p>例えば、数分かかるE2Eテストやライブラリのビルド処理をバックグラウンドに送った場合、処理結果を確認するためには人間が手動でログを確認するか、エージェントに定期的に状況を問い合わせる必要がありました。</p>
<p>Antigravityのスケジュール機能を活用することで、エージェント自身に「一定時間後」や「一定間隔」でバックグラウンド処理のステータスを確認させることが可能になり、開発者は並行して別の作業に集中できるようになります。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="非同期タスク監視の基本ワークフロー">非同期タスク監視の基本ワークフロー<a href="https://sawara.me/ko/blog/antigravity-cli-schedule-command#%E9%9D%9E%E5%90%8C%E6%9C%9F%E3%82%BF%E3%82%B9%E3%82%AF%E7%9B%A3%E8%A6%96%E3%81%AE%E5%9F%BA%E6%9C%AC%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC" class="hash-link" aria-label="非同期タスク監視の基本ワークフロー에 대한 직접 링크" title="非同期タスク監視の基本ワークフロー에 대한 직접 링크" translate="no">​</a></h2>
<p>Antigravity CLIでは、特別なコマンド構文を意識しなくても、<strong>普段のチャット指示の中に条件を添える</strong>ことで、エージェントにスケジュールタスクを設定させることができます。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="実践例1一定時間後のフォローアップワンショットタイマー">実践例1：一定時間後のフォローアップ（ワンショットタイマー）<a href="https://sawara.me/ko/blog/antigravity-cli-schedule-command#%E5%AE%9F%E8%B7%B5%E4%BE%8B1%E4%B8%80%E5%AE%9A%E6%99%82%E9%96%93%E5%BE%8C%E3%81%AE%E3%83%95%E3%82%A9%E3%83%AD%E3%83%BC%E3%82%A2%E3%83%83%E3%83%97%E3%83%AF%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88%E3%82%BF%E3%82%A4%E3%83%9E%E3%83%BC" class="hash-link" aria-label="実践例1：一定時間後のフォローアップ（ワンショットタイマー）에 대한 직접 링크" title="実践例1：一定時間後のフォローアップ（ワンショットタイマー）에 대한 직접 링크" translate="no">​</a></h3>
<p>時間がかかるビルドやテストをバックグラウンドで実行させつつ、「しばらく経ったら確認して」と伝えるパターンです。</p>
<blockquote>
<p><strong>チャットでの指示例:</strong>
「バックグラウンドでテストを実行して。1分後にテストが完了したか確認し、結果をまとめて報告してください」</p>
</blockquote>
<p>指示を受けたエージェントは自律的にタイマーをセットし、裏側で監視を行います。
さらにこの機能には、<strong>非同期処理に連動したスマートな自動キャンセル挙動</strong>が備わっています。タイマー待機中にテストが早期完了して通知テキストが届いた場合、予約されていたタイマーはサイレントに自動解除されます。「処理が長引いた場合のみエージェントを起こして確認させる」という無駄のない監視がシンプルなやり取りだけで成立します。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="実践例2デプロイ状態の定期チェック定期実行">実践例2：デプロイ状態の定期チェック（定期実行）<a href="https://sawara.me/ko/blog/antigravity-cli-schedule-command#%E5%AE%9F%E8%B7%B5%E4%BE%8B2%E3%83%87%E3%83%97%E3%83%AD%E3%82%A4%E7%8A%B6%E6%85%8B%E3%81%AE%E5%AE%9A%E6%9C%9F%E3%83%81%E3%82%A7%E3%83%83%E3%82%AF%E5%AE%9A%E6%9C%9F%E5%AE%9F%E8%A1%8C" class="hash-link" aria-label="実践例2：デプロイ状態の定期チェック（定期実行）에 대한 직접 링크" title="実践例2：デプロイ状態の定期チェック（定期実行）에 대한 직접 링크" translate="no">​</a></h3>
<p>ステージング環境へのデプロイ作業後、サーバーが正常にレスポンスを返すようになるまで監視させるパターンです。</p>
<blockquote>
<p><strong>チャットでの指示例:</strong>
「ステージング環境（ <a href="https://staging.example.com/" target="_blank" rel="noopener noreferrer" class="">https://staging.example.com</a> ）のステータスを2分おきにチェックして。HTTPステータスが200になったら確認を終了して報告してください」</p>
</blockquote>
<p>エージェントは指示を文脈から解釈し、定期的にアクセスを行うバックグラウンドジョブを裏で立ち上げます。条件を満たした時点でジョブ自体も自律的に終了させてくれます。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="パラメータによる明示的なスケジュール指定">パラメータによる明示的なスケジュール指定<a href="https://sawara.me/ko/blog/antigravity-cli-schedule-command#%E3%83%91%E3%83%A9%E3%83%A1%E3%83%BC%E3%82%BF%E3%81%AB%E3%82%88%E3%82%8B%E6%98%8E%E7%A4%BA%E7%9A%84%E3%81%AA%E3%82%B9%E3%82%B1%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB%E6%8C%87%E5%AE%9A" class="hash-link" aria-label="パラメータによる明示的なスケジュール指定에 대한 직접 링크" title="パラメータによる明示的なスケジュール指定에 대한 직접 링크" translate="no">​</a></h2>
<p>会話テキストからの推論では意図した間隔にならない場合や、ジョブの上限値を厳密に制御したいエンジニア向けに、<code>/schedule</code> コマンド構文とパラメータを用いて直接指示する方法も用意されています。</p>
<p>裏側で動作するスケジュール機能には、以下の4つの引数が定義されています。</p>
<ul>
<li class=""><code>DurationSeconds</code>: ワンショットタイマーの待機時間（秒数）。最大900秒（15分）まで指定可能。</li>
<li class=""><code>CronExpression</code>: 定期実行時のスケジュールを指定する標準的な5フィールドのCron式。</li>
<li class=""><code>MaxIterations</code>: 定期実行（Cron）がトリガーされる最大回数（オプション）。</li>
<li class=""><code>Prompt</code>: タイマー発火時やCron実行時にエージェントへ送信される指示テキスト（必須）。</li>
</ul>
<p>※ <code>DurationSeconds</code> と <code>CronExpression</code> は排他的（どちらか一方のみ指定）となります。</p>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="コマンドでの入力例">コマンドでの入力例<a href="https://sawara.me/ko/blog/antigravity-cli-schedule-command#%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89%E3%81%A7%E3%81%AE%E5%85%A5%E5%8A%9B%E4%BE%8B" class="hash-link" aria-label="コマンドでの入力例에 대한 직접 링크" title="コマンドでの入力例에 대한 직접 링크" translate="no">​</a></h4>
<div class="language-text codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">/schedule CronExpression="*/5 * * * *" MaxIterations=3 Prompt="デプロイのステータスを確認してください"</span><br></div></code></pre></div></div>
<p>自然言語の指示で意図した間隔にならない場合や、無限実行を防ぐために <code>MaxIterations</code> を厳密に指定したいケースなどで有効です。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="スケジュールタスクの管理方法">スケジュールタスクの管理方法<a href="https://sawara.me/ko/blog/antigravity-cli-schedule-command#%E3%82%B9%E3%82%B1%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB%E3%82%BF%E3%82%B9%E3%82%AF%E3%81%AE%E7%AE%A1%E7%90%86%E6%96%B9%E6%B3%95" class="hash-link" aria-label="スケジュールタスクの管理方法에 대한 직접 링크" title="スケジュールタスクの管理方法에 대한 직접 링크" translate="no">​</a></h2>
<p>裏側で登録されたスケジュールジョブは、エージェント内部でバックグラウンドタスクとして管理されています。
これらを管理（状態確認や途中停止）する際も、<strong>チャット上でそのままエージェントに依頼する</strong>ことで安全に操作できます。</p>
<ul>
<li class=""><strong>一覧表示</strong>: 「現在実行中のバックグラウンドタスク（スケジュール）を一覧表示して」と伝える</li>
<li class=""><strong>ジョブの停止</strong>: 「先ほど設定した定期チェックのスケジュール（タスクID: XXXXX）を停止して」と依頼する</li>
</ul>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="スケジュールの一覧表示" src="https://sawara.me/ko/assets/images/antigravity-cli-schedule-command_001-eee220241a7d050394cfd5e261614fc6.webp" width="947" height="420" class="img_ev3q"></p><small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">スケジュールの一覧表示</small></div>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="スケジュールを停止" src="https://sawara.me/ko/assets/images/antigravity-cli-schedule-command_002-8a1c53cc7c117bf8cf6880f5474c50ad.webp" width="946" height="288" class="img_ev3q"></p><small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">スケジュールを停止</small></div>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="運用上の注意点">運用上の注意点<a href="https://sawara.me/ko/blog/antigravity-cli-schedule-command#%E9%81%8B%E7%94%A8%E4%B8%8A%E3%81%AE%E6%B3%A8%E6%84%8F%E7%82%B9" class="hash-link" aria-label="運用上の注意点에 대한 직접 링크" title="運用上の注意点에 대한 직접 링크" translate="no">​</a></h3>
<p>スケジュール機能を利用する際は、以下の点に留意してください。</p>
<ul>
<li class=""><strong>ポーリング間隔の設計</strong>: 数秒おきなどの極端に短いインターバルで外部URLや重い処理を叩くと、サーバーへの負荷やAPIレート制限に引っかかる可能性があります。通常は数分おきの設定が適しています。</li>
<li class=""><strong>セッションスコープ</strong>: スケジュールされたタスクは、現在のCLIセッション内でのみ有効です。セッションを終了（ターミナルを閉じる等）するとタスクも破棄されるため、日をまたぐような長期的なジョブ実行には適していません。</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="まとめ">まとめ<a href="https://sawara.me/ko/blog/antigravity-cli-schedule-command#%E3%81%BE%E3%81%A8%E3%82%81" class="hash-link" aria-label="まとめ에 대한 직접 링크" title="まとめ에 대한 직접 링크" translate="no">​</a></h2>
<p>Antigravity CLIのスケジュール機能は、日常的なチャットを通じたタスク委譲と、必要に応じたパラメータ制御を柔軟に組み合わせられる実用的な機能です。</p>
<p>主なメリットは以下の通りです。</p>
<ul>
<li class=""><strong>シンプルな導入</strong>: 普段のチャットベースのやり取りの中に自然に監視処理を組み込める</li>
<li class=""><strong>スマートな監視制御</strong>: 早期完了時の自動キャンセル処理により、エージェントリソースを無駄に消費しない</li>
<li class=""><strong>確実なエンジニアリング</strong>: 必要に応じてCron式や試行回数上限を直接パラメータで指定することも可能</li>
</ul>
<p>バックグラウンド実行やサブエージェントによる並行処理を行う際は、ぜひこのスケジュール機能を組み合わせてみてください。</p>]]></content:encoded>
            <category>Antigravity</category>
            <category>CLI</category>
            <category>AI</category>
            <category>自動化</category>
            <category>生産性</category>
        </item>
        <item>
            <title><![CDATA[AIエージェントにブラウザデバッグを任せる！Antigravity「Chrome DevTools プラグイン」実践ガイド]]></title>
            <link>https://sawara.me/ko/blog/chrome-devtools-plugin-guide</link>
            <guid>https://sawara.me/ko/blog/chrome-devtools-plugin-guide</guid>
            <pubDate>Sun, 14 Jun 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Antigravityでは、強力なプラグイン機能を活用することで、AIエージェントにコーディングだけでなく、ブラウザの操作やデバッグ作業まで任せられる「自動検証ワークフロー」を簡単に実現することができます。]]></description>
            <content:encoded><![CDATA[<p>Antigravityでは、強力なプラグイン機能を活用することで、AIエージェントにコーディングだけでなく、ブラウザの操作やデバッグ作業まで任せられる「自動検証ワークフロー」を簡単に実現することができます。</p>
<p>本記事では、Antigravityに「Chrome DevTools プラグイン」を導入し、AIエージェントにWebサイトのパフォーマンス改善（LCP）やアクセシビリティ（a11y）診断、メモリリークの特定を自動で行わせる実践的な方法について解説します。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-プラグインのインストール方法">1. プラグインのインストール方法<a href="https://sawara.me/ko/blog/chrome-devtools-plugin-guide#1-%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB%E6%96%B9%E6%B3%95" class="hash-link" aria-label="1. プラグインのインストール方法에 대한 직접 링크" title="1. プラグインのインストール方法에 대한 직접 링크" translate="no">​</a></h2>
<p>Antigravity IDEでChrome DevToolsを活用するには、専用のプラグインをインストールする必要があります。
現状、プラグインのインストールはAntigravity IDEのUIから行うのが最も簡単で確実です。</p>
<p><strong>インストール手順:</strong></p>
<ol>
<li class="">「Cmd + ,」でAntigravityの設定画面を開く</li>
<li class="">左のメニューから「Customizations」を選択</li>
<li class="">一番下の「Build With Google Plugins」セクションの「Customize」ボタンをクリック</li>
<li class="">「Chrome DevTools」の横にある「Download」ボタンをクリックしてインストール</li>
</ol>
<p>インストールが完了すると、所定のディレクトリ（<code>~/.gemini/config/plugins/</code>）にファイルが配置され、Antigravity CLIでも自動的に読み込まれるようになります。特別なターミナル操作やコマンド入力は不要で、すぐにチャットから利用を開始できます。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="設定画面から、Chrome DevTools プラグインをインストールする" src="https://sawara.me/ko/assets/images/chrome-devtools-mcp-guide_001-3c6f11ed0bf69e0ecc0614664d6e2bc0.webp" width="918" height="740" class="img_ev3q"></p><small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">設定画面から、Chrome DevTools プラグインをインストールする</small></div>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="インストール完了後、プラグインが有効になり、スキルが使用できるようになる" src="https://sawara.me/ko/assets/images/chrome-devtools-mcp-guide_002-e04bfb0d80f4b705b95ec081d6de3edb.webp" width="646" height="450" class="img_ev3q"></p><small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">インストール完了後、プラグインが有効になり、スキルが使用できるようになる</small></div>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-プラグインの裏側で動くmcpの仕組み">2. プラグインの裏側で動く「MCP」の仕組み<a href="https://sawara.me/ko/blog/chrome-devtools-plugin-guide#2-%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%AE%E8%A3%8F%E5%81%B4%E3%81%A7%E5%8B%95%E3%81%8Fmcp%E3%81%AE%E4%BB%95%E7%B5%84%E3%81%BF" class="hash-link" aria-label="2. プラグインの裏側で動く「MCP」の仕組み에 대한 직접 링크" title="2. プラグインの裏側で動く「MCP」の仕組み에 대한 직접 링크" translate="no">​</a></h2>
<p>プラグインを有効にすると、AIエージェントは「Chrome DevTools Protocol (CDP)」を介して直接Chromeブラウザを操作できるようになります。
この連携を実現しているのが <strong>MCP (Model Context Protocol)</strong> です。</p>
<p>エージェントがブラウザの情報を取得する際の流れは以下のようになります。</p>
<!-- -->
<p>エージェントはブラウザの画面をただ見ているわけではなく、<code>take_snapshot</code> というツールを使ってページの裏側にある完全なDOM構造（要素ごとのUID）やアクセシビリティツリーを読み取り、論理的にページを検証しています。</p>
<div class="theme-admonition theme-admonition-note admonition_xJq3 alert alert--secondary"><div class="admonitionHeading_Gvgb"><span class="admonitionIcon_Rf37"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M6.3 5.69a.942.942 0 0 1-.28-.7c0-.28.09-.52.28-.7.19-.18.42-.28.7-.28.28 0 .52.09.7.28.18.19.28.42.28.7 0 .28-.09.52-.28.7a1 1 0 0 1-.7.3c-.28 0-.52-.11-.7-.3zM8 7.99c-.02-.25-.11-.48-.31-.69-.2-.19-.42-.3-.69-.31H6c-.27.02-.48.13-.69.31-.2.2-.3.44-.31.69h1v3c.02.27.11.5.31.69.2.2.42.31.69.31h1c.27 0 .48-.11.69-.31.2-.19.3-.42.31-.69H8V7.98v.01zM7 2.3c-3.14 0-5.7 2.54-5.7 5.68 0 3.14 2.56 5.7 5.7 5.7s5.7-2.55 5.7-5.7c0-3.15-2.56-5.69-5.7-5.69v.01zM7 .98c3.86 0 7 3.14 7 7s-3.14 7-7 7-7-3.12-7-7 3.14-7 7-7z"></path></svg></span>実際の動作画面について</div><div class="admonitionContent_BuS1"><p>エージェントがブラウザを検証する際、ユーザーの画面上にChromeのウィンドウが立ち上がって動く様子が見えるわけではありません。基本的にはユーザーの作業を邪魔しないよう、バックグラウンド（ヘッドレスモード）でChromeが起動し、裏側で通信が行われます。
また、後述する「a11y診断」のような特定のタスクにおいては、エージェントが自律的に「CDPを直接叩くより <code>Lighthouse</code> のCLIを使った方が正確で早い」と判断し、最適なツールを自動選択して実行することもあります。</p></div></div>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="3-プラグインで有効になる5つの専用スキル">3. プラグインで有効になる5つの専用スキル<a href="https://sawara.me/ko/blog/chrome-devtools-plugin-guide#3-%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%A7%E6%9C%89%E5%8A%B9%E3%81%AB%E3%81%AA%E3%82%8B5%E3%81%A4%E3%81%AE%E5%B0%82%E7%94%A8%E3%82%B9%E3%82%AD%E3%83%AB" class="hash-link" aria-label="3. プラグインで有効になる5つの専用スキル에 대한 직접 링크" title="3. プラグインで有効になる5つの専用スキル에 대한 직접 링크" translate="no">​</a></h2>
<p>プラグインをインストールすると、エージェントはMCPを通じてブラウザを操作する力だけでなく、目的に応じた5つのスキルを使えるようになります。エージェントはユーザーからの依頼内容に応じて、以下のスキルを自律的に使い分けます。</p>
<ul>
<li class=""><strong><code>chrome-devtools</code> (基本操作)</strong>
ページ遷移やクリック操作、DOM構造の取得など、ブラウザ操作とデバッグ全般のベースとなる汎用スキルです。</li>
<li class=""><strong><code>a11y-debugging</code> (アクセシビリティ監査)</strong>
Web.devのガイドラインに基づき、適切なARIAラベルやコントラスト比、キーボードナビゲーションなどのアクセシビリティ問題を専門的に監査・修正提案します。</li>
<li class=""><strong><code>debug-optimize-lcp</code> (パフォーマンス改善)</strong>
ページの読み込み速度の重要指標である「LCP (Largest Contentful Paint)」のボトルネックを特定し、最適化のためのガイドを行います。</li>
<li class=""><strong><code>memory-leak-debugging</code> (メモリリーク診断)</strong>
Heap Snapshotを利用して、SPAなどで発生しがちなJavaScriptの厄介なメモリリークを診断し、原因となるコンポーネントを特定します。</li>
<li class=""><strong><code>troubleshooting</code> (トラブルシューティング)</strong>
ページが開けない、接続が切れたといった、MCPサーバーやブラウザ操作そのもののトラブルを自己解決するための補助スキルです。</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="4-具体的な実践例aiへの指示の出し方">4. 具体的な実践例（AIへの指示の出し方）<a href="https://sawara.me/ko/blog/chrome-devtools-plugin-guide#4-%E5%85%B7%E4%BD%93%E7%9A%84%E3%81%AA%E5%AE%9F%E8%B7%B5%E4%BE%8Bai%E3%81%B8%E3%81%AE%E6%8C%87%E7%A4%BA%E3%81%AE%E5%87%BA%E3%81%97%E6%96%B9" class="hash-link" aria-label="4. 具体的な実践例（AIへの指示の出し方）에 대한 직접 링크" title="4. 具体的な実践例（AIへの指示の出し方）에 대한 직접 링크" translate="no">​</a></h2>
<p>実際にエディタのチャット欄でAIエージェントに指示を出し、自動デバッグを行わせるプロンプトの例を紹介します。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="実践例aa11yアクセシビリティの自動診断">実践例A：a11y（アクセシビリティ）の自動診断<a href="https://sawara.me/ko/blog/chrome-devtools-plugin-guide#%E5%AE%9F%E8%B7%B5%E4%BE%8Baa11y%E3%82%A2%E3%82%AF%E3%82%BB%E3%82%B7%E3%83%93%E3%83%AA%E3%83%86%E3%82%A3%E3%81%AE%E8%87%AA%E5%8B%95%E8%A8%BA%E6%96%AD" class="hash-link" aria-label="実践例A：a11y（アクセシビリティ）の自動診断에 대한 직접 링크" title="実践例A：a11y（アクセシビリティ）の自動診断에 대한 직접 링크" translate="no">​</a></h3>
<p>Webサイトがアクセシビリティの基準（適切なARIAラベル、コントラスト比、キーボードナビゲーションなど）を満たしているか、エージェントにチェックさせます。</p>
<blockquote>
<p><strong>プロンプト例:</strong>
「現在のローカルサーバー（ <code>http://localhost:3000</code> ）を開いて、トップページのボタンやフォームが a11y の基準を満たしているかチェックし、問題があれば修正案を出して」</p>
</blockquote>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="実践例blcplargest-contentful-paintのボトルネック特定">実践例B：LCP（Largest Contentful Paint）のボトルネック特定<a href="https://sawara.me/ko/blog/chrome-devtools-plugin-guide#%E5%AE%9F%E8%B7%B5%E4%BE%8Bblcplargest-contentful-paint%E3%81%AE%E3%83%9C%E3%83%88%E3%83%AB%E3%83%8D%E3%83%83%E3%82%AF%E7%89%B9%E5%AE%9A" class="hash-link" aria-label="実践例B：LCP（Largest Contentful Paint）のボトルネック特定에 대한 직접 링크" title="実践例B：LCP（Largest Contentful Paint）のボトル�ネック特定에 대한 직접 링크" translate="no">​</a></h3>
<p>ページの読み込み速度の重要指標であるLCPが低下している場合、その原因（レンダリングブロック、重い画像など）を特定させます。</p>
<blockquote>
<p><strong>プロンプト例:</strong>
「このページのLCPのスコアが悪い原因をデバッグして。画像やスクリプトの読み込み順序を確認し、LCPを最適化するための具体的なコードの修正案を教えて」</p>
</blockquote>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="実践例cjavascriptのメモリリーク調査">実践例C：JavaScriptのメモリリーク調査<a href="https://sawara.me/ko/blog/chrome-devtools-plugin-guide#%E5%AE%9F%E8%B7%B5%E4%BE%8Bcjavascript%E3%81%AE%E3%83%A1%E3%83%A2%E3%83%AA%E3%83%AA%E3%83%BC%E3%82%AF%E8%AA%BF%E6%9F%BB" class="hash-link" aria-label="実践例C：JavaScriptのメモリリーク調査에 대한 직접 링크" title="実践例C：JavaScriptのメモリリーク調査에 대한 직접 링크" translate="no">​</a></h3>
<p>SPA（Single Page Application）などで発生しがちなメモリリークを、Heap Snapshotを取って分析させます。</p>
<blockquote>
<p><strong>プロンプト例:</strong>
「アプリを操作しているとメモリ使用量が増え続けています。Chrome DevToolsを使ってHeap Snapshotを取得し、メモリリークが発生しているコンポーネントを特定して」</p>
</blockquote>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="実践例dai主導の自律型e2eテスト動作確認">実践例D：AI主導の自律型E2Eテスト（動作確認）<a href="https://sawara.me/ko/blog/chrome-devtools-plugin-guide#%E5%AE%9F%E8%B7%B5%E4%BE%8Bdai%E4%B8%BB%E5%B0%8E%E3%81%AE%E8%87%AA%E5%BE%8B%E5%9E%8Be2e%E3%83%86%E3%82%B9%E3%83%88%E5%8B%95%E4%BD%9C%E7%A2%BA%E8%AA%8D" class="hash-link" aria-label="実践例D：AI主導の自律型E2Eテスト（動作確認）에 대한 직접 링크" title="実践例D：AI主導の自律型E2Eテスト（動作確認）에 대한 직접 링크" translate="no">​</a></h3>
<p>従来のE2Eテスト（PlaywrightやCypressなど）のように手動でテストコードを書かなくても、エージェントに「ユーザーの視点で操作して」と指示するだけで、柔軟な動作確認が可能です。</p>
<blockquote>
<p><strong>プロンプト例:</strong>
「<code>http://localhost:3000</code> のお問い合わせフォームを開き、ダミーの情報を入力して送信ボタンを押すまでの一連の流れをテストして。もし途中でエラーが出たり、ボタンが押せなかったら原因を教えて」</p>
</blockquote>
<p>UIのIDや構造が多少変わっても、AIが画面全体の構造（DOM）を読み取って「送信ボタンはこれだな」と文脈から判断してクリックしてくれるため、テストコードが壊れにくい（Flakyになりにくい）E2Eテストができます。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="5-seo向上に直結する大きなメリット">5. SEO向上に直結する大きなメリット<a href="https://sawara.me/ko/blog/chrome-devtools-plugin-guide#5-seo%E5%90%91%E4%B8%8A%E3%81%AB%E7%9B%B4%E7%B5%90%E3%81%99%E3%82%8B%E5%A4%A7%E3%81%8D%E3%81%AA%E3%83%A1%E3%83%AA%E3%83%83%E3%83%88" class="hash-link" aria-label="5. SEO向上に直結する大きなメリット에 대한 직접 링크" title="5. SEO向上に直結する大きなメリット에 대한 직접 링크" translate="no">​</a></h2>
<p>このプラグインで提供される <code>a11y-debugging</code> や <code>debug-optimize-lcp</code> といったスキルは、Googleが提唱する「web.dev」のガイドラインや「Core Web Vitals」の基準に強く準拠するように設計されています。</p>
<p>そのため、エージェントの指摘に従ってLCP（Largest Contentful Paint）を最適化したり、アクセシビリティの問題（不適切なARIAラベルやコントラスト比など）を修正することは、単にサイトの使い勝手を良くするだけでなく、Googleの検索エンジンからの評価（SEOスコア）を向上させることに直結します。</p>
<p>SEOやパフォーマンスの改善は専門的な知識が必要で手間がかかる分野ですが、AIエージェントに「Googleの基準に沿ってチェックして」と投げるだけで的確なSEO対策の第一歩を踏み出せるのは、このプラグインならではの大きな強みと言えます。</p>
<p>試しにこのサイトで改善前後の状態をLighthouseで計測してみました。結果として、スマートフォンのパフォーマンススコアは81から87へ、PCのスコアは97から99へと改善がみられました。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="改善前のLighthouseの計測結果（スマホ）" src="https://sawara.me/ko/assets/images/chrome-devtools-mcp-guide_003-9d7ddb9cb08807c8f455724dd7dd7325.webp" width="1000" height="775" class="img_ev3q"></p><small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">改善前のLighthouseの計測結果（スマホ）</small></div>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="改善後のLighthouseの計測結果（スマホ）" src="https://sawara.me/ko/assets/images/chrome-devtools-mcp-guide_005-9a3b1f4f6fdfbd7e251ca26a0e1212af.webp" width="991" height="760" class="img_ev3q"></p><small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">改善後のLighthouseの計測結果（スマホ）</small></div>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="改善前のLighthouseの計測結果（PC）" src="https://sawara.me/ko/assets/images/chrome-devtools-mcp-guide_004-9eef146d8234a36308a2a28e0f0b80c2.webp" width="1002" height="767" class="img_ev3q"></p><small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">改善前のLighthouseの計測結果（PC）</small></div>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="改善後のLighthouseの計測結果（PC）" src="https://sawara.me/ko/assets/images/chrome-devtools-mcp-guide_006-2d312ac847b85ae5be4724de60f28896.webp" width="982" height="756" class="img_ev3q"></p><small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">改善後のLighthouseの計測結果（PC）</small></div>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="まとめaiにブラウザデバッグを任せるメリット">まとめ：AIにブラウザデバッグを任せるメリット<a href="https://sawara.me/ko/blog/chrome-devtools-plugin-guide#%E3%81%BE%E3%81%A8%E3%82%81ai%E3%81%AB%E3%83%96%E3%83%A9%E3%82%A6%E3%82%B6%E3%83%87%E3%83%90%E3%83%83%E3%82%B0%E3%82%92%E4%BB%BB%E3%81%9B%E3%82%8B%E3%83%A1%E3%83%AA%E3%83%83%E3%83%88" class="hash-link" aria-label="まとめ：AIにブラウザデバッグを任せるメリット에 대한 직접 링크" title="まとめ：AIにブラウザデバッグを任せるメリット에 대한 직접 링크" translate="no">​</a></h2>
<p>Chrome DevTools プラグインを利用することで、原因の特定が難しいエラーのデバッグ作業や、時間のかかるパフォーマンスの改善調査をAIエージェントに一任できるようになり、日々の開発における負担が劇的に軽減されます。
このワークフローを取り入れることで</p>
<ol>
<li class=""><strong>定型検証タスクの自動化</strong>: LCPやa11yといった「毎回チェックすべき項目」を自動化し、本質的な開発に集中できる。</li>
<li class=""><strong>SEOスコアへの直接的な貢献</strong>: Google基準（Core Web Vitals等）に準拠した改善案を提示してくれるため、対応がそのまま強力なSEO対策になる。</li>
<li class=""><strong>柔軟で壊れにくいE2Eテスト</strong>: AIが画面を文脈で解釈するため、多少のUI変更にも耐えられる「壊れにくい」自律的な動作確認が可能になる。</li>
<li class=""><strong>高度なトラブルシューティング</strong>: メモリリーク調査のような専門知識が必要なバグ調査も、エージェントが自律的に解析して特定してくれる。</li>
</ol>
<p>といったメリットが得られます。</p>
<p>このように、パフォーマンス測定や動作確認といった「日々の定常作業」とエージェントは非常に相性が良いため、開発ワークフローにも取り入れることをおすすめします！</p>]]></content:encoded>
            <category>Antigravity</category>
            <category>Agent</category>
            <category>MCP</category>
            <category>Chrome</category>
            <category>Debug</category>
        </item>
        <item>
            <title><![CDATA[Antigravity CLI の /planning と /artifact を活用した、計画から実装までの開発フロー実践]]></title>
            <link>https://sawara.me/ko/blog/antigravity-cli-planning-and-artifact</link>
            <guid>https://sawara.me/ko/blog/antigravity-cli-planning-and-artifact</guid>
            <pubDate>Mon, 08 Jun 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[開発プロセスにおいてAIにコード変更を指示する際、十分な調査や設計合意がないまま直接コードを書き換えると、意図しない変更や修正の手戻りが発生するリスクが高まります。このような課題を解決するために、Antigravity CLI には、実装前の「計画（Planning）」と成果物の「視覚的な管理（Artifact）」を組み合わせた開発フローが用意されています。]]></description>
            <content:encoded><![CDATA[<p>開発プロセスにおいてAIにコード変更を指示する際、十分な調査や設計合意がないまま直接コードを書き換えると、意図しない変更や修正の手戻りが発生するリスクが高まります。このような課題を解決するために、Antigravity CLI には、実装前の「計画（Planning）」と成果物の「視覚的な管理（Artifact）」を組み合わせた開発フローが用意されています。</p>
<p>本記事では、対話画面から実行できる <strong><code>/planning</code></strong> コマンドと <strong><code>Artifact（成果物）</code></strong> 機能の役割を整理し、実際にプロジェクトへ単体テストを導入したプロセスをもとに、AIと開発者の間における認識の齟齬を防ぐアプローチについて解説します。</p>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="各コマンドと機能の役割">各コマンドと機能の役割<a href="https://sawara.me/ko/blog/antigravity-cli-planning-and-artifact#%E5%90%84%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89%E3%81%A8%E6%A9%9F%E8%83%BD%E3%81%AE%E5%BD%B9%E5%89%B2" class="hash-link" aria-label="各コマンドと機能の役割에 대한 직접 링크" title="各コマンドと機能の役割에 대한 직접 링크" translate="no">​</a></h3>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="planning-コマンド実装前の設計と合意形成"><code>/planning</code> コマンド：実装前の設計と合意形成<a href="https://sawara.me/ko/blog/antigravity-cli-planning-and-artifact#planning-%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89%E5%AE%9F%E8%A3%85%E5%89%8D%E3%81%AE%E8%A8%AD%E8%A8%88%E3%81%A8%E5%90%88%E6%84%8F%E5%BD%A2%E6%88%90" class="hash-link" aria-label="planning-コマンド実装前の設計と合意形成에 대한 직접 링크" title="planning-コマンド実装前の設計と合意形成에 대한 직접 링크" translate="no">​</a></h4>
<p><strong><code>/planning</code></strong> は、Antigravity CLI の対話画面内で実行する特別なスラッシュコマンドです。このコマンドを入力すると、一時的に計画モードに切り替わり、直接のコード修正を行わずに以下の調査と設計を行います。</p>
<ul>
<li class=""><strong>コードベースの解析</strong>: 変更に関連する既存のソースコードや依存ライブラリ、プロジェクトの設定を読み込みます。</li>
<li class=""><strong>実装方針の策定</strong>: 追加または修正が必要なファイルの一覧、およびその実装手順を整理します。</li>
<li class=""><strong>検証方法の定義</strong>: 実装後に正常に動作するかを確認するための自動テストコマンドや、手動での確認手順をまとめます。</li>
<li class=""><strong>計画書の提示</strong>: 以上の内容をまとめた「実装計画書」を作成し、開発者に提示します。</li>
</ul>
<p>開発者はこの計画書をレビューし、方針に問題がないかを確認した上で実装の実行を承認（Proceed）します。これにより、事前に開発者とAIの間で設計や手順のすり合わせができ、実装に入ってからの認識の齟齬を防ぐことができました。</p>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="artifact成果物機能構造化された情報の独立管理">Artifact（成果物）機能：構造化された情報の独立管理<a href="https://sawara.me/ko/blog/antigravity-cli-planning-and-artifact#artifact%E6%88%90%E6%9E%9C%E7%89%A9%E6%A9%9F%E8%83%BD%E6%A7%8B%E9%80%A0%E5%8C%96%E3%81%95%E3%82%8C%E3%81%9F%E6%83%85%E5%A0%B1%E3%81%AE%E7%8B%AC%E7%AB%8B%E7%AE%A1%E7%90%86" class="hash-link" aria-label="Artifact（成果物）機能：構造化された情報の独立管理에 대한 직접 링크" title="Artifact（成果物）機能：構造化された情報の独立管理에 대한 직접 링크" translate="no">​</a></h4>
<p><strong><code>Artifact</code></strong> は、チャットの会話履歴とは独立したドキュメントやファイルとして情報を管理・提示する機能です。</p>
<p>通常、AI との対話で長いコードやドキュメントを出力させると、チャット画面が埋まり、過去のやり取りをスクロールして確認することが難しくなります。 Artifact 機能を利用すると、計画書（ <code>implementation_plan.md</code> ）やタスクリスト（ <code>task.md</code> ）、完成した成果物のドキュメント（ <code>walkthrough.md</code> ）が独立した画面や別ファイルとして出力されます。</p>
<p>これにより、以下のメリットが得られます。</p>
<ul>
<li class=""><strong>高い視認性</strong>: チャットの対話履歴を汚さず、最新の成果物だけを整理された形で確認できます。</li>
<li class=""><strong>シームレスな操作</strong>: 提示された計画書に対して「承認」ボタンを押すだけで、次の実装フェーズへ自動で移行します。</li>
<li class=""><strong>履歴の更新</strong>: 計画やタスクが進行するにつれて、同じ Artifact の内容が随時書き換えられ、最新状態が維持されます。</li>
</ul>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="実践単体テストの追加">実践：単体テストの追加<a href="https://sawara.me/ko/blog/antigravity-cli-planning-and-artifact#%E5%AE%9F%E8%B7%B5%E5%8D%98%E4%BD%93%E3%83%86%E3%82%B9%E3%83%88%E3%81%AE%E8%BF%BD%E5%8A%A0" class="hash-link" aria-label="実践：単体テストの追加에 대한 직접 링크" title="実践：単体テストの追加에 대한 직접 링크" translate="no">​</a></h3>
<p>ここからは、実際にこの sawara.me のツール集にテストフレームワーク（ <strong><code>Vitest</code></strong> ）を導入し、単体テストを追加する開発フローを例に、具体的な流れを解説します。</p>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="計画の作成">計画の作成<a href="https://sawara.me/ko/blog/antigravity-cli-planning-and-artifact#%E8%A8%88%E7%94%BB%E3%81%AE%E4%BD%9C%E6%88%90" class="hash-link" aria-label="計画の作成에 대한 직접 링크" title="計画の作成에 대한 직접 링크" translate="no">​</a></h4>
<p>まず、Antigravity CLI の対話画面で以下のように指示し、 <strong><code>/planning</code></strong> コマンドを実行してプランニングモードに移行します。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="プランニングモードへの移行コマンドの入力画面" src="data:image/webp;base64,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" width="2044" height="266" class="img_ev3q"></p><small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">/planningコマンドで、プランニングモードに移行する</small></div>
<p>プランニングモードに移行後、実装したい内容のプロンプトを入力します。</p>
<div class="language-text codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">このプロジェクトのツール集に単体テストを実装してください。</span><br></div></code></pre></div></div>
<p>最初はあえて、大まかに指示を出してみました。</p>
<p>指示を入力すると、プロジェクトの <code>package.json</code> や既存のコードが解析され、 <code>implementation_plan.md</code> が Artifact として新規作成されます。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="実装計画書 (implementation_plan.md) の作成結果" src="https://sawara.me/ko/assets/images/antigravity-cli-planning-and-artifact_002-bb1e0b95155f436f8e244b591044aba1.webp" width="1994" height="330" class="img_ev3q"></p><small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">implementation_plan.mdというArtifactが作成された</small></div>
<p>内容を確認するために <code>/artifact</code> コマンドを実行し、<code>implementation_plan.md</code> の <code>open</code> を選択して中身を確認します。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="/artifactコマンドによるファイル選択メニュー" src="https://sawara.me/ko/assets/images/antigravity-cli-planning-and-artifact_003-9adaecdd0fe267ab51001417e5caaf37.webp" width="1288" height="312" class="img_ev3q"></p><small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">/artifactコマンドの結果からopenを選択</small></div>
<p>確認すると、テスト対象が3つのコンポーネントのみに限定されていたため、一度 <code>reject</code> して指示を出し直すことにしました。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="初期に提示された実装計画書の内容" src="https://sawara.me/ko/assets/images/antigravity-cli-planning-and-artifact_004-9e15071cfce9d633505cfe9842582f94.webp" width="1958" height="638" class="img_ev3q"></p><small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">implementation_plan.mdの中身</small></div>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="rejectを選択" src="https://sawara.me/ko/assets/images/antigravity-cli-planning-and-artifact_004_2-7f60c760795e29dd5fdf5d001db88b24.webp" width="1378" height="324" class="img_ev3q"></p><small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">rejectを選択</small></div>
<p><code>reject</code> を選択すると理由を入力するよう求められるため、「5. Write-in...」を選択し、以下の具体的な要望を入力します。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="却下理由の選択オプション" src="https://sawara.me/ko/assets/images/antigravity-cli-planning-and-artifact_005-e49db7089758441828c7ac5f50ae3365.webp" width="1556" height="446" class="img_ev3q"></p><small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">reject理由選択</small></div>
<div class="language-text codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">ツール集で定義されているすべての機能に対して単体テストを実装してください。</span><br></div></code></pre></div></div>
<p>指示を再入力すると、再度 <code>implementation_plan.md</code> が作成されます。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="指示の再入力後に再生成された実装計画書" src="https://sawara.me/ko/assets/images/antigravity-cli-planning-and-artifact_006-adadd68f7fb81a6a00f31d8f95d1b672.webp" width="2028" height="314" class="img_ev3q"></p><small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">reject内容から再度implementation_plan.mdが作成された</small></div>
<p>再び <code>/artifact</code> コマンドを実行し、中身を確認します。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="更新された実装計画書の内容" src="https://sawara.me/ko/assets/images/antigravity-cli-planning-and-artifact_007-37aca1f73acfdb4d0704e0fc39758399.webp" width="1964" height="998" class="img_ev3q"></p><small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">再作成されたimplementation_plan.mdの中身</small></div>
<p>再作成された計画書では、すべてのツールが単体テストの作成対象に含まれていることが確認できました。テスト内容についてもさらに細かく調整することは可能ですが、今回はこの内容で進めることにします。</p>
<p>改めて <code>approve</code> を選択します。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="実装計画書の承認ダイアログ" src="https://sawara.me/ko/assets/images/antigravity-cli-planning-and-artifact_008-690a297e5416e0647e993e56b4d591cd.webp" width="2028" height="312" class="img_ev3q"></p><small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">今度はapproveを選択</small></div>
<p>承認後、 <code>task.md</code> が作成されます。AIが処理を行なっている間も、 <code>/artifact</code> コマンドで進捗を確認できます。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="バックグラウンド処理の実行ステータス" src="https://sawara.me/ko/assets/images/antigravity-cli-planning-and-artifact_009-877050b1fc94c366efbccea85cdb422b.webp" width="2028" height="570" class="img_ev3q"></p><small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">バックグラウンド処理の実行中でもコマンドの入力が可能</small></div>
<p><code>task.md</code> の中身はチェックリストになっており、作業が完了したタスクには自動でチェックが入っていきます。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="タスクリスト (task.md) の進捗状況" src="https://sawara.me/ko/assets/images/antigravity-cli-planning-and-artifact_010-a681b27d911a62982ebec50eb49fff5d.webp" width="2000" height="930" class="img_ev3q"></p><small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">task.mdの中身</small></div>
<p>※チェックリストを表示したままにしておいても自動で更新されないため、一度閉じてから再度開き直す必要があります。</p>
<p>必要なパッケージ（ <code>vitest</code> など）のインストールやテストコードの実装、 <code>package.json</code> へのテストスクリプトの追加など、すべての作業が完了すると、 <code>walkthrough.md</code> という最終的な変更内容と検証結果を要約した Artifact が作成されます。</p>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="実装完了レポート (walkthrough.md) の作成結果" src="https://sawara.me/ko/assets/images/antigravity-cli-planning-and-artifact_011-03c5b28c47198460af8fa1a068bd097d.webp" width="2032" height="450" class="img_ev3q"></p><small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">作業完了後walkthrough.mdが作成される</small></div>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="実装完了レポートの詳細内容" src="https://sawara.me/ko/assets/images/antigravity-cli-planning-and-artifact_012-17a0f23357e5bb7be38837055da24895.webp" width="2024" height="1034" class="img_ev3q"></p><small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">walkthrough.mdの中身</small></div>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="結論">結論<a href="https://sawara.me/ko/blog/antigravity-cli-planning-and-artifact#%E7%B5%90%E8%AB%96" class="hash-link" aria-label="結論에 대한 직접 링크" title="結論에 대한 직접 링크" translate="no">​</a></h3>
<p>Antigravity CLI の <strong><code>/planning</code></strong> コマンドと <strong><code>Artifact</code></strong> 機能を組み合わせることで、以下のステップに沿って安全に開発を進めることができました。</p>
<ol>
<li class="">実装前に変更方針の全体像を把握する</li>
<li class="">会話とは独立したドキュメントでタスクと変更コードを整理する</li>
<li class="">検証結果をレポート形式で確認する</li>
</ol>
<p>これにより、単にコードを自動生成するだけでなく、事前にどのような変更を行うかをすり合わせることで、開発者とAIの間における認識の齟齬をなくすことができました。大規模な機能追加や、今回のようなテストフレームワークの導入時には、まず対話画面で <strong><code>/planning</code></strong> を実行して計画から着手することが有効であると感じました。</p>]]></content:encoded>
            <category>Antigravity CLI</category>
            <category>Development</category>
            <category>Testing</category>
            <category>AI</category>
        </item>
        <item>
            <title><![CDATA[Gemini CLI の後継、Antigravity CLI の紹介：Homebrewでの導入手順と新機能]]></title>
            <link>https://sawara.me/ko/blog/gemini-cli-to-antigravity-cli</link>
            <guid>https://sawara.me/ko/blog/gemini-cli-to-antigravity-cli</guid>
            <pubDate>Fri, 29 May 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[従来の Gemini CLI は、 2026年6月18日 をもってサポートおよびリクエストの受け付けが終了し、Googleの後継エージェントツールである Antigravity CLI （コマンド名： agy ）へ完全に統合されます。]]></description>
            <content:encoded><![CDATA[<p>従来の <strong>Gemini CLI</strong> は、 2026年6月18日 をもってサポートおよびリクエストの受け付けが終了し、Googleの後継エージェントツールである <strong>Antigravity CLI</strong> （コマンド名： <code>agy</code> ）へ完全に統合されます。</p>
<p>本記事では、Macの Homebrew を使用したインストール手順、新旧ツールの比較、料金体系・クレジットモデルの変化について解説します。</p>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="antigravity-cli-とは">Antigravity CLI とは？<a href="https://sawara.me/ko/blog/gemini-cli-to-antigravity-cli#antigravity-cli-%E3%81%A8%E3%81%AF" class="hash-link" aria-label="Antigravity CLI とは？에 대한 직접 링크" title="Antigravity CLI とは？에 대한 직접 링크" translate="no">​</a></h3>
<p>Googleは、開発者向けAIエコシステムを「Antigravity」ブランドへ統合しました。これに伴い、従来の Gemini CLI の後継として提供が開始されたのが <strong>Antigravity CLI</strong> です。</p>
<p>主な特徴は以下の通りです。</p>
<ul>
<li class=""><strong>実行速度とレスポンスの向上</strong>:
従来の Gemini CLI は Node.js で構築されていましたが、Antigravity CLI は <strong>Go 言語</strong> で完全にゼロから書き直されました。これにより、メモリ消費量が削減され、ターミナル上での動作スピードが大幅に向上しています。</li>
<li class=""><strong>サブエージェント機能と安全な並行ワークフロー</strong>:
単一のチャット応答を行うだけでなく、裏側で複数のタスクや「サブエージェント」を非同期で並列実行する機能が搭載されています。対話画面内で <strong><code>/schedule</code></strong> や <strong><code>/goal</code></strong> コマンドで明示的にバックグラウンド処理を指示できるのはもちろん、<strong>ユーザーの指示内容からAI自身が判断して自動でサブエージェントを立ち上げる</strong>こともあります。
特に、「元のコードを壊す恐れのある検証作業」を依頼した際などには、AIの判断で現在のディレクトリを直接書き換えるのではなく、背後で仮想的に「ブランチ（分岐）」したワークスペース上でサブエージェントに隔離して作業させます。これにより、本番環境を汚すことなく、裏側で大胆なコード変更やテストを安全に試させることが可能です。</li>
</ul>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="サブエージェントから読み込みの許可を求められる様子" src="data:image/webp;base64,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" width="770" height="119" class="img_ev3q">
<small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">試しにAIにこの記事の誤字脱字確認を依頼したところ、サブエージェントからファイル読み込みの許可を求められ、</small></p></div>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="メインのAIに結果が届いた様子" src="https://sawara.me/ko/assets/images/gemini-cli-to-antigravity-cli_002-64fb4ac24e7ca8b6335178b4bf7926a9.webp" width="1097" height="238" class="img_ev3q">
<small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">許可をすると、しばらくしたらメインAIに作業完了の報告が届いた</small></p></div>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="クレジット料金体系の変化">クレジット・料金体系の変化<a href="https://sawara.me/ko/blog/gemini-cli-to-antigravity-cli#%E3%82%AF%E3%83%AC%E3%82%B8%E3%83%83%E3%83%88%E6%96%99%E9%87%91%E4%BD%93%E7%B3%BB%E3%81%AE%E5%A4%89%E5%8C%96" class="hash-link" aria-label="クレジット・料金体系の変化에 대한 직접 링크" title="クレジット・料金体系の変化에 대한 직접 링크" translate="no">​</a></h3>
<p>Gemini CLI から Antigravity CLI への移行に伴い、認証方式の裏側と料金（クォータ）の管理モデルが大きく変更されました。</p>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="gemini-cli-時代">Gemini CLI 時代<a href="https://sawara.me/ko/blog/gemini-cli-to-antigravity-cli#gemini-cli-%E6%99%82%E4%BB%A3" class="hash-link" aria-label="Gemini CLI 時代에 대한 직접 링크" title="Gemini CLI 時代에 대한 직접 링크" translate="no">​</a></h4>
<p>Gemini CLI では Google アカウントによる OAuth 認証（ <code>gemini login</code> ）が採用されていました。この際、個人開発者向けの無料枠として、<strong>「1日あたり1,000リクエスト、1分間あたり60リクエスト」</strong> といった、API呼び出し回数ベースの制限が適用されていました。</p>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="antigravity-cli-時代">Antigravity CLI 時代<a href="https://sawara.me/ko/blog/gemini-cli-to-antigravity-cli#antigravity-cli-%E6%99%82%E4%BB%A3" class="hash-link" aria-label="Antigravity CLI 時代에 대한 직접 링크" title="Antigravity CLI 時代에 대한 직접 링크" translate="no">​</a></h4>
<p>Antigravity CLI でも引き続き Google アカウントの OAuth 認証を利用しますが、クォータの概念が「プラットフォーム全体での一元管理」へと移行しました。</p>
<p>料金プランおよびクォータは以下の3つのティアに分かれています。</p>
<ol>
<li class=""><strong>Free / Baseline Tier (無料枠)</strong>:
個人の Google アカウントで利用可能です。回数ベースではなく、<strong>「週単位でリセットされるベースラインクォータ」</strong> が自動的に付与されます。これには、Gemini 3.5 Flash や 3.1 Pro といったコアモデルへのアクセス、無制限のインラインコード補完（Tab補完）、ローカルツール実行権限が含まれます。</li>
<li class=""><strong>Google AI Pro</strong>:
<strong>5時間ごとにリフレッシュ</strong> され、週上限のあるより高いレートリミットが提供される有料サブスクリプションプランです。クォータを使い切った場合でも、購入した「AIクレジット」を消費してシームレスに利用を継続できます。</li>
<li class=""><strong>Google AI Ultra</strong>:
最も高いレートリミットと最優先のクォータ、そして一部のサードパーティ製外部モデルへのアクセス権が含まれる最上位プランです。</li>
</ol>
<div class="theme-admonition theme-admonition-tip admonition_xJq3 alert alert--success"><div class="admonitionHeading_Gvgb"><span class="admonitionIcon_Rf37"><svg viewBox="0 0 12 16"><path fill-rule="evenodd" d="M6.5 0C3.48 0 1 2.19 1 5c0 .92.55 2.25 1 3 1.34 2.25 1.78 2.78 2 4v1h5v-1c.22-1.22.66-1.75 2-4 .45-.75 1-2.08 1-3 0-2.81-2.48-5-5.5-5zm3.64 7.48c-.25.44-.47.8-.67 1.11-.86 1.41-1.25 2.06-1.45 3.23-.02.05-.02.11-.02.17H5c0-.06 0-.13-.02-.17-.2-1.17-.59-1.83-1.45-3.23-.2-.31-.42-.67-.67-1.11C2.44 6.78 2 5.65 2 5c0-2.2 2.02-4 4.5-4 1.22 0 2.36.42 3.22 1.19C10.55 2.94 11 3.94 11 5c0 .66-.44 1.78-.86 2.48zM4 14h5c-.23 1.14-1.3 2-2.5 2s-2.27-.86-2.5-2z"></path></svg></span>現在の利用枠（クォータ）の確認方法</div><div class="admonitionContent_BuS1"><p>Antigravity CLI の対話画面内で <strong><code>/usage</code></strong> コマンドを実行すると、今週のベースラインクォータの残り状況や、AIクレジットの消費量などをリアルタイムで確認できます。</p></div></div>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="現在の利用状況画面" src="https://sawara.me/ko/assets/images/gemini-cli-to-antigravity-cli_003-7df92ff91cbbe98939ab311f3d4a8b97.webp" width="575" height="625" class="img_ev3q">
<small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">/usage コマンドの結果 0%になるとリフレッシュ時間になるまで使えなくなる</small></p></div>
<div class="text--center" style="margin:2rem 0"><p><img decoding="async" loading="lazy" alt="使用モデル変更画面" src="https://sawara.me/ko/assets/images/gemini-cli-to-antigravity-cli_004-2903ba788ec7619aec0151e8654b1e67.webp" width="429" height="272" class="img_ev3q">
<small style="display:block;margin-top:-1rem;color:var(--ifm-color-emphasis-600)">/model コマンドで使用するモデルを変更できる</small></p></div>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="インストールと起動mac環境">インストールと起動（Mac環境）<a href="https://sawara.me/ko/blog/gemini-cli-to-antigravity-cli#%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB%E3%81%A8%E8%B5%B7%E5%8B%95mac%E7%92%B0%E5%A2%83" class="hash-link" aria-label="インストールと起動（Mac環境）에 대한 직접 링크" title="インストールと起動（Mac環境）에 대한 직접 링크" translate="no">​</a></h3>
<p>Mac を使用している場合、パッケージ管理ツールの <strong>Homebrew</strong> を使用してワンコマンドで導入できます。従来必要だった Node.js などの実行環境の事前準備は不要です。</p>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-cli版とide版のインストール">1. CLI版とIDE版のインストール<a href="https://sawara.me/ko/blog/gemini-cli-to-antigravity-cli#1-cli%E7%89%88%E3%81%A8ide%E7%89%88%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB" class="hash-link" aria-label="1. CLI版とIDE版のインストール에 대한 직접 링크" title="1. CLI版とIDE版のインストール에 대한 직접 링크" translate="no">​</a></h4>
<p>ターミナルを開き、以下のコマンドを実行します。</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">brew install antigravity-cli</span><br></div></code></pre></div></div>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-起動コマンド">2. 起動コマンド<a href="https://sawara.me/ko/blog/gemini-cli-to-antigravity-cli#2-%E8%B5%B7%E5%8B%95%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89" class="hash-link" aria-label="2. 起動コマンド에 대한 직접 링크" title="2. 起動コマンド에 대한 직접 링크" translate="no">​</a></h4>
<p>インストールされるバイナリのパッケージ名は <code>antigravity-cli</code> ですが、実際にターミナルから呼び出すコマンド名は、短く最適化された <strong><code>agy</code></strong> となります。</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">agy</span><br></div></code></pre></div></div>
<p>初回起動時は、Google アカウントによる OAuth 認証ページが自動的にブラウザで開きます。画面の指示に従って認証を完了させてください。</p>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="antigravity-ide-との使い分け">Antigravity IDE との使い分け<a href="https://sawara.me/ko/blog/gemini-cli-to-antigravity-cli#antigravity-ide-%E3%81%A8%E3%81%AE%E4%BD%BF%E3%81%84%E5%88%86%E3%81%91" class="hash-link" aria-label="Antigravity IDE との使い分け에 대한 직접 링크" title="Antigravity IDE との使い分け에 대한 직접 링크" translate="no">​</a></h3>
<p>Googleは GUI 開発環境として「Antigravity IDE」も提供しています。</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain"># Antigravity IDE をインストール</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">brew install antigravity-ide</span><br></div></code></pre></div></div>
<p>CLI（ <code>agy</code> ）との役割の使い分けは以下のようになります。</p>
<table><thead><tr><th style="text-align:left">観点</th><th style="text-align:left">Antigravity CLI (<code>agy</code>)</th><th style="text-align:left">Antigravity IDE</th></tr></thead><tbody><tr><td style="text-align:left"><strong>主な用途</strong></td><td style="text-align:left">ターミナル内での迅速な修正、スクリプト実行、自動化</td><td style="text-align:left">ビジュアルな画面設計、複数ファイルの横断デバッグ</td></tr><tr><td style="text-align:left"><strong>操作スタイル</strong></td><td style="text-align:left">コマンドライン、対話インターフェース</td><td style="text-align:left">GUIダッシュボード、統合エディタ</td></tr><tr><td style="text-align:left"><strong>強み</strong></td><td style="text-align:left">軽量・高速起動、CI/CD・自動化スクリプト連携</td><td style="text-align:left">内蔵ブラウザによるUIプレビュー、視覚的デバッグ</td></tr><tr><td style="text-align:left"><strong>自動化連携</strong></td><td style="text-align:left"><code>always-proceed</code> を用いたフルオート実行、ヘッドレス実行</td><td style="text-align:left">GUI上でのエージェントの挙動の監視と手動介入</td></tr></tbody></table>
<p>両者は競合するものではなく、共通のバックエンドを利用しているため、「大がかりなUI構築や初期設計は IDE で行い、日々の細かなコード修正やGit操作は CLI から agy で行う」といった併用が最も効果的です。</p>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="知っておきたい便利なコマンド集">知っておきたい便利なコマンド集<a href="https://sawara.me/ko/blog/gemini-cli-to-antigravity-cli#%E7%9F%A5%E3%81%A3%E3%81%A6%E3%81%8A%E3%81%8D%E3%81%9F%E3%81%84%E4%BE%BF%E5%88%A9%E3%81%AA%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89%E9%9B%86" class="hash-link" aria-label="知っておきたい便利なコマンド集에 대한 직접 링크" title="知っておきたい便利なコマンド集에 대한 직접 링크" translate="no">​</a></h3>
<p>Antigravity CLI をより便利に使いこなすための、代表的な起動オプションと対話画面（チャット）内で使えるスラッシュコマンドをいくつか紹介します。</p>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="起動オプション">起動オプション<a href="https://sawara.me/ko/blog/gemini-cli-to-antigravity-cli#%E8%B5%B7%E5%8B%95%E3%82%AA%E3%83%97%E3%82%B7%E3%83%A7%E3%83%B3" class="hash-link" aria-label="起動オプション에 대한 직접 링크" title="起動オプション에 대한 직접 링크" translate="no">​</a></h4>
<ul>
<li class=""><strong><code>agy --continue</code> （または <code>-c</code>）</strong>
前回閉じた直前の会話セッションをそのまま復元して再開します。「昨日の続きから作業したい」という時に非常に便利です。</li>
<li class=""><strong><code>agy --conversation &lt;ID&gt;</code></strong>
特定の会話IDを指定して過去のコンテキストを復元します。</li>
</ul>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="対話画面でのスラッシュコマンド">対話画面でのスラッシュコマンド<a href="https://sawara.me/ko/blog/gemini-cli-to-antigravity-cli#%E5%AF%BE%E8%A9%B1%E7%94%BB%E9%9D%A2%E3%81%A7%E3%81%AE%E3%82%B9%E3%83%A9%E3%83%83%E3%82%B7%E3%83%A5%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89" class="hash-link" aria-label="対話画面でのスラッシュコマンド에 대한 직접 링크" title="対話画面でのスラッシュコマンド에 대한 직접 링크" translate="no">​</a></h4>
<p>チャット入力欄で <code>/</code> を入力することで実行できる特殊なコマンドです。</p>
<ul>
<li class=""><strong><code>/usage</code></strong> : 先述の通り、現在のトークン利用量や無料枠の残り状況を確認します。</li>
<li class=""><strong><code>/help</code></strong> : 現在の環境で利用可能なスラッシュコマンドや設定方法の一覧を表示します。</li>
<li class=""><strong><code>/schedule</code></strong> : 定期的なタスクやタイマーをバックグラウンドで予約します。「毎朝テストを走らせて結果をサマリして」といった使い方が可能です。</li>
<li class=""><strong><code>/goal</code></strong> : 長時間かかる複雑なタスクをエージェントに任せ、「この目標が達成されるまで絶対に止まらないで」と指示を出せる強力な機能です。</li>
</ul>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="まとめ">まとめ<a href="https://sawara.me/ko/blog/gemini-cli-to-antigravity-cli#%E3%81%BE%E3%81%A8%E3%82%81" class="hash-link" aria-label="まとめ에 대한 직접 링크" title="まとめ에 대한 직접 링크" translate="no">​</a></h3>
<p>Gemini CLI のサポート終了である <strong>2026年6月18日</strong> に向けて、早めの移行をおすすめします。
移行後は、まず対話画面内で <code>/help</code> コマンドを実行し、利用可能な新コマンド群を確認してみるのがおすすめです。</p>
<p>Go 言語化による快適な速度と、進化した非同期エージェントの自律動作を、ぜひ新しい Antigravity CLI で体験してみてください。</p>]]></content:encoded>
            <category>Antigravity CLI</category>
            <category>Gemini CLI</category>
            <category>AI</category>
            <category>Development</category>
        </item>
        <item>
            <title><![CDATA[GitHubのリリースタグをトリガーにChrome拡張機能を自動アップロードする]]></title>
            <link>https://sawara.me/ko/blog/chrome-extension-deploy-automation</link>
            <guid>https://sawara.me/ko/blog/chrome-extension-deploy-automation</guid>
            <pubDate>Sat, 23 May 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Chrome拡張機能の開発において、完成した成果物をZIP形式にまとめ、デベロッパーダッシュボードから手動でアップロードする作業は、頻度が高まると意外に大きな負担となります。]]></description>
            <content:encoded><![CDATA[<p>Chrome拡張機能の開発において、完成した成果物をZIP形式にまとめ、デベロッパーダッシュボードから手動でアップロードする作業は、頻度が高まると意外に大きな負担となります。
今回は、GitHub Actions を活用して、リリースタグ（v1.0.0 など）の作成をトリガーに、Chrome Web Storeへのアップロードを自動化する方法を紹介します。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="自動化のメリット">自動化のメリット<a href="https://sawara.me/ko/blog/chrome-extension-deploy-automation#%E8%87%AA%E5%8B%95%E5%8C%96%E3%81%AE%E3%83%A1%E3%83%AA%E3%83%83%E3%83%88" class="hash-link" aria-label="自動化のメリット에 대한 직접 링크" title="自動化のメリット에 대한 직접 링크" translate="no">​</a></h2>
<p>アップロード作業を自動化することで、主に以下の 2 点のメリットが得られます。</p>
<ol>
<li class=""><strong>作業手間の削減</strong>: 手動でのビルド、ZIP圧縮、ブラウザ経由のアップロードという一連のルーチンワークから解放されます。</li>
<li class=""><strong>ヒューマンエラーの防止</strong>: アップロードするファイルの取り違えや、特定の環境でのビルドミスといった人的ミスを排除し、常にクリーンな環境から生成された成果物をストアに届けることができます。</li>
</ol>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="手順の概要">手順の概要<a href="https://sawara.me/ko/blog/chrome-extension-deploy-automation#%E6%89%8B%E9%A0%86%E3%81%AE%E6%A6%82%E8%A6%81" class="hash-link" aria-label="手順の概要에 대한 직접 링크" title="手順の概要에 대한 직접 링크" translate="no">​</a></h2>
<p>自動アップロードを実現するための全体像は以下の通りです。</p>
<ol>
<li class=""><strong>タグの自動作成</strong>: GitHub Actionsで manifest.json からバージョンを取得し、タグを自動作成できるようにする。</li>
<li class=""><strong>Google Cloud Project の設定</strong>: APIを有効化し、認証情報を取得する。</li>
<li class=""><strong>Refresh Token の取得</strong>: API経由で操作するための永続的なトークンを発行する。</li>
<li class=""><strong>GitHub Secrets の設定</strong>: 認証情報を安全にリポジトリに保存する。</li>
<li class=""><strong>リリースタグの作成で自動アップロード</strong>: リリースタグの作成をトリガーにして、認証情報を元にChrome Web Storeへ自動アップロードする。</li>
</ol>
<p>また、今回は <a href="https://github.com/sawarame/Nickmark" target="_blank" rel="noopener noreferrer" class="">Nickmark</a> という私が開発した拡張機能で実際に試した例を元に解説します。</p>
<hr>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-タグを自動作成する">1. タグを自動作成する<a href="https://sawara.me/ko/blog/chrome-extension-deploy-automation#1-%E3%82%BF%E3%82%B0%E3%82%92%E8%87%AA%E5%8B%95%E4%BD%9C%E6%88%90%E3%81%99%E3%82%8B" class="hash-link" aria-label="1. タグを自動作成する에 대한 직접 링크" title="1. タグを自動作成する에 대한 직접 링크" translate="no">​</a></h2>
<p>まず、プロジェクトの main ブランチに更新があった際、バージョン情報を元に自動でタグを打つ仕組みを作ります。
プロジェクトの <code>.github/workflows/create-tag.yml</code> ファイルを以下の内容で作成してください。</p>
<div class="language-yaml codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-yaml codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token key atrule" style="color:#00a4db">name</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> Create Release Tag</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token key atrule" style="color:#00a4db">on</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token key atrule" style="color:#00a4db">push</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token key atrule" style="color:#00a4db">branches</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain"> main</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token key atrule" style="color:#00a4db">workflow_dispatch</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token key atrule" style="color:#00a4db">permissions</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token key atrule" style="color:#00a4db">contents</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> write</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token key atrule" style="color:#00a4db">jobs</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token key atrule" style="color:#00a4db">tag</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token key atrule" style="color:#00a4db">runs-on</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> ubuntu</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">latest</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token key atrule" style="color:#00a4db">steps</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain"> </span><span class="token key atrule" style="color:#00a4db">name</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> Checkout code</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token key atrule" style="color:#00a4db">uses</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> actions/checkout@v6</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain"> </span><span class="token key atrule" style="color:#00a4db">name</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> Get version from manifest.json</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token key atrule" style="color:#00a4db">run</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">|</span><span class="token scalar string" style="color:#e3116c"></span><br></div><div class="token-line" style="color:#393A34"><span class="token scalar string" style="color:#e3116c">          VERSION=$(jq -r '.version' Nickmark/manifest.json)</span><br></div><div class="token-line" style="color:#393A34"><span class="token scalar string" style="color:#e3116c">          echo "VERSION=v$VERSION" &gt;&gt; $GITHUB_ENV</span><br></div><div class="token-line" style="color:#393A34"><span class="token scalar string" style="color:#e3116c">          echo "Detected version: v$VERSION"</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain"> </span><span class="token key atrule" style="color:#00a4db">name</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> Create and Push Tag</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token key atrule" style="color:#00a4db">run</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">|</span><span class="token scalar string" style="color:#e3116c"></span><br></div><div class="token-line" style="color:#393A34"><span class="token scalar string" style="color:#e3116c">          git config user.name "github-actions[bot]"</span><br></div><div class="token-line" style="color:#393A34"><span class="token scalar string" style="color:#e3116c">          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          if git ls</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">remote </span><span class="token punctuation" style="color:#393A34">-</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">tags origin "refs/tags/$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">VERSION</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">" </span><span class="token punctuation" style="color:#393A34">|</span><span class="token plain"> grep </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">q "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">VERSION</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">"; then</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">            echo "Tag $</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">VERSION</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"> already exists in remote. Skipping tag creation."</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          else</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">            git tag "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">VERSION</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">            git push origin "$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">VERSION</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">            echo "🎉 Successfully created and pushed tag</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> $</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">VERSION</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain">"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          fi</span><br></div></code></pre></div></div>
<p>このファイルをリポジトリにコミットすると、GitHub Actions に <strong>Create Release Tag</strong> というワークフローが追加されます。</p>
<p>このワークフローは、main ブランチへのコミット時に manifest.json のバージョンを確認し、新しいバージョンであれば自動的にタグを作成します。すでに同じバージョンのタグが存在する場合は、重複作成を避けるため処理をスキップします。</p>
<p>実際にバージョンを上げてコミットすると、以下のようにワークフローが実行され、
<img decoding="async" loading="lazy" alt="GitHub Actionsのタグ作成ワークフロー実行結果" src="data:image/webp;base64,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" width="481" height="90" class="img_ev3q"></p>
<p>新しいタグが作成されます。
<img decoding="async" loading="lazy" alt="GitHub上で作成された新しいリリースタグ" src="data:image/webp;base64,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" width="581" height="164" class="img_ev3q"></p>
<p>最終的に、このタグを元に「リリース」を作成したタイミングで、Chrome Web Storeへ自動アップロードされるように設定していきます。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-google-cloud-project-の設定と-api-の有効化">2. Google Cloud Project の設定と API の有効化<a href="https://sawara.me/ko/blog/chrome-extension-deploy-automation#2-google-cloud-project-%E3%81%AE%E8%A8%AD%E5%AE%9A%E3%81%A8-api-%E3%81%AE%E6%9C%89%E5%8A%B9%E5%8C%96" class="hash-link" aria-label="2. Google Cloud Project の設定と API の有効化에 대한 직접 링크" title="2. Google Cloud Project の設定と API の有効化에 대한 직접 링크" translate="no">​</a></h2>
<p>次に、API 経由で Chrome Web Store を操作するための準備を行います。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-google-cloud-プロジェクトの作成">1. Google Cloud プロジェクトの作成<a href="https://sawara.me/ko/blog/chrome-extension-deploy-automation#1-google-cloud-%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%81%AE%E4%BD%9C%E6%88%90" class="hash-link" aria-label="1. Google Cloud プロジェクトの作成에 대한 직접 링크" title="1. Google Cloud プロジェクトの作成에 대한 직접 링크" translate="no">​</a></h3>
<ul>
<li class=""><a href="https://console.cloud.google.com/" target="_blank" rel="noopener noreferrer" class="">Google Cloud Console</a> にアクセスします。</li>
<li class="">画面左上の「プロジェクトを選択」をクリックし、<strong>「新しいプロジェクト」</strong> を選択します。
<img decoding="async" loading="lazy" alt="Google Cloud Consoleのプロジェクト選択画面" src="https://sawara.me/ko/assets/images/chrome-extension-deploy-automation_003-c8d6e7f7dd055458736a000f3ee5c19e.webp" width="1013" height="641" class="img_ev3q"></li>
<li class="">任意のプロジェクト名（例：「My-Chrome-Extensions」）を入力して作成します。
<img decoding="async" loading="lazy" alt="プロジェクト名入力画面" src="https://sawara.me/ko/assets/images/chrome-extension-deploy-automation_004-3b042a59e2f9704b1c81a89dde8ab6ac.webp" width="540" height="374" class="img_ev3q"></li>
<li class="">作成完了後、再び左上のプロジェクト選択から、作成したプロジェクトを選択状態にします。
<img decoding="async" loading="lazy" alt="作成したプロジェクトの選択画面" src="https://sawara.me/ko/assets/images/chrome-extension-deploy-automation_005-f9998623b593e198853b8a460d28b204.webp" width="807" height="546" class="img_ev3q"></li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-chrome-web-store-api-の有効化">2. Chrome Web Store API の有効化<a href="https://sawara.me/ko/blog/chrome-extension-deploy-automation#2-chrome-web-store-api-%E3%81%AE%E6%9C%89%E5%8A%B9%E5%8C%96" class="hash-link" aria-label="2. Chrome Web Store API の有効化에 대한 직접 링크" title="2. Chrome Web Store API の有効化에 대한 직접 링크" translate="no">​</a></h3>
<ul>
<li class="">画面上部の検索バーに「Chrome Web Store API」と入力し、検索結果から選択します。
<img decoding="async" loading="lazy" alt="APIライブラリでのChrome Web Store API検索" src="https://sawara.me/ko/assets/images/chrome-extension-deploy-automation_006-39cda6001a8ecbee72cb5b242652f8cf.webp" width="1147" height="585" class="img_ev3q"></li>
<li class=""><strong>「有効にする」</strong> ボタンをクリックします。
<img decoding="async" loading="lazy" alt="Chrome Web Store APIの有効化ボタン" src="data:image/webp;base64,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" width="724" height="256" class="img_ev3q"></li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="3-oauth-クライアントの作成">3. OAuth クライアントの作成<a href="https://sawara.me/ko/blog/chrome-extension-deploy-automation#3-oauth-%E3%82%AF%E3%83%A9%E3%82%A4%E3%82%A2%E3%83%B3%E3%83%88%E3%81%AE%E4%BD%9C%E6%88%90" class="hash-link" aria-label="3. OAuth クライアントの作成에 대한 직접 링크" title="3. OAuth クライアントの作成에 대한 직접 링크" translate="no">​</a></h3>
<ul>
<li class="">左側のメニューから「APIとサービス」 &gt; <strong>「OAuth 同意画面」</strong> を選択します。User Type を「外部」に設定し、公開ステータスを <strong>「本番環境」</strong> に変更します。
<img decoding="async" loading="lazy" alt="OAuth同意画面の公開ステータス設定" src="https://sawara.me/ko/assets/images/chrome-extension-deploy-automation_008-b39e29e8038e124e1dad309442a41af1.webp" width="1116" height="403" class="img_ev3q"></li>
<li class="">左側のメニューから <strong>「認証情報」</strong> を選択し、画面上部の <strong>「認証情報を作成」 &gt; 「OAuth クライアント ID」</strong> をクリックします。
<img decoding="async" loading="lazy" alt="認証情報の作成メニュー" src="https://sawara.me/ko/assets/images/chrome-extension-deploy-automation_009-51a62adc925cabedb55a8382c91dcfbb.webp" width="1124" height="319" class="img_ev3q"></li>
<li class="">アプリケーションの種類として <strong>「デスクトップ アプリ」</strong> を選択し、名前を入力（例：「For GitHub Actions」）して作成します。
<img decoding="async" loading="lazy" alt="OAuthクライアントIDの作成画面" src="https://sawara.me/ko/assets/images/chrome-extension-deploy-automation_010-683d32ef8fe3d644d9115d7463351f60.webp" width="1120" height="452" class="img_ev3q"></li>
<li class="">作成後に表示される <strong>クライアント ID</strong> と <strong>クライアント シークレット</strong> をコピーしておきます。 <strong>「JSONをダウンロード」</strong> でJson形式で <strong>クライアント ID</strong> と <strong>クライアント シークレット</strong> がダウンロードできます。<br>
<img decoding="async" loading="lazy" alt="クライアントIDとクライアントシークレットの表示画面" src="https://sawara.me/ko/assets/images/chrome-extension-deploy-automation_011-d74a9876acb8c7d406e7f70e9e7c42db.webp" width="521" height="681" class="img_ev3q"></li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="3-refresh-token-の取得">3. Refresh Token の取得<a href="https://sawara.me/ko/blog/chrome-extension-deploy-automation#3-refresh-token-%E3%81%AE%E5%8F%96%E5%BE%97" class="hash-link" aria-label="3. Refresh Token の取得에 대한 직접 링크" title="3. Refresh Token の取得에 대한 직접 링크" translate="no">​</a></h2>
<p>API アクセスに必要な「リフレッシュトークン」を取得します。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-認証コードの取得">1. 認証コードの取得<a href="https://sawara.me/ko/blog/chrome-extension-deploy-automation#1-%E8%AA%8D%E8%A8%BC%E3%82%B3%E3%83%BC%E3%83%89%E3%81%AE%E5%8F%96%E5%BE%97" class="hash-link" aria-label="1. 認証コードの取得에 대한 직접 링크" title="1. 認証コードの取得에 대한 직접 링크" translate="no">​</a></h3>
<p>以下の URL の <code>[CLIENT_ID]</code> 部分を先ほど取得したクライアント ID に書き換え、ブラウザでアクセスします。</p>
<div class="language-text codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">https://accounts.google.com/o/oauth2/auth?response_type=code&amp;scope=https://www.googleapis.com/auth/chromewebstore&amp;client_id=[CLIENT_ID]&amp;redirect_uri=http://127.0.0.1</span><br></div></code></pre></div></div>
<ul>
<li class="">Google アカウントの選択画面が表示されるので、対象のアカウントを選択します。
<img decoding="async" loading="lazy" alt="Googleアカウント選択画面" src="https://sawara.me/ko/assets/images/chrome-extension-deploy-automation_012-73dd8edcc8c462986deb7f9a43f91130.webp" width="1084" height="454" class="img_ev3q"></li>
<li class="">「このアプリは Google で確認されていません」と表示された場合は、左下の「詳細」をクリックし、<strong>「（プロジェクト名）に移動（安全ではない）」</strong> を選択します。
<img decoding="async" loading="lazy" alt="セキュリティ警告画面での詳細表示" src="https://sawara.me/ko/assets/images/chrome-extension-deploy-automation_013-0286f373e852e8951e1b77c9c82cbca9.webp" width="652" height="545" class="img_ev3q"></li>
<li class="">権限のリクエスト画面で <strong>「続行」</strong> をクリックします。
<img decoding="async" loading="lazy" alt="アクセスのリクエスト確認画面" src="https://sawara.me/ko/assets/images/chrome-extension-deploy-automation_014-5830644f7229ac381adc5f936f7b69f4.webp" width="1064" height="886" class="img_ev3q"></li>
</ul>
<p>アクセス許可後、ブラウザの URL が <code>http://127.0.0.1</code> で始まるものに切り替わります。この URL 内にある <code>code=</code> の直後から <code>&amp;scope</code> の直前までが <strong>認証コード</strong> です。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-リフレッシュトークンの発行">2. リフレッシュトークンの発行<a href="https://sawara.me/ko/blog/chrome-extension-deploy-automation#2-%E3%83%AA%E3%83%95%E3%83%AC%E3%83%83%E3%82%B7%E3%83%A5%E3%83%88%E3%83%BC%E3%82%AF%E3%83%B3%E3%81%AE%E7%99%BA%E8%A1%8C" class="hash-link" aria-label="2. リフレッシュトークンの発行에 대한 직접 링크" title="2. リフレッシュトークンの発行에 대한 직접 링크" translate="no">​</a></h3>
<p>ターミナルを開き、以下のコマンドの各項目を書き換えて実行します。</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">curl "https://accounts.google.com/o/oauth2/token" \</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">-d "client_id=[クライアントID]&amp;client_secret=[クライアントシークレット]&amp;code=[取得した認証コード]&amp;grant_type=authorization_code&amp;redirect_uri=http://127.0.0.1"</span><br></div></code></pre></div></div>
<p>成功すると以下のような JSON レスポンスが返ってくるので、その中の <code>refresh_token</code> の値をコピーして保存します。</p>
<div class="language-json codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-json codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token property" style="color:#36acaa">"access_token"</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"ya29.a0A..."</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token property" style="color:#36acaa">"expires_in"</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">3599</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token property" style="color:#36acaa">"refresh_token"</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"1//0e..."</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token property" style="color:#36acaa">"scope"</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"https://www.googleapis.com/auth/chromewebstore"</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token property" style="color:#36acaa">"token_type"</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"Bearer"</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></div></code></pre></div></div>
<div class="theme-admonition theme-admonition-info admonition_xJq3 alert alert--info"><div class="admonitionHeading_Gvgb"><span class="admonitionIcon_Rf37"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M7 2.3c3.14 0 5.7 2.56 5.7 5.7s-2.56 5.7-5.7 5.7A5.71 5.71 0 0 1 1.3 8c0-3.14 2.56-5.7 5.7-5.7zM7 1C3.14 1 0 4.14 0 8s3.14 7 7 7 7-3.14 7-7-3.14-7-7-7zm1 3H6v5h2V4zm0 6H6v2h2v-2z"></path></svg></span>정보</div><div class="admonitionContent_BuS1"><p>"expires_in": 3599 は「1時間(3599秒)で有効期限が切れる」という意味ですが、これは <code>access_token</code> の有効期限になります。</p><p>リフレッシュトークンを使ってアクセストークンを再発行する（＝GitHub Actionsで実行）が6ヶ月間（約180日）に一度も行われないと　<code>refresh_token</code> は自動的に期限切れになりますので、半年に一回はバージョンアップを行っておけば <code>refresh_token</code> が無効になってGitHub Actionsのジョブが失敗するということはありません。</p></div></div>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="4-github-secrets-の設定">4. GitHub Secrets の設定<a href="https://sawara.me/ko/blog/chrome-extension-deploy-automation#4-github-secrets-%E3%81%AE%E8%A8%AD%E5%AE%9A" class="hash-link" aria-label="4. GitHub Secrets の設定에 대한 직접 링크" title="4. GitHub Secrets の設定에 대한 직접 링크" translate="no">​</a></h2>
<p>取得した認証情報を、GitHub リポジトリの Settings &gt; Secrets and variables &gt; Actions &gt; Repository secrets に登録します。</p>
<table><thead><tr><th style="text-align:left">名前</th><th style="text-align:left">内容</th></tr></thead><tbody><tr><td style="text-align:left"><code>CLIENT_ID</code></td><td style="text-align:left">OAuth クライアントのクライアント ID</td></tr><tr><td style="text-align:left"><code>CLIENT_SECRET</code></td><td style="text-align:left">OAuth クライアントのクライアント シークレット</td></tr><tr><td style="text-align:left"><code>REFRESH_TOKEN</code></td><td style="text-align:left">取得したリフレッシュトークン</td></tr><tr><td style="text-align:left"><code>EXTENSION_ID</code></td><td style="text-align:left">拡張機能の ID</td></tr><tr><td style="text-align:left"><code>PUBLISHER_ID</code></td><td style="text-align:left">パブリッシャー ID</td></tr></tbody></table>
<p>各 ID は、Chrome Web Store デベロッパーダッシュボードから確認できます。</p>
<ul>
<li class="">
<p><strong>拡張機能の ID</strong>: 各拡張機能の個別ページで確認。
<img decoding="async" loading="lazy" alt="デベロッパーダッシュボードでの拡張機能ID確認" src="data:image/webp;base64,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" width="467" height="125" class="img_ev3q"></p>
</li>
<li class="">
<p><strong>パブリッシャー ID</strong>: デベロッパーダッシュボードの設定画面から確認。
<img decoding="async" loading="lazy" alt="デベロッパーダッシュボードの設定画面でのパブリッシャーID確認" src="https://sawara.me/ko/assets/images/chrome-extension-deploy-automation_017-51c3c41487db9d9904365fec2cabe87b.webp" width="833" height="384" class="img_ev3q"></p>
</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="5-github-actions-のワークフローを作成する">5. GitHub Actions のワークフローを作成する<a href="https://sawara.me/ko/blog/chrome-extension-deploy-automation#5-github-actions-%E3%81%AE%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC%E3%82%92%E4%BD%9C%E6%88%90%E3%81%99%E3%82%8B" class="hash-link" aria-label="5. GitHub Actions のワークフローを作成する에 대한 직접 링크" title="5. GitHub Actions のワークフローを作成する에 대한 직접 링크" translate="no">​</a></h2>
<p>最後に、リリース作成時に実行されるアップロード用のワークフローを作成します。
<code>.github/workflows/release.yml</code> を以下の内容で作成します。</p>
<div class="language-yaml codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-yaml codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token key atrule" style="color:#00a4db">name</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> Publish to Chrome Web Store</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token key atrule" style="color:#00a4db">on</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token key atrule" style="color:#00a4db">release</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token key atrule" style="color:#00a4db">types</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">published</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token key atrule" style="color:#00a4db">jobs</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token key atrule" style="color:#00a4db">publish</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token key atrule" style="color:#00a4db">runs-on</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> ubuntu</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">latest</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token key atrule" style="color:#00a4db">steps</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain"> </span><span class="token key atrule" style="color:#00a4db">name</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> Checkout code</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token key atrule" style="color:#00a4db">uses</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> actions/checkout@v4</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain"> </span><span class="token key atrule" style="color:#00a4db">name</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> Setup Node.js</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token key atrule" style="color:#00a4db">uses</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> actions/setup</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">node@v4</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token key atrule" style="color:#00a4db">with</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token key atrule" style="color:#00a4db">node-version</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">'24'</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain"> </span><span class="token key atrule" style="color:#00a4db">name</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> Install dependencies &amp; Build</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token key atrule" style="color:#00a4db">run</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">|</span><span class="token scalar string" style="color:#e3116c"></span><br></div><div class="token-line" style="color:#393A34"><span class="token scalar string" style="color:#e3116c">          npm install</span><br></div><div class="token-line" style="color:#393A34"><span class="token scalar string" style="color:#e3116c">          npm run build</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain"> </span><span class="token key atrule" style="color:#00a4db">name</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> Upload and Publish</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token key atrule" style="color:#00a4db">run</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> npx chrome</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">webstore</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">upload</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">cli@latest </span><span class="token punctuation" style="color:#393A34">-</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">source Nickmark.zip</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token key atrule" style="color:#00a4db">env</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token key atrule" style="color:#00a4db">EXTENSION_ID</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> $</span><span class="token punctuation" style="color:#393A34">{</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> secrets.EXTENSION_ID </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token key atrule" style="color:#00a4db">CLIENT_ID</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> $</span><span class="token punctuation" style="color:#393A34">{</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> secrets.CLIENT_ID </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token key atrule" style="color:#00a4db">CLIENT_SECRET</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> $</span><span class="token punctuation" style="color:#393A34">{</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> secrets.CLIENT_SECRET </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token key atrule" style="color:#00a4db">REFRESH_TOKEN</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> $</span><span class="token punctuation" style="color:#393A34">{</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> secrets.REFRESH_TOKEN </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token key atrule" style="color:#00a4db">PUBLISHER_ID</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> $</span><span class="token punctuation" style="color:#393A34">{</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> secrets.PUBLISHER_ID </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">}</span><br></div></code></pre></div></div>
<p>Nickmark の場合は <code>npm run build</code> でパッケージ（Nickmark.zip）が生成される仕組みになっているため、ビルド後にそのままアップロード手順を実行しています。プロジェクトの構成に合わせて、必要に応じて ZIP 圧縮を行うステップを追加してください。</p>
<hr>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="動作確認">動作確認<a href="https://sawara.me/ko/blog/chrome-extension-deploy-automation#%E5%8B%95%E4%BD%9C%E7%A2%BA%E8%AA%8D" class="hash-link" aria-label="動作確認에 대한 직접 링크" title="動作確認에 대한 직접 링크" translate="no">​</a></h2>
<p>設定がすべて完了したので、実際にタグからリリースを作成して動作確認してみます。</p>
<p>GitHub のタグ一覧から、作成されたタグの <strong>「Create release from tag」</strong> をクリックします。
<img decoding="async" loading="lazy" alt="GitHubのタグ一覧からのリリース作成ボタン" src="https://sawara.me/ko/assets/images/chrome-extension-deploy-automation_018-06c469120183d77a943f6455fe4c8622.webp" width="1089" height="388" class="img_ev3q"></p>
<p>リリースノートを入力して <strong>「Publish release」</strong> をクリックすると、GitHub Actions のワークフローが開始されます。
<img decoding="async" loading="lazy" alt="リリース公開ボタンのクリック" src="data:image/webp;base64,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" width="732" height="97" class="img_ev3q"></p>
<p>ワークフロー完了後、デベロッパーダッシュボードを確認すると、ステータスが「審査待ち」に更新されているはずです。
<img decoding="async" loading="lazy" alt="デベロッパーダッシュボードでの審査待ちステータス" src="data:image/webp;base64,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" width="840" height="133" class="img_ev3q"></p>
<p>バージョンも正しく更新されており、自動化に成功しました。
<img decoding="async" loading="lazy" alt="ストアにアップロードされた新しいバージョン情報の確認" src="https://sawara.me/ko/assets/images/chrome-extension-deploy-automation_021-4b0b471368a348d79b8d89ce9681ef96.webp" width="856" height="463" class="img_ev3q"></p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="注意点">注意点<a href="https://sawara.me/ko/blog/chrome-extension-deploy-automation#%E6%B3%A8%E6%84%8F%E7%82%B9" class="hash-link" aria-label="注意点에 대한 직접 링크" title="注意点에 대한 직접 링크" translate="no">​</a></h2>
<ul>
<li class=""><strong>初回アップロード</strong>: まだ一度もストアに公開していない拡張機能の場合、初回のみデベロッパーダッシュボードから手動で ZIP をアップロードする必要があります。API による更新は、すでに存在するアイテムが対象となります。</li>
<li class=""><strong>権限の変更</strong>: manifest.json の <code>permissions</code> や <code>host_permissions</code> に変更があった場合、自動的には審査へ提出されません。その場合はデベロッパーダッシュボードにログインし、不足している説明項目などを入力してから、手動で「審査のために送信」を行う必要があります。</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="まとめ">まとめ<a href="https://sawara.me/ko/blog/chrome-extension-deploy-automation#%E3%81%BE%E3%81%A8%E3%82%81" class="hash-link" aria-label="まとめ에 대한 직접 링크" title="まとめ에 대한 직접 링크" translate="no">​</a></h2>
<p>一度この仕組みを構築してしまえば、manifest.json のバージョンを上げてコミットするだけで公開準備が整います。</p>
<p>手動作業による心理的ハードルやミスを減らし、開発の本来の目的である機能改善にリソースを集中できるようになります。Chrome 拡張機能を継続的にメンテナンスしている方の参考になれば幸いです。</p>]]></content:encoded>
            <category>GitHub Actions</category>
            <category>Chrome Extension</category>
            <category>CI/CD</category>
            <category>開発効率化</category>
        </item>
        <item>
            <title><![CDATA[DocusaurusのGitHub PagesデプロイをGitHub Actionsで自動化する]]></title>
            <link>https://sawara.me/ko/blog/github-actions-deploy-automation</link>
            <guid>https://sawara.me/ko/blog/github-actions-deploy-automation</guid>
            <pubDate>Fri, 22 May 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[前回の記事では、Docusaurus で作成したサイトを GitHub Pages に手動でデプロイする方法を紹介しました。]]></description>
            <content:encoded><![CDATA[<p><a class="" href="https://sawara.me/ko/blog/docusaurus-github-pages">前回の記事</a>では、Docusaurus で作成したサイトを GitHub Pages に手動でデプロイする方法を紹介しました。</p>
<a class="linkCard_fEEo" href="https://sawara.me/ko/blog/docusaurus-github-pages"><div class="emojiWrapper_T8JQ"><svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-package" aria-hidden="true"><path d="M11 21.73a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73z"></path><path d="M12 22V12"></path><polyline points="3.29 7 12 12 20.71 7"></polyline><path d="m7.5 4.27 9 5.15"></path></svg></div><div class="content_cWRx"><div class="title_KDn0">DocusaurusをGitHub Pagesで動かす</div><div class="description_qJNw">Docusaurusで作成したサイトをGitHub Pagesで公開する手順を詳しく解説。基本的な設定からデプロイコマンドの実行までをカバーしています。</div></div></a>
<p>今回は、さらに一歩進んで <strong>GitHub Actions を使い、コードを GitHub にプッシュするだけで自動的にデプロイされる仕組み</strong> を構築します。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="手順の概要">手順の概要<a href="https://sawara.me/ko/blog/github-actions-deploy-automation#%E6%89%8B%E9%A0%86%E3%81%AE%E6%A6%82%E8%A6%81" class="hash-link" aria-label="手順の概要에 대한 직접 링크" title="手順の概要에 대한 직접 링크" translate="no">​</a></h2>
<p>自動デプロイを実現するための流れは以下の通りです。</p>
<ol>
<li class=""><strong>GitHub リポジトリの設定変更</strong>: デプロイの権限を GitHub Actions に与えます。</li>
<li class=""><strong>ワークフローファイルの作成</strong>: ビルドとデプロイの手順を記述した設定ファイルを作成します。</li>
<li class=""><strong>動作確認</strong>: コードをプッシュして、実際にサイトが更新されるか確認します。</li>
</ol>
<hr>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-github-リポジトリの設定変更">1. GitHub リポジトリの設定変更<a href="https://sawara.me/ko/blog/github-actions-deploy-automation#1-github-%E3%83%AA%E3%83%9D%E3%82%B8%E3%83%88%E3%83%AA%E3%81%AE%E8%A8%AD%E5%AE%9A%E5%A4%89%E6%9B%B4" class="hash-link" aria-label="1. GitHub リポジトリの設定変更에 대한 직접 링크" title="1. GitHub リポジトリの設定変更에 대한 직접 링크" translate="no">​</a></h2>
<p>まず、GitHub Actions から GitHub Pages へ直接デプロイできるように設定を切り替えます。</p>
<ol>
<li class="">GitHub リポジトリの <strong>Settings</strong> タブを開きます。</li>
<li class="">左サイドメニューの <strong>Pages</strong> を選択します。</li>
<li class=""><strong>Build and deployment</strong> セクションにある <strong>Source</strong> を、デフォルトの <code>Deploy from a branch</code> から <strong>GitHub Actions</strong> に変更します。</li>
</ol>
<p><img decoding="async" loading="lazy" alt="GitHub Pages設定" src="https://sawara.me/ko/assets/images/github-actions-deploy-automation_001-63d8bec36fbe58524f9a9fce5c6d73d6.webp" width="1120" height="630" class="img_ev3q"></p>
<p>これで、GitHub Actions 経由でサイトを更新する準備が整いました。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-github-actions-のワークフローを作成する">2. GitHub Actions のワークフローを作成する<a href="https://sawara.me/ko/blog/github-actions-deploy-automation#2-github-actions-%E3%81%AE%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC%E3%82%92%E4%BD%9C%E6%88%90%E3%81%99%E3%82%8B" class="hash-link" aria-label="2. GitHub Actions のワークフローを作成する에 대한 직접 링크" title="2. GitHub Actions のワークフローを作成する에 대한 직접 링크" translate="no">​</a></h2>
<p>次に、ビルドとデプロイの手順を定義する「ワークフローファイル」を作成します。リポジトリのルートディレクトリに <code>.github/workflows/deploy.yml</code> というファイルを作成し、以下の内容を記述します。</p>
<div class="language-yaml codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-yaml codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token key atrule" style="color:#00a4db">name</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> Deploy to GitHub Pages</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token key atrule" style="color:#00a4db">on</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token key atrule" style="color:#00a4db">push</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token key atrule" style="color:#00a4db">branches</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain"> main</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token key atrule" style="color:#00a4db">workflow_dispatch</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token key atrule" style="color:#00a4db">permissions</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token key atrule" style="color:#00a4db">contents</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> read</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token key atrule" style="color:#00a4db">pages</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> write</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token key atrule" style="color:#00a4db">id-token</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> write</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token key atrule" style="color:#00a4db">concurrency</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token key atrule" style="color:#00a4db">group</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"pages"</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token key atrule" style="color:#00a4db">cancel-in-progress</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> </span><span class="token boolean important" style="color:#36acaa">true</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token key atrule" style="color:#00a4db">jobs</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token key atrule" style="color:#00a4db">build</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token key atrule" style="color:#00a4db">name</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> Build</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token key atrule" style="color:#00a4db">runs-on</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> ubuntu</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">latest</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token key atrule" style="color:#00a4db">steps</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain"> </span><span class="token key atrule" style="color:#00a4db">name</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> Checkout</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token key atrule" style="color:#00a4db">uses</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> actions/checkout@v4</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token key atrule" style="color:#00a4db">with</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token key atrule" style="color:#00a4db">fetch-depth</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">0</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain"> </span><span class="token key atrule" style="color:#00a4db">name</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> Setup Node</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token key atrule" style="color:#00a4db">uses</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> actions/setup</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">node@v4</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token key atrule" style="color:#00a4db">with</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token key atrule" style="color:#00a4db">node-version</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">24</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token key atrule" style="color:#00a4db">cache</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">'yarn'</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain"> </span><span class="token key atrule" style="color:#00a4db">name</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> Install dependencies</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token key atrule" style="color:#00a4db">run</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> yarn install </span><span class="token punctuation" style="color:#393A34">-</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">frozen</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">lockfile</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain"> </span><span class="token key atrule" style="color:#00a4db">name</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> Build website</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token key atrule" style="color:#00a4db">run</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> yarn build</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain"> </span><span class="token key atrule" style="color:#00a4db">name</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> Upload artifact</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token key atrule" style="color:#00a4db">uses</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> actions/upload</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">pages</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">artifact@v3</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token key atrule" style="color:#00a4db">with</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token key atrule" style="color:#00a4db">path</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> ./build</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token key atrule" style="color:#00a4db">deploy</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token key atrule" style="color:#00a4db">name</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> Deploy</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token key atrule" style="color:#00a4db">runs-on</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> ubuntu</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">latest</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token key atrule" style="color:#00a4db">needs</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> build</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token key atrule" style="color:#00a4db">environment</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token key atrule" style="color:#00a4db">name</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> github</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">pages</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token key atrule" style="color:#00a4db">url</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> $</span><span class="token punctuation" style="color:#393A34">{</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> steps.deployment.outputs.page_url </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token key atrule" style="color:#00a4db">steps</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain"> </span><span class="token key atrule" style="color:#00a4db">name</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> Deploy to GitHub Pages</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token key atrule" style="color:#00a4db">id</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> deployment</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token key atrule" style="color:#00a4db">uses</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> actions/deploy</span><span class="token punctuation" style="color:#393A34">-</span><span class="token plain">pages@v4</span><br></div></code></pre></div></div>
<div class="theme-admonition theme-admonition-note admonition_xJq3 alert alert--secondary"><div class="admonitionHeading_Gvgb"><span class="admonitionIcon_Rf37"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M6.3 5.69a.942.942 0 0 1-.28-.7c0-.28.09-.52.28-.7.19-.18.42-.28.7-.28.28 0 .52.09.7.28.18.19.28.42.28.7 0 .28-.09.52-.28.7a1 1 0 0 1-.7.3c-.28 0-.52-.11-.7-.3zM8 7.99c-.02-.25-.11-.48-.31-.69-.2-.19-.42-.3-.69-.31H6c-.27.02-.48.13-.69.31-.2.2-.3.44-.31.69h1v3c.02.27.11.5.31.69.2.2.42.31.69.31h1c.27 0 .48-.11.69-.31.2-.19.3-.42.31-.69H8V7.98v.01zM7 2.3c-3.14 0-5.7 2.54-5.7 5.68 0 3.14 2.56 5.7 5.7 5.7s5.7-2.55 5.7-5.7c0-3.15-2.56-5.69-5.7-5.69v.01zM7 .98c3.86 0 7 3.14 7 7s-3.14 7-7 7-7-3.12-7-7 3.14-7 7-7z"></path></svg></span>노트</div><div class="admonitionContent_BuS1"><p>現在の GitHub のデフォルトブランチ名は <code>main</code> が一般的ですが、プロジェクトによっては <code>master</code> を継続して使用している場合があります。ご自身の環境に合わせて <code>branches</code> の指定を書き換えてください。</p></div></div>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="ワークフローの役割">ワークフローの役割<a href="https://sawara.me/ko/blog/github-actions-deploy-automation#%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC%E3%81%AE%E5%BD%B9%E5%89%B2" class="hash-link" aria-label="ワークフローの役割에 대한 직접 링크" title="ワークフローの役割에 대한 직접 링크" translate="no">​</a></h3>
<ul>
<li class=""><strong>Build ジョブ</strong>: GitHub のサーバー上で Node.js環境を構築し、<code>yarn build</code> を実行して公開用の静的ファイルを生成します。生成されたファイルは「アーティファクト」として一時保存されます。</li>
<li class=""><strong>Deploy ジョブ</strong>: 保存されたアーティファクトを受け取り、GitHub Pages のサーバーへ直接デプロイします。</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="3-git-push-して動作を確認する">3. git push して動作を確認する<a href="https://sawara.me/ko/blog/github-actions-deploy-automation#3-git-push-%E3%81%97%E3%81%A6%E5%8B%95%E4%BD%9C%E3%82%92%E7%A2%BA%E8%AA%8D%E3%81%99%E3%82%8B" class="hash-link" aria-label="3. git push して動作を確認する에 대한 직접 링크" title="3. git push して動作を確認する에 대한 직접 링크" translate="no">​</a></h2>
<p>最後に、作成したワークフローファイルをリポジトリのmainブランチにプッシュして、動作を確認することができます。</p>
<ol>
<li class=""><code>.github/workflows/deploy.yml</code>　ファイルをmainブランチにプッシュします。</li>
<li class="">GitHub リポジトリの <strong>Actions</strong> タブを開きます。</li>
<li class=""><code>Deploy to GitHub Pages</code> というワークフローが開始されていることを確認します。</li>
<li class="">全てのジョブが緑色のチェックマーク（成功）になったら完了です。</li>
</ol>
<p><img decoding="async" loading="lazy" alt="GitHub Actions実行画面" src="data:image/webp;base64,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" width="615" height="209" class="img_ev3q"></p>
<p>実際に公開されているサイト（<code>https://&lt;ユーザー名&gt;.github.io/&lt;リポジトリ名&gt;/</code>）にアクセスし、変更が反映されていることを確認してください。</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="まとめ">まとめ<a href="https://sawara.me/ko/blog/github-actions-deploy-automation#%E3%81%BE%E3%81%A8%E3%82%81" class="hash-link" aria-label="まとめ에 대한 직접 링크" title="まとめ에 대한 직접 링크" translate="no">​</a></h2>
<p>これで、コードをプッシュするだけでサイトが自動更新されるようになりました。デプロイの手間がゼロになるだけでなく、常にクリーンな環境でビルドが保証される安心感は大きいです。</p>
<p>手動でのデプロイ作業から解放され、より価値のある「執筆」や「開発」に集中できるようになるこの仕組み、ぜひ導入してみてください。</p>]]></content:encoded>
            <category>Docusaurus</category>
            <category>GitHub Actions</category>
            <category>CI/CD</category>
            <category>Node.js</category>
        </item>
        <item>
            <title><![CDATA[DESIGN.md：AIエージェントと「デザインの意図」を共有するための新標準]]></title>
            <link>https://sawara.me/ko/blog/design-md-with-ai-agent</link>
            <guid>https://sawara.me/ko/blog/design-md-with-ai-agent</guid>
            <pubDate>Mon, 18 May 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[AIに「いい感じのUIを作って」と頼んでも、プロジェクト独自の色味や、角丸サイズといったこだわりまではなかなか再現してくれません。]]></description>
            <content:encoded><![CDATA[<p>AIに「いい感じのUIを作って」と頼んでも、プロジェクト独自の色味や、角丸サイズといったこだわりまではなかなか再現してくれません。</p>
<p>この「AIと人間の認識のズレ」を解決し、AIエージェントを強力なフロントエンドエンジニアに変えるための新標準、それが <a href="https://github.com/google-labs-code/design.md" target="_blank" rel="noopener noreferrer" class=""><strong>google-labs-code/design.md</strong></a> です。</p>
<p>今回は、この <code>DESIGN.md</code> の仕様を本サイト <code>sawara.me</code> に導入し、Gemini CLI でどのように活用しているかをご紹介します。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="aiには言葉だけでは伝わらない">AIには「言葉」だけでは伝わらない<a href="https://sawara.me/ko/blog/design-md-with-ai-agent#ai%E3%81%AB%E3%81%AF%E8%A8%80%E8%91%89%E3%81%A0%E3%81%91%E3%81%A7%E3%81%AF%E4%BC%9D%E3%82%8F%E3%82%89%E3%81%AA%E3%81%84" class="hash-link" aria-label="AIには「言葉」だけでは伝わらない에 대한 직접 링크" title="AIには「言葉」だけでは伝わらない에 대한 직접 링크" translate="no">​</a></h3>
<p>従来のプロジェクトでは、デザインの仕様は Figma や Wiki、あるいはコード内の CSS 変数に散らばっていました。AIエージェントに指示を出す際、これらの情報をすべて伝えるのは現実的ではありません。</p>
<p>結果として、AIは「なんとなくモダンなデザイン」を生成してしまい、後から人間が修正するという二度手間が発生しがちです。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="designmdaiとデザインの意図を共有する">DESIGN.md：AIとデザインの「意図」を共有する<a href="https://sawara.me/ko/blog/design-md-with-ai-agent#designmdai%E3%81%A8%E3%83%87%E3%82%B6%E3%82%A4%E3%83%B3%E3%81%AE%E6%84%8F%E5%9B%B3%E3%82%92%E5%85%B1%E6%9C%89%E3%81%99%E3%82%8B" class="hash-link" aria-label="DESIGN.md：AIとデザインの「意図」を共有する에 대한 직접 링크" title="DESIGN.md：AIとデザインの「意図」を共有する에 대한 직접 링크" translate="no">​</a></h3>
<p>Google Labs が提案している <code>DESIGN.md</code> は、この問題を「一つのファイル」で解決します。</p>
<p>その最大の特徴は、<strong>YAML による厳密なデータ定義（Tokens）</strong> と、<strong>Markdown による設計根拠（Prose）</strong> の統合です。</p>
<div class="language-yaml codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-yaml codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token punctuation" style="color:#393A34">---</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token key atrule" style="color:#00a4db">version</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> 1.0.0</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token key atrule" style="color:#00a4db">tokens</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token key atrule" style="color:#00a4db">color</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token key atrule" style="color:#00a4db">brand</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token key atrule" style="color:#00a4db">primary</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"#3366cc"</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token key atrule" style="color:#00a4db">border</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token key atrule" style="color:#00a4db">radius</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token key atrule" style="color:#00a4db">card</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">16</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">---</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic"># Design Guidelines</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">...</span><br></div></code></pre></div></div>
<ul>
<li class=""><strong>Tokens (YAML)</strong>: AIがコード生成時に直接参照できる正確な数値。</li>
<li class=""><strong>Prose (Markdown)</strong>: デザインの雰囲気や「なぜその色なのか」という、数値化できない意図。</li>
</ul>
<p>AIはこのファイルを読み込むことで、「このプロジェクトのプライマリーカラーは <code>#3366cc</code> で、角丸は <code>16px</code> を使うべきだ」という知識を、明示的に指示される前に獲得します。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="gemini-cli-での活用明示的なインポート">Gemini CLI での活用：明示的なインポート<a href="https://sawara.me/ko/blog/design-md-with-ai-agent#gemini-cli-%E3%81%A7%E3%81%AE%E6%B4%BB%E7%94%A8%E6%98%8E%E7%A4%BA%E7%9A%84%E3%81%AA%E3%82%A4%E3%83%B3%E3%83%9D%E3%83%BC%E3%83%88" class="hash-link" aria-label="Gemini CLI での活用：明示的なインポート에 대한 직접 링크" title="Gemini CLI での活用：明示的なインポート에 대한 직접 링크" translate="no">​</a></h3>
<p>Gemini CLI（のエージェント）は、プロジェクトルートにある <code>GEMINI.md</code> を開発におけるベース・コンテキストとして読み込みますが、<code>DESIGN.md</code> のような別名のファイルは、以下のように <strong><code>GEMINI.md</code> 内で明示的にインポート</strong> することで認識されるようになります。</p>
<div class="language-markdown codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-markdown codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">@./DESIGN.md</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token title important punctuation" style="color:#393A34">#</span><span class="token title important"> Project Guidelines</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">...</span><br></div></code></pre></div></div>
<p>このようにインポート設定を行うことで、エージェントは自動的に <code>DESIGN.md</code> をスキャンし、開発時に以下のような判断を下せるようになります。</p>
<ol>
<li class=""><strong>色の選択</strong>: <code>tokens.color.brand.primary</code> に定義された青色を使用する。</li>
<li class=""><strong>コンポーネントの形状</strong>: <code>tokens.border.radius.card</code> に基づき、角丸を 16px に設定する。</li>
<li class=""><strong>コーディング規約</strong>: 本文の Markdown にある「MUI v6 を使用し、CSS Modules でスタイルを定義する」という指示に従う。</li>
</ol>
<p>人間が細かなスタイルを毎回指示しなくても、最初からプロジェクトのトーンに合ったコードが生成されるのです。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="正しく読み込まれているか確認する">正しく読み込まれているか確認する<a href="https://sawara.me/ko/blog/design-md-with-ai-agent#%E6%AD%A3%E3%81%97%E3%81%8F%E8%AA%AD%E3%81%BF%E8%BE%BC%E3%81%BE%E3%82%8C%E3%81%A6%E3%81%84%E3%82%8B%E3%81%8B%E7%A2%BA%E8%AA%8D%E3%81%99%E3%82%8B" class="hash-link" aria-label="正しく読み込まれているか確認する에 대한 직접 링크" title="正しく読み込まれているか確認する에 대한 직접 링크" translate="no">​</a></h3>
<p>設定した <code>DESIGN.md</code> が正しくコンテキストに含まれているか不安な場合は、Gemini CLI の対話インターフェース内で以下のコマンドを実行して確認できます。</p>
<ul>
<li class=""><strong><code>/memory show</code></strong>: 実際にモデルに送信されている、インポートが展開された後のコンテキスト全文を表示します。</li>
</ul>
<p><code>/memory show</code> を実行して <code>DESIGN.md</code> の中身が表示されれば、AIエージェントのコンテキストにデザイン仕様が正しく反映されており、一貫性のある提案が可能な状態になっています。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="本サイトでの実践リファクタリングと検証">本サイトでの実践：リファクタリングと検証<a href="https://sawara.me/ko/blog/design-md-with-ai-agent#%E6%9C%AC%E3%82%B5%E3%82%A4%E3%83%88%E3%81%A7%E3%81%AE%E5%AE%9F%E8%B7%B5%E3%83%AA%E3%83%95%E3%82%A1%E3%82%AF%E3%82%BF%E3%83%AA%E3%83%B3%E3%82%B0%E3%81%A8%E6%A4%9C%E8%A8%BC" class="hash-link" aria-label="本サイトでの実践：リファクタリングと検証에 대한 직접 링크" title="本サイトでの実践：リファクタリングと検証에 대한 직접 링크" translate="no">​</a></h3>
<p>実際に、本サイトの <a href="https://github.com/sawarame/sawarame.github.com/blob/master/DESIGN.md" target="_blank" rel="noopener noreferrer" class="">DESIGN.md</a> を Google Labs 仕様にアップデートしました。</p>
<p>ただ書き換えるだけでなく、公式の検証ツールを使用して、仕様に準拠しているかを確認できます。</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">npx @google/design.md lint DESIGN.md</span><br></div></code></pre></div></div>
<p>リファクタリング前は「YAML が見つからない」という警告が出ていましたが、アップデート後はエラー・警告ともにゼロでパスしました。この検証ステップがあるおかげで、AIにとっても読み取りやすいクリーンな状態を維持できます。</p>
<p>リファクタリング前に検証ツールで出力された警告</p>
<div class="language-json codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-json codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token property" style="color:#36acaa">"findings"</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token property" style="color:#36acaa">"severity"</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"warning"</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token property" style="color:#36acaa">"message"</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"No YAML content found. Expected frontmatter (---) or fenced yaml code blocks."</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token property" style="color:#36acaa">"summary"</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token property" style="color:#36acaa">"errors"</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token property" style="color:#36acaa">"warnings"</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token property" style="color:#36acaa">"infos"</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">0</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></div></code></pre></div></div>
<p>リファクタリング後は警告がなくなった</p>
<div class="language-json codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-json codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token property" style="color:#36acaa">"findings"</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token property" style="color:#36acaa">"summary"</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token property" style="color:#36acaa">"errors"</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token property" style="color:#36acaa">"warnings"</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token property" style="color:#36acaa">"infos"</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">0</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></div></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="まとめdesignmd-は-aiエージェントと一緒に開発するためのインターフェース-です">まとめ：DESIGN.md は <strong>「AIエージェントと一緒に開発するためのインターフェース」</strong> です<a href="https://sawara.me/ko/blog/design-md-with-ai-agent#%E3%81%BE%E3%81%A8%E3%82%81designmd-%E3%81%AF-ai%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88%E3%81%A8%E4%B8%80%E7%B7%92%E3%81%AB%E9%96%8B%E7%99%BA%E3%81%99%E3%82%8B%E3%81%9F%E3%82%81%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%BF%E3%83%BC%E3%83%95%E3%82%A7%E3%83%BC%E3%82%B9-%E3%81%A7%E3%81%99" class="hash-link" aria-label="まとめdesignmd-は-aiエージェントと一緒に開発するためのインターフェース-です에 대한 직접 링크" title="まとめdesignmd-は-aiエージェントと一緒に開発するためのインターフェース-です에 대한 직접 링크" translate="no">​</a></h3>
<p>デザインドキュメントは、もはや「人間が後から確認するための資料」だけではありません。 <strong>「AIエージェントと一緒に開発するためのインターフェース」</strong> へと進化しています。</p>
<p>プロジェクトのルートに <code>DESIGN.md</code> を置くだけで、AIはより賢く、より一貫性のある提案をしてくれるようになるはずです。</p>]]></content:encoded>
            <category>AI</category>
            <category>Design</category>
            <category>Gemini CLI</category>
            <category>Frontend</category>
        </item>
        <item>
            <title><![CDATA[AIの「記憶」をデザインする：Gemini CLI における GEMINI.md 活用術]]></title>
            <link>https://sawara.me/ko/blog/ai-context-management</link>
            <guid>https://sawara.me/ko/blog/ai-context-management</guid>
            <pubDate>Sat, 16 May 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Gemini CLI を使って開発を進めていると、「さっきも同じ指摘をしたのに」「プロジェクトの規約を無視して別のライブラリを提案された」といった手戻りが発生することがあります。これらの問題の根本的な原因は、AIがプロジェクト特有の「文脈（コンテキスト）」を維持できていないことにあります。]]></description>
            <content:encoded><![CDATA[<p>Gemini CLI を使って開発を進めていると、「さっきも同じ指摘をしたのに」「プロジェクトの規約を無視して別のライブラリを提案された」といった手戻りが発生することがあります。これらの問題の根本的な原因は、AIがプロジェクト特有の「文脈（コンテキスト）」を維持できていないことにあります。</p>
<p>AIを活用した開発フローを最適化するためには、チャットのたびに指示を繰り返すのではなく、AIが参照するコンテキストを Markdown ファイルとして定義しておくことが重要です。今回は、Gemini CLI の機能を最大限に引き出すための <code>GEMINI.md</code> 活用術を解説します。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="プロジェクトの基本ルールを定義するプロジェクト固有の-geminimd">プロジェクトの「基本ルール」を定義する：プロジェクト固有の GEMINI.md<a href="https://sawara.me/ko/blog/ai-context-management#%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%81%AE%E5%9F%BA%E6%9C%AC%E3%83%AB%E3%83%BC%E3%83%AB%E3%82%92%E5%AE%9A%E7%BE%A9%E3%81%99%E3%82%8B%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E5%9B%BA%E6%9C%89%E3%81%AE-geminimd" class="hash-link" aria-label="プロジェクトの「基本ルール」を定義する：プロジェクト固有の GEMINI.md에 대한 직접 링크" title="プロジェクトの「基本ルール」を定義する：プロジェクト固有の GEMINI.md에 대한 직접 링크" translate="no">​</a></h3>
<p>プロジェクトのルートディレクトリに配置する <code>GEMINI.md</code> は、リポジトリにコミットしてチーム全体で共有するファイルです。ここには、プロジェクトの「絶対に守るべきルール」を記述します。</p>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="具体的な記載例">具体的な記載例<a href="https://sawara.me/ko/blog/ai-context-management#%E5%85%B7%E4%BD%93%E7%9A%84%E3%81%AA%E8%A8%98%E8%BC%89%E4%BE%8B" class="hash-link" aria-label="具体的な記載例에 대한 직접 링크" title="具体的��な記載例에 대한 직접 링크" translate="no">​</a></h4>
<div class="language-markdown codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-markdown codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token title important punctuation" style="color:#393A34">#</span><span class="token title important"> プロジェクト規約</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token title important punctuation" style="color:#393A34">##</span><span class="token title important"> 技術スタック</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token list punctuation" style="color:#393A34">-</span><span class="token plain"> React 18 / TypeScript</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token list punctuation" style="color:#393A34">-</span><span class="token plain"> UI ライブラリ: MUI (Material UI) v6</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token list punctuation" style="color:#393A34">-</span><span class="token plain"> スタイリング: CSS Modules (*.module.css) を使用</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token title important punctuation" style="color:#393A34">##</span><span class="token title important"> 設計原則</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token list punctuation" style="color:#393A34">-</span><span class="token plain"> 完全ローカル処理: サーバーサイドAPIは使用せず、全ての処理をブラウザ内で完結させること。</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token list punctuation" style="color:#393A34">-</span><span class="token plain"> 型安全性: </span><span class="token code-snippet code keyword" style="color:#00009f">`any`</span><span class="token plain"> 型の使用を禁止し、インターフェースを定義すること。</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token title important punctuation" style="color:#393A34">##</span><span class="token title important"> ディレクトリ構造</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token list punctuation" style="color:#393A34">-</span><span class="token plain"> ページコンポーネント: </span><span class="token code-snippet code keyword" style="color:#00009f">`src/pages/`</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token list punctuation" style="color:#393A34">-</span><span class="token plain"> 共通コンポーネント: </span><span class="token code-snippet code keyword" style="color:#00009f">`src/components/`</span><br></div></code></pre></div></div>
<p>このファイルがあることで、Gemini CLI はセッション開始時に自動的にプロジェクトの特性を反映し、一貫性のあるコードを提案できるようになります。</p>
<div class="theme-admonition theme-admonition-tip admonition_xJq3 alert alert--success"><div class="admonitionHeading_Gvgb"><span class="admonitionIcon_Rf37"><svg viewBox="0 0 12 16"><path fill-rule="evenodd" d="M6.5 0C3.48 0 1 2.19 1 5c0 .92.55 2.25 1 3 1.34 2.25 1.78 2.78 2 4v1h5v-1c.22-1.22.66-1.75 2-4 .45-.75 1-2.08 1-3 0-2.81-2.48-5-5.5-5zm3.64 7.48c-.25.44-.47.8-.67 1.11-.86 1.41-1.25 2.06-1.45 3.23-.02.05-.02.11-.02.17H5c0-.06 0-.13-.02-.17-.2-1.17-.59-1.83-1.45-3.23-.2-.31-.42-.67-.67-1.11C2.44 6.78 2 5.65 2 5c0-2.2 2.02-4 4.5-4 1.22 0 2.36.42 3.22 1.19C10.55 2.94 11 3.94 11 5c0 .66-.44 1.78-.86 2.48zM4 14h5c-.23 1.14-1.3 2-2.5 2s-2.27-.86-2.5-2z"></path></svg></span>팁</div><div class="admonitionContent_BuS1"><p><code>GEMINI.md</code> は長すぎると AI のトークンを圧迫します。核心となるルールのみを記載し、詳細な仕様書は別のファイルに分けてリンク（参照）させるのがおすすめです。</p></div></div>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="プロジェクト全体の標準スタイルを定義するグローバルな-geminimd">プロジェクト全体の標準スタイルを定義する：グローバルな GEMINI.md<a href="https://sawara.me/ko/blog/ai-context-management#%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E5%85%A8%E4%BD%93%E3%81%AE%E6%A8%99%E6%BA%96%E3%82%B9%E3%82%BF%E3%82%A4%E3%83%AB%E3%82%92%E5%AE%9A%E7%BE%A9%E3%81%99%E3%82%8B%E3%82%B0%E3%83%AD%E3%83%BC%E3%83%90%E3%83%AB%E3%81%AA-geminimd" class="hash-link" aria-label="プロジェクト全体の標準スタイルを定義する：グローバルな GEMINI.md에 대한 직접 링크" title="プロジェクト全体の標準スタイルを定義する：グローバルな GEMINI.md에 대한 직접 링크" translate="no">​</a></h3>
<p>特定のプロジェクトに閉じることなく、自分があらゆる開発において共通で適用したい標準スタイルや仕事の進め方は、ホームディレクトリの <code>~/.gemini/GEMINI.md</code> に記述します。</p>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="具体的な記載例-1">具体的な記載例<a href="https://sawara.me/ko/blog/ai-context-management#%E5%85%B7%E4%BD%93%E7%9A%84%E3%81%AA%E8%A8%98%E8%BC%89%E4%BE%8B-1" class="hash-link" aria-label="具体的な記載例에 대�한 직접 링크" title="具体的な記載例에 대한 직접 링크" translate="no">​</a></h4>
<div class="language-markdown codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-markdown codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token title important punctuation" style="color:#393A34">#</span><span class="token title important"> 開発標準スタイル</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token list punctuation" style="color:#393A34">-</span><span class="token plain"> 解説は常に日本語で行い、専門用語はなるべく避けて平易な言葉で説明してください。</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token list punctuation" style="color:#393A34">-</span><span class="token plain"> 実装の提案をする前に、まずは設計の選択肢を複数提示し、メリット・デメリットを比較してください。</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token list punctuation" style="color:#393A34">-</span><span class="token plain"> コード中のコメントや、JSDoc の記述には常に日本語を使用してください。</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token list punctuation" style="color:#393A34">-</span><span class="token plain"> 「なぜその実装を選んだのか」という技術的な根拠を必ず添えて回答してください。</span><br></div></code></pre></div></div>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="メリット">メリット<a href="https://sawara.me/ko/blog/ai-context-management#%E3%83%A1%E3%83%AA%E3%83%83%E3%83%88" class="hash-link" aria-label="メリット에 대한 직접 링크" title="メリット에 대한 직접 링크" translate="no">​</a></h4>
<p>新規プロジェクトであっても、Gemini CLI を起動した瞬間から「いつもの開発基準」が適用された状態でスムーズに作業を開始できます。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="aiが何を覚えているかを確認更新するmemory-コマンド">AIが何を覚えているかを確認・更新する：/memory コマンド<a href="https://sawara.me/ko/blog/ai-context-management#ai%E3%81%8C%E4%BD%95%E3%82%92%E8%A6%9A%E3%81%88%E3%81%A6%E3%81%84%E3%82%8B%E3%81%8B%E3%82%92%E7%A2%BA%E8%AA%8D%E6%9B%B4%E6%96%B0%E3%81%99%E3%82%8Bmemory-%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89" class="hash-link" aria-label="AIが何を覚えているかを確認・更新する：/memory コマンド에 대한 직접 링크" title="AIが何を覚えているかを確認・更新する：/memory コマンド에 대한 직접 링크" translate="no">​</a></h3>
<p>AI の記憶をメンテナンスするために、Gemini CLI の対話画面（チャットインターフェース）から直接実行できる便利なコマンドが用意されています。</p>
<ul>
<li class=""><strong><code>/memory show</code></strong>: 現在 AI が参照しているすべてのメモリ（グローバル、プロジェクト、サブディレクトリ単位の合算）を一覧表示します。AI にどのような指示が伝わっているかを確認するのに最適です。</li>
<li class=""><strong><code>/memory list</code></strong>: 現在読み込まれている <code>GEMINI.md</code> ファイルのパスを一覧表示します。</li>
<li class=""><strong><code>/memory reload</code></strong>: Markdownファイルを自分で編集した後、その変更を現在のセッションに即座に反映させたい場合に、CLI内で実行します。</li>
</ul>
<p>AI に新しいことを覚えさせたい場合は、適切な <code>GEMINI.md</code> をエディタで開き、指示を書き加えてから、Gemini CLI 内で <code>/memory reload</code> を実行します。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="まずは-init-から始めよう">まずは /init から始めよう<a href="https://sawara.me/ko/blog/ai-context-management#%E3%81%BE%E3%81%9A%E3%81%AF-init-%E3%81%8B%E3%82%89%E5%A7%8B%E3%82%81%E3%82%88%E3%81%86" class="hash-link" aria-label="まずは /init から始めよう에 대한 직접 링크" title="まずは /init から始めよう에 대한 직접 링크" translate="no">​</a></h3>
<p>何から始めればよいかわからない方は、まずは Gemini CLI の対話画面で <strong><code>/init</code></strong> コマンドを実行してみてください。</p>
<p>AIが現在のプロジェクト構成を分析し、最適な <code>GEMINI.md</code> の雛形を自動で作成してくれます。生成された土台をもとに、現場のルールや固有の制約を少しずつ付け足していくことで、AIの回答精度と一貫性を向上させることができます。</p>
<p>まずはこのコマンドを使って、プロジェクトの土台作りから着手することをお勧めします。</p>]]></content:encoded>
            <category>Gemini CLI</category>
            <category>AI</category>
            <category>Development</category>
        </item>
        <item>
            <title><![CDATA[Gemini CLI「Skills」入門：特定タスクに特化した専門知識をAIに持たせる方法]]></title>
            <link>https://sawara.me/ko/blog/gemini-cli-skills</link>
            <guid>https://sawara.me/ko/blog/gemini-cli-skills</guid>
            <pubDate>Wed, 13 May 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Gemini CLIを日々の開発で活用していると、特定の定型作業（フレームワーク固有のコンポーネント作成、テストコードの自動生成、デプロイ手順の実行など）をより確実に、かつ効率的に行いたい場面が増えてきます。このような特定タスクへの「専門知識」をAIに持たせる仕組みが「Skills」機能です。]]></description>
            <content:encoded><![CDATA[<p>Gemini CLIを日々の開発で活用していると、特定の定型作業（フレームワーク固有のコンポーネント作成、テストコードの自動生成、デプロイ手順の実行など）をより確実に、かつ効率的に行いたい場面が増えてきます。このような特定タスクへの「専門知識」をAIに持たせる仕組みが「Skills」機能です。</p>
<p>今回は、Skills機能の概要から実装手順、Gemini CLI上での確認方法までを詳しく解説します。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="gemini-cliのskillsとは">Gemini CLIの「Skills」とは？<a href="https://sawara.me/ko/blog/gemini-cli-skills#gemini-cli%E3%81%AEskills%E3%81%A8%E3%81%AF" class="hash-link" aria-label="Gemini CLIの「Skills」とは？에 대한 직접 링크" title="Gemini CLIの「Skills」とは？에 대한 직접 링크" translate="no">​</a></h3>
<p>Skillsは、特定のワークフローやリソースをカプセル化した<strong>オンデマンドの専門知識モジュール</strong>です。<a href="https://agentskills.io/" target="_blank" rel="noopener noreferrer" class="">Agent Skills</a> という標準規格に基づいており、必要な時だけ呼び出すことで、AIの限られた「コンテキスト（記憶量）」を節約しつつ、高度なタスクを遂行させることが可能です。</p>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="他の機能との違い">他の機能との違い<a href="https://sawara.me/ko/blog/gemini-cli-skills#%E4%BB%96%E3%81%AE%E6%A9%9F%E8%83%BD%E3%81%A8%E3%81%AE%E9%81%95%E3%81%84" class="hash-link" aria-label="他の機能との違い에 대한 직접 링크" title="他の機能との違い에 대한 직접 링크" translate="no">​</a></h4>
<p>Gemini CLIには、AIの振る舞いを制御する機能がいくつかあります。これらは「誰が、いつ、どのような知識を持って動くか」という役割が異なります。</p>
<ul>
<li class=""><strong>Instructions (<code>GEMINI.md</code>)</strong>: 常に読み込まれる「基本方針」です。プロジェクト全体の共通ルールやディレクトリ構造など、AIが常に意識しておくべき前提知識を伝えます。</li>
<li class=""><strong>Subagents</strong>: 特定の専門タスクを肩代わりしてくれる「分身（専門チーム）」です。広範囲な調査や大量のファイル修正など、手順が多くコンテキストを消費しそうな作業をサブエージェントに依頼（デリゲート）することで、メインの会話をクリーンに保ちます。</li>
<li class=""><strong>Skills</strong>: 特定のタスクが発生した時にだけ装備する「専門知識パック」です。特定の指示書（<code>SKILL.md</code>）や補助スクリプトが含まれます。</li>
</ul>
<p><strong>具体的な使い分けの例：</strong></p>
<ul>
<li class="">「新しいブログ記事を書く」→ メインのAIが <strong>blog-writerスキル</strong> を装備して自分で執筆します。</li>
<li class="">「過去100件の記事のタグを一括修正する」→ メインのAIが <strong>generalistサブエージェント</strong> に作業を任せます。</li>
</ul>
<p>簡単に言えば、「自分自身が身につける専門知識（Skills）」か、「自分以外の専門家に任せる仕組み（Subagents）」か、という違いです。</p>
<div class="theme-admonition theme-admonition-tip admonition_xJq3 alert alert--success"><div class="admonitionHeading_Gvgb"><span class="admonitionIcon_Rf37"><svg viewBox="0 0 12 16"><path fill-rule="evenodd" d="M6.5 0C3.48 0 1 2.19 1 5c0 .92.55 2.25 1 3 1.34 2.25 1.78 2.78 2 4v1h5v-1c.22-1.22.66-1.75 2-4 .45-.75 1-2.08 1-3 0-2.81-2.48-5-5.5-5zm3.64 7.48c-.25.44-.47.8-.67 1.11-.86 1.41-1.25 2.06-1.45 3.23-.02.05-.02.11-.02.17H5c0-.06 0-.13-.02-.17-.2-1.17-.59-1.83-1.45-3.23-.2-.31-.42-.67-.67-1.11C2.44 6.78 2 5.65 2 5c0-2.2 2.02-4 4.5-4 1.22 0 2.36.42 3.22 1.19C10.55 2.94 11 3.94 11 5c0 .66-.44 1.78-.86 2.48zM4 14h5c-.23 1.14-1.3 2-2.5 2s-2.27-.86-2.5-2z"></path></svg></span>팁</div><div class="admonitionContent_BuS1"><p>Skillsは「必要な時だけロードされる」ため、大量の知識を持たせても普段のチャットの邪魔をせず、トークン消費も抑えられるというメリットがあります。</p></div></div>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="スキルの実装手順">スキルの実装手順<a href="https://sawara.me/ko/blog/gemini-cli-skills#%E3%82%B9%E3%82%AD%E3%83%AB%E3%81%AE%E5%AE%9F%E8%A3%85%E6%89%8B%E9%A0%86" class="hash-link" aria-label="スキルの実装手順에 대한 직접 링크" title="スキルの実装手順에 대한 직접 링크" translate="no">​</a></h3>
<p>スキルは、特定の構造を持ったディレクトリとして作成します。</p>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-保存場所の決定">1. 保存場所の決定<a href="https://sawara.me/ko/blog/gemini-cli-skills#1-%E4%BF%9D%E5%AD%98%E5%A0%B4%E6%89%80%E3%81%AE%E6%B1%BA%E5%AE%9A" class="hash-link" aria-label="1. 保存場所の決定에 대한 직접 링크" title="1. 保存場所の決定에 대한 직접 링크" translate="no">​</a></h4>
<p>スキルは以下のいずれかの場所に配置します。</p>
<ul>
<li class=""><strong>プロジェクト固有のスキル</strong>: <code>.agents/skills/&lt;スキル名&gt;/</code> （または <code>.gemini/skills/</code>）</li>
<li class=""><strong>ユーザー全体のスキル</strong>: <code>~/.agents/skills/&lt;スキル名&gt;/</code> （または <code>~/.gemini/skills/</code>）</li>
</ul>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-skillmd-の作成">2. SKILL.md の作成<a href="https://sawara.me/ko/blog/gemini-cli-skills#2-skillmd-%E3%81%AE%E4%BD%9C%E6%88%90" class="hash-link" aria-label="2. SKILL.md の作成에 대한 직접 링크" title="2. SKILL.md の作成에 대한 직접 링크" translate="no">​</a></h4>
<p>スキルのディレクトリ内には、必ず <code>SKILL.md</code> というファイルを配置します。このファイルは <strong>YAML Frontmatter</strong> でメタデータを記述し、本文にMarkdownで指示を書く形式になります。</p>
<div class="language-markdown codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-markdown codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token front-matter-block punctuation" style="color:#393A34">---</span><span class="token front-matter-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token front-matter-block"></span><span class="token front-matter-block front-matter yaml language-yaml key atrule" style="color:#00a4db">name</span><span class="token front-matter-block front-matter yaml language-yaml punctuation" style="color:#393A34">:</span><span class="token front-matter-block front-matter yaml language-yaml"> スキル名</span><br></div><div class="token-line" style="color:#393A34"><span class="token front-matter-block front-matter yaml language-yaml"></span><span class="token front-matter-block front-matter yaml language-yaml key atrule" style="color:#00a4db">description</span><span class="token front-matter-block front-matter yaml language-yaml punctuation" style="color:#393A34">:</span><span class="token front-matter-block front-matter yaml language-yaml"> このスキルの概要を記述します。Gemini CLIが「このスキルを使うべきか」を判断するために非常に重要なセクションです。「〜をする時にこのスキルを使用して下さい」といったトリガーを具体的に書きます。</span><span class="token front-matter-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token front-matter-block"></span><span class="token front-matter-block punctuation" style="color:#393A34">---</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token title important punctuation" style="color:#393A34">#</span><span class="token title important"> スキル名</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">スキルが有効化された後に、AIが従うべき具体的な手順やルールを記述します。</span><br></div></code></pre></div></div>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="3-関連リソースオプション">3. 関連リソース（オプション）<a href="https://sawara.me/ko/blog/gemini-cli-skills#3-%E9%96%A2%E9%80%A3%E3%83%AA%E3%82%BD%E3%83%BC%E3%82%B9%E3%82%AA%E3%83%97%E3%82%B7%E3%83%A7%E3%83%B3" class="hash-link" aria-label="3. 関連リソース（オプション）에 대한 직접 링크" title="3. 関連リソース（オプション）에 대한 직접 링크" translate="no">​</a></h4>
<p>必要に応じて、以下のフォルダを作成し、リソースを追加できます。</p>
<ul>
<li class=""><code>scripts/</code>: 実行可能なスクリプト（Node.js, Pythonなど）。</li>
<li class=""><code>references/</code>: 詳細な仕様書やスキーマ。</li>
<li class=""><code>assets/</code>: テンプレートやボイラープレート。</li>
</ul>
<p><strong>関連リソースの使い方・指示の書き方</strong>
これらのリソースを追加した場合は、AIがそれらを適切に利用できるよう、<code>SKILL.md</code> の本文中で「どのファイルをどう使ってほしいか」を明記することが重要です。</p>
<ul>
<li class=""><strong>スクリプトを実行させたい場合</strong>
<div class="language-markdown codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-markdown codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token list punctuation" style="color:#393A34">1.</span><span class="token plain"> 最初に </span><span class="token code-snippet code keyword" style="color:#00009f">`scripts/setup-boilerplate.sh`</span><span class="token plain"> を実行して雛形を作成してください。</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token list punctuation" style="color:#393A34">2.</span><span class="token plain"> 生成されたファイルに対して...</span><br></div></code></pre></div></div>
</li>
<li class=""><strong>参考資料を読ませたい場合</strong>
<div class="language-markdown codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-markdown codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">詳細なコーディング規約については </span><span class="token code-snippet code keyword" style="color:#00009f">`references/style-guide.md`</span><span class="token plain"> を参照してください。</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">実装を開始する前に必ずこのファイルを読み、ルールを遵守すること。</span><br></div></code></pre></div></div>
</li>
</ul>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="skillmd-の例">SKILL.md の例<a href="https://sawara.me/ko/blog/gemini-cli-skills#skillmd-%E3%81%AE%E4%BE%8B" class="hash-link" aria-label="SKILL.md の例에 대한 직접 링크" title="SKILL.md の例에 대한 직접 링크" translate="no">​</a></h3>
<p>スキルは目的に応じて様々な形で定義できます。ここでは具体的な2つの例を紹介します。</p>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="例1コンポーネントの自動生成">例1：コンポーネントの自動生成<a href="https://sawara.me/ko/blog/gemini-cli-skills#%E4%BE%8B1%E3%82%B3%E3%83%B3%E3%83%9D%E3%83%BC%E3%83%8D%E3%83%B3%E3%83%88%E3%81%AE%E8%87%AA%E5%8B%95%E7%94%9F%E6%88%90" class="hash-link" aria-label="例1：コンポーネントの自動生成에 대한 직접 링크" title="例1：コンポーネントの自動生成에 대한 직접 링크" translate="no">​</a></h4>
<p>プロジェクト固有のReactコンポーネントを自動生成するための <code>react-component-generator</code> スキルの構成例です。</p>
<div class="language-markdown codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-markdown codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token front-matter-block punctuation" style="color:#393A34">---</span><span class="token front-matter-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token front-matter-block"></span><span class="token front-matter-block front-matter yaml language-yaml key atrule" style="color:#00a4db">name</span><span class="token front-matter-block front-matter yaml language-yaml punctuation" style="color:#393A34">:</span><span class="token front-matter-block front-matter yaml language-yaml"> react</span><span class="token front-matter-block front-matter yaml language-yaml punctuation" style="color:#393A34">-</span><span class="token front-matter-block front-matter yaml language-yaml">component</span><span class="token front-matter-block front-matter yaml language-yaml punctuation" style="color:#393A34">-</span><span class="token front-matter-block front-matter yaml language-yaml">generator</span><br></div><div class="token-line" style="color:#393A34"><span class="token front-matter-block front-matter yaml language-yaml"></span><span class="token front-matter-block front-matter yaml language-yaml key atrule" style="color:#00a4db">description</span><span class="token front-matter-block front-matter yaml language-yaml punctuation" style="color:#393A34">:</span><span class="token front-matter-block front-matter yaml language-yaml"> プロジェクトの規約に沿ったReactコンポーネントを生成するスキル。「新しいコンポーネントを作成して」という指示の際に使用してください。</span><span class="token front-matter-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token front-matter-block"></span><span class="token front-matter-block punctuation" style="color:#393A34">---</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token title important punctuation" style="color:#393A34">#</span><span class="token title important"> react-component-generator</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token title important punctuation" style="color:#393A34">##</span><span class="token title important"> コンポーネント作成規約</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token list punctuation" style="color:#393A34">1.</span><span class="token plain"> 基本構造: Functional Component (FC) と Hooks を使用すること。</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token list punctuation" style="color:#393A34">2.</span><span class="token plain"> スタイリング: CSS Modules を使用し、</span><span class="token code-snippet code keyword" style="color:#00009f">`[name].module.css`</span><span class="token plain"> として同階層に配置すること。</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token list punctuation" style="color:#393A34">3.</span><span class="token plain"> テスト: 必須。必ず </span><span class="token code-snippet code keyword" style="color:#00009f">`__tests__`</span><span class="token plain"> フォルダ内に </span><span class="token code-snippet code keyword" style="color:#00009f">`[name].test.tsx`</span><span class="token plain"> を作成し、基本的なレンダリングテストを含めること。</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">   ...</span><br></div></code></pre></div></div>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="例2コードレビューと監査">例2：コードレビューと監査<a href="https://sawara.me/ko/blog/gemini-cli-skills#%E4%BE%8B2%E3%82%B3%E3%83%BC%E3%83%89%E3%83%AC%E3%83%93%E3%83%A5%E3%83%BC%E3%81%A8%E7%9B%A3%E6%9F%BB" class="hash-link" aria-label="例2：コードレビューと監査에 대한 직접 링크" title="例2：コードレビューと監査에 대한 직접 링크" translate="no">​</a></h4>
<p>プロジェクト独自の基準でコードをチェックさせる <code>code-reviewer</code> スキルの例です。先述の「関連リソース」を読み込ませる指示を組み込んでいます。</p>
<div class="language-markdown codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-markdown codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token front-matter-block punctuation" style="color:#393A34">---</span><span class="token front-matter-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token front-matter-block"></span><span class="token front-matter-block front-matter yaml language-yaml key atrule" style="color:#00a4db">name</span><span class="token front-matter-block front-matter yaml language-yaml punctuation" style="color:#393A34">:</span><span class="token front-matter-block front-matter yaml language-yaml"> code</span><span class="token front-matter-block front-matter yaml language-yaml punctuation" style="color:#393A34">-</span><span class="token front-matter-block front-matter yaml language-yaml">reviewer</span><br></div><div class="token-line" style="color:#393A34"><span class="token front-matter-block front-matter yaml language-yaml"></span><span class="token front-matter-block front-matter yaml language-yaml key atrule" style="color:#00a4db">description</span><span class="token front-matter-block front-matter yaml language-yaml punctuation" style="color:#393A34">:</span><span class="token front-matter-block front-matter yaml language-yaml"> プロジェクトのセキュリティ基準とコーディング規約に基づいてコードレビューを行うスキル。「コードをレビューして」「脆弱性がないか確認して」といった指示で使用してください。</span><span class="token front-matter-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token front-matter-block"></span><span class="token front-matter-block punctuation" style="color:#393A34">---</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token title important punctuation" style="color:#393A34">#</span><span class="token title important"> code-reviewer</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token title important punctuation" style="color:#393A34">##</span><span class="token title important"> レビュー手順</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token list punctuation" style="color:#393A34">1.</span><span class="token plain"> まず </span><span class="token code-snippet code keyword" style="color:#00009f">`references/security-guidelines.md`</span><span class="token plain"> を読み、本プロジェクトのセキュリティ基準を把握してください。</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token list punctuation" style="color:#393A34">2.</span><span class="token plain"> 対象となるコードに対して、以下の観点でチェックを行ってください。</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">   </span><span class="token list punctuation" style="color:#393A34">-</span><span class="token plain"> データベースクエリで N+1 問題が発生していないか</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">   </span><span class="token list punctuation" style="color:#393A34">-</span><span class="token plain"> ログに個人情報や認証情報が出力されていないか</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token list punctuation" style="color:#393A34">3.</span><span class="token plain"> 指摘事項があれば、具体的な修正案と共に提示してください。</span><br></div></code></pre></div></div>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="gemini-cliでの確認利用方法">Gemini CLIでの確認・利用方法<a href="https://sawara.me/ko/blog/gemini-cli-skills#gemini-cli%E3%81%A7%E3%81%AE%E7%A2%BA%E8%AA%8D%E5%88%A9%E7%94%A8%E6%96%B9%E6%B3%95" class="hash-link" aria-label="Gemini CLIでの確認・利用方法에 대한 직접 링크" title="Gemini CLIでの確認・利用方法에 대한 직접 링크" translate="no">​</a></h3>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="自動検知discovery">自動検知（Discovery）<a href="https://sawara.me/ko/blog/gemini-cli-skills#%E8%87%AA%E5%8B%95%E6%A4%9C%E7%9F%A5discovery" class="hash-link" aria-label="自動検知（Discovery）에 대한 직접 링크" title="自動検知（Discovery）에 대한 직접 링크" translate="no">​</a></h4>
<p>Gemini CLIのセッション開始時、指定されたディレクトリにあるスキルが自動的にスキャンされます。この時点では中身は読み込まれず、Frontmatterの <code>description</code> の情報だけがAIに伝えられます。</p>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="有効化activation">有効化（Activation）<a href="https://sawara.me/ko/blog/gemini-cli-skills#%E6%9C%89%E5%8A%B9%E5%8C%96activation" class="hash-link" aria-label="有効化（Activation）에 대한 직접 링크" title="有効化（Activation）에 대한 직접 링크" translate="no">​</a></h4>
<p>ユーザーの依頼内容がスキルの説明と一致すると、AIは内部的に <code>activate_skill</code> ツールを呼び出します。</p>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="ユーザーの同意">ユーザーの同意<a href="https://sawara.me/ko/blog/gemini-cli-skills#%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E3%81%AE%E5%90%8C%E6%84%8F" class="hash-link" aria-label="ユーザーの同意에 대한 직접 링크" title="ユーザーの同意에 대한 직접 링크" translate="no">​</a></h4>
<p>スキルが呼び出されると、以下のような確認が表示されます。</p>
<div class="language-text codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">? Activate skill: react-component-generator? › (y/N)</span><br></div></code></pre></div></div>
<p>「y」を押すことで初めて <code>SKILL.md</code> の全文がコンテキストに注入され、専門的な指示に従った動作が開始されます。</p>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="管理コマンド">管理コマンド<a href="https://sawara.me/ko/blog/gemini-cli-skills#%E7%AE%A1%E7%90%86%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89" class="hash-link" aria-label="管理コマンド에 대한 직접 링크" title="管理コマンド에 대한 직접 링크" translate="no">​</a></h4>
<p>CLI上で以下のコマンドを使用することで、スキルの状態を確認・操作できます。</p>
<ul>
<li class=""><code>/skills list</code>: 現在利用可能なスキルの一覧を表示。</li>
<li class=""><code>/skills reload</code>: 新しく作成したスキルを即座に認識させる。</li>
</ul>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="効率的なスキル作成のベストプラクティス">効率的なスキル作成のベストプラクティス<a href="https://sawara.me/ko/blog/gemini-cli-skills#%E5%8A%B9%E7%8E%87%E7%9A%84%E3%81%AA%E3%82%B9%E3%82%AD%E3%83%AB%E4%BD%9C%E6%88%90%E3%81%AE%E3%83%99%E3%82%B9%E3%83%88%E3%83%97%E3%83%A9%E3%82%AF%E3%83%86%E3%82%A3%E3%82%B9" class="hash-link" aria-label="効率的なスキル作成のベストプラクティス에 대한 직접 링크" title="効率的なスキル作成のベストプラクティス에 대한 직접 링크" translate="no">​</a></h3>
<ol>
<li class=""><strong>説明文（Description）を具体的に</strong>: AIが「いつ使うべきか」を迷わないよう、具体的なキーワード（「コンポーネント作成」「デプロイ」「テスト作成」など）を含めてください。</li>
<li class=""><strong>情報の階層化</strong>: <code>SKILL.md</code> 本体には核心となる手順だけを書き、膨大なドキュメントは <code>references/</code> フォルダに分けることで、コンテキストの使用量を最小限に抑えられます。</li>
<li class=""><strong>LLMフレンドリーな出力</strong>: <code>scripts/</code> に含めるスクリプトは、人間向けの詳細なログよりも、AIが理解しやすい簡潔な結果を標準出力に返すように設計してください。</li>
</ol>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="最強の助っ人skill-creatorでスキルを自動作成する">最強の助っ人「skill-creator」でスキルを自動作成する<a href="https://sawara.me/ko/blog/gemini-cli-skills#%E6%9C%80%E5%BC%B7%E3%81%AE%E5%8A%A9%E3%81%A3%E4%BA%BAskill-creator%E3%81%A7%E3%82%B9%E3%82%AD%E3%83%AB%E3%82%92%E8%87%AA%E5%8B%95%E4%BD%9C%E6%88%90%E3%81%99%E3%82%8B" class="hash-link" aria-label="最強の助っ人「skill-creator」でスキルを自動作成する에 대한 직접 링크" title="最強の助っ人「skill-creator」でスキルを自動作成する에 대한 직접 링크" translate="no">​</a></h3>
<p>手動でディレクトリやファイルを作成するのも良いですが、Gemini CLI にはスキルの作成を強力にサポートしてくれる <strong><code>skill-creator</code></strong> という組み込みスキルが存在します。これを使うことで、ベストプラクティスに基づいたスキルの雛形を対話形式で自動作成できます。</p>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-skill-creator-の有効化呼び出し方法">1. skill-creator の有効化（呼び出し）方法<a href="https://sawara.me/ko/blog/gemini-cli-skills#1-skill-creator-%E3%81%AE%E6%9C%89%E5%8A%B9%E5%8C%96%E5%91%BC%E3%81%B3%E5%87%BA%E3%81%97%E6%96%B9%E6%B3%95" class="hash-link" aria-label="1. skill-creator の有効化（呼び出し）方法에 대한 직접 링크" title="1. skill-creator の有効化（呼び出し）方法에 대한 직접 링크" translate="no">​</a></h4>
<p>特別な設定は不要です。Gemini CLI とのチャットの中で、以下のように指示を出すだけで <code>skill-creator</code> が起動します。</p>
<ul>
<li class="">「新しいスキルを作成したい」</li>
<li class="">「〜のためのスキルを作って」</li>
<li class="">「現在の作業内容をスキルとして切り出して」</li>
</ul>
<p>AIが「スキル作成の専門家」モードに切り替わり、必要な情報をヒアリングしてくれます。</p>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-具体的な作成フロー">2. 具体的な作成フロー<a href="https://sawara.me/ko/blog/gemini-cli-skills#2-%E5%85%B7%E4%BD%93%E7%9A%84%E3%81%AA%E4%BD%9C%E6%88%90%E3%83%95%E3%83%AD%E3%83%BC" class="hash-link" aria-label="2. 具体的な作成フロー에 대한 직접 링크" title="2. 具体的な作成フロー에 대한 직접 링크" translate="no">​</a></h4>
<p><code>skill-creator</code> を使うと、以下のステップでスムーズにスキルを構築できます。</p>
<ol>
<li class=""><strong>具体例の検討</strong>: ユーザーがそのスキルをどのように使うか、AIと一緒に具体的なシナリオを考えます。</li>
<li class=""><strong>リソースの計画</strong>: 必要なスクリプト（<code>scripts/</code>）、参考資料（<code>references/</code>）、テンプレート（<code>assets/</code>）を洗い出します。</li>
<li class=""><strong>初期化 (Initialization)</strong>: AIが内部で <code>init_skill.cjs</code> を実行し、<code>SKILL.md</code> のテンプレートやフォルダ構造を自動生成します。</li>
<li class=""><strong>実装と編集</strong>: 生成された雛形をもとに、AIが具体的な指示内容やスクリプトを記述していきます。</li>
<li class=""><strong>パッケージング</strong>: <code>package_skill.cjs</code> を使用して、配布可能な <code>.skill</code> ファイル（zip形式）にまとめます。</li>
<li class=""><strong>インストールとリロード</strong>: <code>gemini skills install</code> コマンドで環境にインストールし、最後に <code>/skills reload</code> で即座に有効化します。</li>
</ol>
<div class="theme-admonition theme-admonition-info admonition_xJq3 alert alert--info"><div class="admonitionHeading_Gvgb"><span class="admonitionIcon_Rf37"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M7 2.3c3.14 0 5.7 2.56 5.7 5.7s-2.56 5.7-5.7 5.7A5.71 5.71 0 0 1 1.3 8c0-3.14 2.56-5.7 5.7-5.7zM7 1C3.14 1 0 4.14 0 8s3.14 7 7 7 7-3.14 7-7-3.14-7-7-7zm1 3H6v5h2V4zm0 6H6v2h2v-2z"></path></svg></span>정보</div><div class="admonitionContent_BuS1"><p><code>skill-creator</code> は、単にファイルを作るだけでなく「AIが理解しやすい指示の書き方」や「コンテキストを節約するための情報の階層化」といったノウハウを自動的に適用してくれるため、初心者でもクオリティの高いスキルを作成できます。</p></div></div>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="スキルは使いながら育てていくもの">スキルは使いながら「育てて」いくもの<a href="https://sawara.me/ko/blog/gemini-cli-skills#%E3%82%B9%E3%82%AD%E3%83%AB%E3%81%AF%E4%BD%BF%E3%81%84%E3%81%AA%E3%81%8C%E3%82%89%E8%82%B2%E3%81%A6%E3%81%A6%E3%81%84%E3%81%8F%E3%82%82%E3%81%AE" class="hash-link" aria-label="スキルは使いながら「育てて」いくもの에 대한 직접 링크" title="スキルは使いながら「育てて」いくもの에 대한 직접 링크" translate="no">​</a></h3>
<p>スキルは一度完璧なものを作って終わりではありません。日々の開発で使いながら、足りない指示を追加したり、不要な手順を削ったりして<strong>継続的に成長させていく</strong>ことがこの機能の醍醐味です。</p>
<p><strong>【成長の具体例：コンポーネント生成スキルの場合】</strong></p>
<ol>
<li class=""><strong>初期段階</strong>
まずは「CSS Modulesとテストファイルを作成する」という最低限のルールだけで運用を始めます。</li>
<li class=""><strong>課題の発見とアップデート</strong>
しばらく使っていると「Storybookのファイルも毎回手作業で作っているな」と気づきます。そこで <code>SKILL.md</code> に「必ず <code>[name].stories.tsx</code> も生成すること」という一文を書き足します。</li>
<li class=""><strong>チームの知見を反映</strong>
ある日、アクセシビリティ（a11y）の対応漏れによるバグが発生しました。二度と同じミスを起こさないよう、「コンポーネントには適切な <code>aria-</code> 属性を必ず付与すること」というルールを追記します。</li>
</ol>
<p>このように、<strong>「手作業が発生した時」や「ミスが起きた時」がスキルをアップデートする最大のチャンス</strong>です。<code>/skills reload</code> コマンドを使えば変更は即座に反映されるため、まるで頼れる後輩エンジニアを少しずつ育成していくような感覚で活用できます。</p>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="まとめ">まとめ<a href="https://sawara.me/ko/blog/gemini-cli-skills#%E3%81%BE%E3%81%A8%E3%82%81" class="hash-link" aria-label="まとめ에 대한 직접 링크" title="まとめ에 대한 직접 링크" translate="no">​</a></h3>
<p>Skills機能は、Gemini CLIをただの汎用AIから「プロジェクトのルールを熟知した専門家」へと進化させるための鍵です。</p>
<p>自分自身のワークフローを振り返り、何度も繰り返している指示や手順があれば、ぜひオリジナルのスキルとして切り出してみてください。それだけで、AIとの協業は驚くほどスムーズになります。</p>]]></content:encoded>
            <category>Gemini CLI</category>
            <category>AI</category>
            <category>Development</category>
        </item>
        <item>
            <title><![CDATA[DocusaurusをGitHub Pagesで動かす]]></title>
            <link>https://sawara.me/ko/blog/docusaurus-github-pages</link>
            <guid>https://sawara.me/ko/blog/docusaurus-github-pages</guid>
            <pubDate>Tue, 05 May 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[DocusaurusをGitHub Pagesで動かす]]></description>
            <content:encoded><![CDATA[<p><img decoding="async" loading="lazy" alt="DocusaurusをGitHub Pagesで動かす" src="data:image/webp;base64,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" width="1113" height="258" class="img_ev3q"></p>
<p>このサイト(sawara.me)はDocusaursで作成し、GitHub Pagesでホストしています。</p>
<p>オープンソースのDocusaurusとオンラインプラットフォームのGitHubを組み合わせることで、無料で簡単にサイトを公開することができます。</p>
<p>今回はDocusaurusとGitHub Pagesという機能を使ったサイトの公開方法について紹介します。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="docusaurusとは">Docusaurusとは<a href="https://sawara.me/ko/blog/docusaurus-github-pages#docusaurus%E3%81%A8%E3%81%AF" class="hash-link" aria-label="Docusaurusとは에 대한 직접 링크" title="Docusaurusとは에 대한 직접 링크" translate="no">​</a></h3>
<p>Docusaurusは、Meta（旧Facebook）が開発しているオープンソースの静的サイトジェネレーターです。主にソフトウェアのドキュメントサイトを作成するために設計されていますが、ブログ機能やカスタムページ作成機能も充実しており、個人ブログやポートフォリオサイトとしても非常に優秀です。</p>
<p>Reactベースで構築されており、MarkdownやMDX（Markdownの中でReactコンポーネントを使える形式）を使って、素早く美しく、かつ高速なサイトを作成できるのが特徴です。</p>
<p>公式サイト： <a href="https://docusaurus.io/" target="_blank" rel="noopener noreferrer" class="">https://docusaurus.io/</a></p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="github-pagesとは">GitHub Pagesとは<a href="https://sawara.me/ko/blog/docusaurus-github-pages#github-pages%E3%81%A8%E3%81%AF" class="hash-link" aria-label="GitHub Pagesとは에 대한 직접 링크" title="GitHub Pagesとは에 대한 직접 링크" translate="no">​</a></h3>
<p>GitHub Pagesは、GitHubのリポジトリから直接Webサイトをホストできるサービスです。HTML、CSS、JavaScriptファイルをリポジトリにプッシュするだけで、無料でサイトを公開できます。</p>
<p>Docusaurusのような静的サイトジェネレーターとの相性が非常に良く、ビルドしたファイルをGitHub Pagesにデプロイすることで、サーバーの管理をすることなくサイトを運用できます。</p>
<p>GitHub Pagesのドキュメント： <a href="https://docs.github.com/ja/pages" target="_blank" rel="noopener noreferrer" class="">https://docs.github.com/ja/pages</a></p>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="githubでリポジトリを作成">GitHubでリポジトリを作成<a href="https://sawara.me/ko/blog/docusaurus-github-pages#github%E3%81%A7%E3%83%AA%E3%83%9D%E3%82%B8%E3%83%88%E3%83%AA%E3%82%92%E4%BD%9C%E6%88%90" class="hash-link" aria-label="GitHubでリポジトリを作成에 대한 직접 링크" title="GitHubでリポジトリを作成에 대한 직접 링크" translate="no">​</a></h3>
<p>GitHubのアカウントを持っていない人はまずGitHubのアカウントを作成してください。</p>
<p>GitHubにログイン後ヘッダーの「+」ボタンから「New Repository」を選択して、リポジトリを作成します。</p>
<p><img decoding="async" loading="lazy" alt="リポジトリ作成" src="data:image/webp;base64,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" width="275" height="326" class="img_ev3q"></p>
<p>リポジトリとはプログラムのソースコード（ファイル）を管理する場所です。Docusaurusのプロジェクトファイルを管理するための場所を作るイメージです。</p>
<p>「Repository Name」を入力して、「Create repository」をクリックすれば作成完了です。</p>
<p><img decoding="async" loading="lazy" alt="リポジトリ作成" src="https://sawara.me/ko/assets/images/docusaurus-github-pages_002-fe0cb1b5f537b33168d552584267ff7c.webp" width="807" height="784" class="img_ev3q"></p>
<p>「Repository Name」を<code>&lt;GitHubアカウント名&gt;.github.io</code> という名前で作成すれば、そのまま <code>https://&lt;GitHubアカウント名&gt;.github.io</code> というURLで公開できるようになります。</p>
<p>今回私は「sample-doc」というリポジトリを作成しましたが、その場合でも <code>https://sawarame.github.io/sample-doc/</code> という形で公開することができます。</p>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="docusaurusインストール">Docusaurusインストール<a href="https://sawara.me/ko/blog/docusaurus-github-pages#docusaurus%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB" class="hash-link" aria-label="Docusaurusインストール에 대한 직접 링크" title="Docusaurusインストール에 대한 직접 링크" translate="no">​</a></h3>
<p>次に、ローカルでDocusaurusのプロジェクトを作成し、GitHubにプッシュします。</p>
<p>ローカルのターミナルを開いて下記コマンドを実行し、Docusaurusのプロジェクトを作成します。</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">npx create-docusaurus@latest &lt;リポジトリ名&gt; classic --typescript</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">cd &lt;リポジトリ名&gt;</span><br></div></code></pre></div></div>
<p>リポジトリ名のところは自身で作成したリポジトリ名に変更して下さい。</p>
<p>次にGitの初期化を行います。</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain"># Gitの初期化とプッシュ</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">git init</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">git branch -M main</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">git add .</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">git commit -m "first commit"</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">git remote add origin git@github.com:&lt;GitHubアカウント名&gt;/&lt;リポジトリ名&gt;.git</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">git push -u origin main</span><br></div></code></pre></div></div>
<p>こちらも自身のGitHubアカウント名・リポジトリ名に合わせて変更してください。</p>
<p>次にGitHub Pagesで公開するためのブランチを作成します。gh-pagesというブランチを作成します。</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain"># デプロイ用のブランチ作成</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">git checkout -b gh-pages</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">git push --set-upstream origin gh-pages</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"># mainブランチに戻るのを忘れずに</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">git checkout main</span><br></div></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="github-pagesに公開">GitHub Pagesに公開<a href="https://sawara.me/ko/blog/docusaurus-github-pages#github-pages%E3%81%AB%E5%85%AC%E9%96%8B" class="hash-link" aria-label="GitHub Pagesに公開에 대한 직접 링크" title="GitHub Pagesに公開에 대한 직접 링크" translate="no">​</a></h3>
<p>ローカルで作成したDocusaurusのプロジェクトの<code>docusaurus.config.ts</code> の設定を自身のサイトに合わせて修正します。</p>
<p>設定する項目は以下のとおりです。</p>
<ul>
<li class=""><code>url</code>: GitHub PagesのURL。独自ドメインを利用しない場合は <code>https://&lt;GitHubアカウント名&gt;.github.io</code> になります。</li>
<li class=""><code>organizationName</code>: GitHubアカウント名</li>
<li class=""><code>projectName</code>: リポジトリ名</li>
</ul>
<p>こちらは私が修正した例です。<br>
<a href="https://github.com/sawarame/sample-doc/commit/154b4f11af943cdddc76833a047f90898479b407" target="_blank" rel="noopener noreferrer" class="">https://github.com/sawarame/sample-doc/commit/154b4f11af943cdddc76833a047f90898479b407</a></p>
<p><code>sample-doc</code> というリポジトリで作成したので、 <code>baseUrl</code> に <code>/sample-doc/</code> としていますが、 <code>&lt;GitHubアカウント名&gt;.github.io</code> というリポジトリ名で作成した場合は <code>/</code> のままでOKです。</p>
<p>設定が完了したら、以下のコマンドを実行してデプロイします。</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">yarn deploy</span><br></div></code></pre></div></div>
<p>このコマンドを実行すると、Docusaurusがサイトをビルドし、その結果を自動的に <code>gh-pages</code> ブランチにプッシュしてくれます。</p>
<p>デプロイ完了後、GitHubのリポジトリの「Settings」&gt;「Pages」を確認してください。「Build and deployment」の「Branch」が <code>gh-pages</code> に設定されていることを確認します。</p>
<p><img decoding="async" loading="lazy" alt="GitHub Pages設定" src="https://sawara.me/ko/assets/images/docusaurus-github-pages_003-64cfe7bf3f67de1cf22aa1a3ff3eeea7.webp" width="786" height="759" class="img_ev3q"></p>
<p>数分待つと、上部に表示されているURLから公開されたサイトにアクセスできるようになります。</p>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="おわりに">おわりに<a href="https://sawara.me/ko/blog/docusaurus-github-pages#%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB" class="hash-link" aria-label="おわりに에 대한 직접 링크" title="おわりに에 대한 직접 링크" translate="no">​</a></h3>
<p>DocusaurusとGitHub Pagesを組み合わせることで、非常に手軽に、かつ高機能なドキュメントサイトやブログを公開することができます。</p>
<p>Markdownを書くだけでどんどんコンテンツを増やしていけるので、技術的な備忘録やプロジェクトの紹介にぜひ活用してみてください。</p>]]></content:encoded>
            <category>GitHub</category>
            <category>Docusaurus</category>
        </item>
        <item>
            <title><![CDATA[Web快適度測定について]]></title>
            <link>https://sawara.me/ko/blog/benchmark/20260501</link>
            <guid>https://sawara.me/ko/blog/benchmark/20260501</guid>
            <pubDate>Fri, 01 May 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Web快適度測定について]]></description>
            <content:encoded><![CDATA[<p><img decoding="async" loading="lazy" alt="Web快適度測定について" src="https://sawara.me/ko/assets/images/benchmark_result-18617f801d746bbce63682c98802f89d.webp" width="1200" height="628" class="img_ev3q"></p>
<p>今回は、本サイト上でブラウザ上でベンチマークを行うことができる「Web快適度測定」というツールについて、なぜこれを作ったのか、そして中身はどうなっているのか、少しだけ深掘りして紹介してみようと思います。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="開発の経緯対応デバイスを決めるのむずくない">開発の経緯：対応デバイスを決めるの、むずくない？<a href="https://sawara.me/ko/blog/benchmark/20260501#%E9%96%8B%E7%99%BA%E3%81%AE%E7%B5%8C%E7%B7%AF%E5%AF%BE%E5%BF%9C%E3%83%87%E3%83%90%E3%82%A4%E3%82%B9%E3%82%92%E6%B1%BA%E3%82%81%E3%82%8B%E3%81%AE%E3%82%80%E3%81%9A%E3%81%8F%E3%81%AA%E3%81%84" class="hash-link" aria-label="開発の経緯：対応デバイスを決めるの、むずくない？에 대한 직접 링크" title="開発の経緯：対応デバイスを決めるの、むずくない？에 대한 직접 링크" translate="no">​</a></h3>
<p>この機能を作ったきっかけは、現在業務で開発しているサービスの「対応デバイス」を検討していた時のことでした。</p>
<p>「AndroidはOS12以上」「Safari 16以上」「Chrome 110以上」といった基準はよくありますが、実際にはスペックの低いAndroid端末もあれば、OSやブラウザは最新でもパワーが不足しているデバイス、逆に古くてもパワーのある旧ハイエンド端末もあったりします。
開発チームで「どこまでの低スペック端末を切り捨てるか」を議論する際、明確な基準がないことに非常に苦労しました。</p>
<p>そこで、「ブラウザ上で手軽に動かせて、その端末の『Web的な実力』を数値化できるベンチマークがあれば、そのスコアを基準に対応デバイスを定義できるのでは？」と思いついたのが、この機能の始まりです。</p>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="web快適度測��定の基本仕様">Web快適度測定の基本仕様<a href="https://sawara.me/ko/blog/benchmark/20260501#web%E5%BF%AB%E9%81%A9%E5%BA%A6%E6%B8%AC%E5%AE%9A%E3%81%AE%E5%9F%BA%E6%9C%AC%E4%BB%95%E6%A7%98" class="hash-link" aria-label="Web快適度測定の基本仕様에 대한 직접 링크" title="Web快適度測定の基本仕様에 대한 직접 링크" translate="no">​</a></h3>
<p>このツールは、大きく分けて2つの測定を行います。</p>
<ol>
<li class=""><strong>演算性能の測定（スコア化）</strong><br>
<!-- -->端末のCPUパワーを測定し、シングルコア・マルチコアそれぞれのスコアとランク（S〜F）を出します。</li>
<li class=""><strong>ブラウザ機能サポート状況</strong><br>
<!-- -->最新のWeb API（WebGPU, Passkeys, WebP等）がそのブラウザで使えるかをチェックします。</li>
</ol>
<p>スコアとサポート状況は計測後、画面に表示されます。</p>
<p>また、測定して終わりではなく、結果を誰かに伝えたり記録したりしやすいよう、共有機能も追加しています。ブラウザの <strong>Web Share API</strong> を使ってOS標準の共有メニューを直接呼び出せます。HTML5 Canvas を使用し、スコア・ランク・環境情報を表示した結果画像を自動で作成し、そのままX（旧Twitter）やLINE、メッセージアプリへ送信できます。</p>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="ベンチマークの処理の詳細">ベンチマークの処理の詳細<a href="https://sawara.me/ko/blog/benchmark/20260501#%E3%83%99%E3%83%B3%E3%83%81%E3%83%9E%E3%83%BC%E3%82%AF%E3%81%AE%E5%87%A6%E7%90%86%E3%81%AE%E8%A9%B3%E7%B4%B0" class="hash-link" aria-label="ベンチマークの処理の詳細에 대한 직접 링크" title="ベンチマークの処理の詳細에 대한 직접 링크" translate="no">​</a></h3>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-web-workerによる正確な測定">1. Web Workerによる正確な測定<a href="https://sawara.me/ko/blog/benchmark/20260501#1-web-worker%E3%81%AB%E3%82%88%E3%82%8B%E6%AD%A3%E7%A2%BA%E3%81%AA%E6%B8%AC%E5%AE%9A" class="hash-link" aria-label="1. Web Workerによる正確な測定에 대한 직접 링크" title="1. Web Workerによる正確な測定에 대한 �직접 링크" translate="no">​</a></h4>
<p>ベンチマーク中、メインスレッド（UIを動かすスレッド）が固まらないようにするため、演算処理はすべてWeb Workerで実行するようにしています。</p>
<div class="language-javascript codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-javascript codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Web Worker 上で実行される演算ロジックの一部</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> workerScript </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token template-string template-punctuation string" style="color:#e3116c">`</span><span class="token template-string string" style="color:#e3116c"></span><br></div><div class="token-line" style="color:#393A34"><span class="token template-string string" style="color:#e3116c">self.onmessage = function(e) {</span><br></div><div class="token-line" style="color:#393A34"><span class="token template-string string" style="color:#e3116c">  // 1. 浮動小数点演算 (sin, cos, sqrt)</span><br></div><div class="token-line" style="color:#393A34"><span class="token template-string string" style="color:#e3116c">  let floatSum = 0;</span><br></div><div class="token-line" style="color:#393A34"><span class="token template-string string" style="color:#e3116c">  for (let i = 0; i &lt; 10000000; i++) {</span><br></div><div class="token-line" style="color:#393A34"><span class="token template-string string" style="color:#e3116c">    floatSum += Math.sin(i) * Math.cos(i) + Math.sqrt(i);</span><br></div><div class="token-line" style="color:#393A34"><span class="token template-string string" style="color:#e3116c">  }</span><br></div><div class="token-line" style="color:#393A34"><span class="token template-string string" style="display:inline-block;color:#e3116c"></span><br></div><div class="token-line" style="color:#393A34"><span class="token template-string string" style="color:#e3116c">  // 2. 整数・ビット演算</span><br></div><div class="token-line" style="color:#393A34"><span class="token template-string string" style="color:#e3116c">  let intSum = 0;</span><br></div><div class="token-line" style="color:#393A34"><span class="token template-string string" style="color:#e3116c">  for (let i = 0; i &lt; 50000000; i++) {</span><br></div><div class="token-line" style="color:#393A34"><span class="token template-string string" style="color:#e3116c">    intSum += (i * 1337) ^ (i &lt;&lt; 2);</span><br></div><div class="token-line" style="color:#393A34"><span class="token template-string string" style="color:#e3116c">  }</span><br></div><div class="token-line" style="color:#393A34"><span class="token template-string string" style="display:inline-block;color:#e3116c"></span><br></div><div class="token-line" style="color:#393A34"><span class="token template-string string" style="color:#e3116c">  // 3. メモリアクセス</span><br></div><div class="token-line" style="color:#393A34"><span class="token template-string string" style="color:#e3116c">  const size = 5000000;</span><br></div><div class="token-line" style="color:#393A34"><span class="token template-string string" style="color:#e3116c">  const arr = new Int32Array(size);</span><br></div><div class="token-line" style="color:#393A34"><span class="token template-string string" style="color:#e3116c">  // ... 配列へのランダムアクセス処理</span><br></div><div class="token-line" style="color:#393A34"><span class="token template-string string" style="display:inline-block;color:#e3116c"></span><br></div><div class="token-line" style="color:#393A34"><span class="token template-string string" style="color:#e3116c">  // 処理終了をメインスレッドに通知</span><br></div><div class="token-line" style="color:#393A34"><span class="token template-string string" style="color:#e3116c">  self.postMessage({ type: 'done', avgTime: 123 /* 実際は計算値 */ });</span><br></div><div class="token-line" style="color:#393A34"><span class="token template-string string" style="color:#e3116c">};</span><br></div><div class="token-line" style="color:#393A34"><span class="token template-string string" style="color:#e3116c"></span><span class="token template-string template-punctuation string" style="color:#e3116c">`</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Web Workerを生成して実行し、結果をPromiseで返す関数</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">function</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">runWorkerTask</span><span class="token punctuation" style="color:#393A34">(</span><span class="token parameter">passes</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword control-flow" style="color:#00009f">return</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> </span><span class="token class-name">Promise</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">(</span><span class="token parameter">resolve</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token arrow operator" style="color:#393A34">=&gt;</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// 文字列として定義したスクリプトをBlob化してWorkerとして読み込む</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> blob </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> </span><span class="token class-name">Blob</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">workerScript</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> </span><span class="token literal-property property" style="color:#36acaa">type</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"application/javascript"</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> worker </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> </span><span class="token class-name">Worker</span><span class="token punctuation" style="color:#393A34">(</span><span class="token constant" style="color:#36acaa">URL</span><span class="token punctuation" style="color:#393A34">.</span><span class="token method function property-access" style="color:#d73a49">createObjectURL</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">blob</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    worker</span><span class="token punctuation" style="color:#393A34">.</span><span class="token method-variable function-variable method function property-access" style="color:#d73a49">onmessage</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token parameter">e</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token arrow operator" style="color:#393A34">=&gt;</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token keyword control-flow" style="color:#00009f">if</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">e</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">data</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">type</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">===</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"done"</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        worker</span><span class="token punctuation" style="color:#393A34">.</span><span class="token method function property-access" style="color:#d73a49">terminate</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// 終わったらWorkerを破棄</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token function" style="color:#d73a49">resolve</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">e</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">data</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">avgTime</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// Workerに実行命令（パス回数など）を送信</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    worker</span><span class="token punctuation" style="color:#393A34">.</span><span class="token method function property-access" style="color:#d73a49">postMessage</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> passes </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></div></code></pre></div></div>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-マルチコア測定の実装">2. マルチコア測定の実装<a href="https://sawara.me/ko/blog/benchmark/20260501#2-%E3%83%9E%E3%83%AB%E3%83%81%E3%82%B3%E3%82%A2%E6%B8%AC%E5%AE%9A%E3%81%AE%E5%AE%9F%E8%A3%85" class="hash-link" aria-label="2. マルチコア測定の実装에 대한 직접 링크" title="2. マルチコア測定の実装에 대한 직접 링크" translate="no">​</a></h4>
<p>デバイスの論理コア数（<code>navigator.hardwareConcurrency</code>）を取得し、その数だけ同時に Worker を立ち上げて並列処理を行わせます。<code>Promise.all</code> を活用して全ての Worker の完了を待機し、総合的なスループットからスコアを算出するようにしました。これにより、最近の多コアスマホの実力をしっかり引き出せるようにしています。</p>
<div class="language-javascript codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-javascript codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">async</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">function</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">runMultiCoreBenchmark</span><span class="token punctuation" style="color:#393A34">(</span><span class="token parameter">cores</span><span class="token parameter punctuation" style="color:#393A34">,</span><span class="token parameter"> passes</span><span class="token parameter punctuation" style="color:#393A34">,</span><span class="token parameter"> onProgress</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> workers </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> startAll </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token dom variable" style="color:#36acaa">performance</span><span class="token punctuation" style="color:#393A34">.</span><span class="token method function property-access" style="color:#d73a49">now</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">let</span><span class="token plain"> completedPasses </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> totalPasses </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> passes </span><span class="token operator" style="color:#393A34">*</span><span class="token plain"> cores</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// デバイスの論理コア数分だけ Worker を作成して実行</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword control-flow" style="color:#00009f">for</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">let</span><span class="token plain"> i </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"> i </span><span class="token operator" style="color:#393A34">&lt;</span><span class="token plain"> cores</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"> i</span><span class="token operator" style="color:#393A34">++</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    workers</span><span class="token punctuation" style="color:#393A34">.</span><span class="token method function property-access" style="color:#d73a49">push</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token function" style="color:#d73a49">runWorkerTask</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">passes</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token arrow operator" style="color:#393A34">=&gt;</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        completedPasses</span><span class="token operator" style="color:#393A34">++</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token comment" style="color:#999988;font-style:italic">// 全体の進捗率を計算してUIに通知</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token keyword control-flow" style="color:#00009f">if</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">onProgress</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> percent </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token known-class-name class-name">Math</span><span class="token punctuation" style="color:#393A34">.</span><span class="token method function property-access" style="color:#d73a49">floor</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">completedPasses </span><span class="token operator" style="color:#393A34">/</span><span class="token plain"> totalPasses</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">*</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">100</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token function" style="color:#d73a49">onProgress</span><span class="token punctuation" style="color:#393A34">(</span><span class="token template-string template-punctuation string" style="color:#e3116c">`</span><span class="token template-string string" style="color:#e3116c">マルチコア測定中... (</span><span class="token template-string interpolation interpolation-punctuation punctuation" style="color:#393A34">${</span><span class="token template-string interpolation">percent</span><span class="token template-string interpolation interpolation-punctuation punctuation" style="color:#393A34">}</span><span class="token template-string string" style="color:#e3116c">%)</span><span class="token template-string template-punctuation string" style="color:#e3116c">`</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// すべての並列処理が終わるまで待機</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword control-flow" style="color:#00009f">await</span><span class="token plain"> </span><span class="token known-class-name class-name">Promise</span><span class="token punctuation" style="color:#393A34">.</span><span class="token method function property-access" style="color:#d73a49">all</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">workers</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> endAll </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token dom variable" style="color:#36acaa">performance</span><span class="token punctuation" style="color:#393A34">.</span><span class="token method function property-access" style="color:#d73a49">now</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// 実行時間から最終的なマルチコアスコアを計算</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> totalTime </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> endAll </span><span class="token operator" style="color:#393A34">-</span><span class="token plain"> startAll</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword control-flow" style="color:#00009f">return</span><span class="token plain"> </span><span class="token known-class-name class-name">Math</span><span class="token punctuation" style="color:#393A34">.</span><span class="token method function property-access" style="color:#d73a49">floor</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">500_000</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">*</span><span class="token plain"> cores </span><span class="token operator" style="color:#393A34">*</span><span class="token plain"> passes</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">/</span><span class="token plain"> totalTime</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></div></code></pre></div></div>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="3-ブラウザ機能のサポートチェック">3. ブラウザ機能のサポートチェック<a href="https://sawara.me/ko/blog/benchmark/20260501#3-%E3%83%96%E3%83%A9%E3%82%A6%E3%82%B6%E6%A9%9F%E8%83%BD%E3%81%AE%E3%82%B5%E3%83%9D%E3%83%BC%E3%83%88%E3%83%81%E3%82%A7%E3%83%83%E3%82%AF" class="hash-link" aria-label="3. ブラウザ機能のサポートチェック에 대한 직접 링크" title="3. ブラウザ機能のサポートチェック에 대한 직접 링크" translate="no">​</a></h4>
<p>単に計算が速いだけでなく、現代のWebサービスを支える最新のAPIに対応しているかどうかも、体験の質に大きく関わります。以下の4つのカテゴリで診断を行っています。</p>
<ul>
<li class=""><strong>SNS・メディア閲覧</strong><br>
<!-- -->「SNSや動画サイト等が快適に動作するか」を判定します。次世代画像の <strong>AVIF/WebP</strong> や、高効率ビデオコーデックの <strong>AV1</strong>、優先読み込みを行う <strong>fetchpriority</strong> などをチェック。これらに対応していると、表示速度が劇的に向上し、通信量も抑えられます。</li>
<li class=""><strong>ビジネス・ツール</strong><br>
<!-- -->「NotionやFigma等のアプリ級サイトが快適に動くか」を判定します。ポップアップを制御する <strong>Popover API</strong> や、ブラウザ上でのZIP圧縮を可能にする <strong>Compression Streams</strong>、オフライン対応の <strong>IndexedDB v3</strong> などをチェック。これらは高機能なWebツールの安定性に直結します。</li>
<li class=""><strong>エンタメ・クリエイティブ</strong><br>
<!-- -->「3D、アニメーション、ゲームが快適に動作するか」を判定します。次世代3Dグラフィックスの <strong>WebGPU</strong> や、滑らかな画面遷移を実現する <strong>View Transitions API</strong>、スクロール連動演出の <strong>Scroll-driven Animations</strong> などをチェック。リッチな視覚表現が可能になります。</li>
<li class=""><strong>システム・その他</strong>:<br>
<!-- -->「アプリ化、通知、ログインの快適さ」を判定します。指紋・顔認証でのログインを可能にする <strong>Passkeys (WebAuthn)</strong> や、画面をスリープさせない <strong>Screen Wake Lock API</strong>、ローカルファイルを直接編集できる <strong>File System Access API</strong> などをチェックしています。</li>
</ul>
<p>これらの判定結果を表示し、アコーディオン形式でそれぞれどの機能に現在使用しているブラウザが対応しているか、確認できるようになっています。</p>
<p><img decoding="async" loading="lazy" alt="Web快適度測定:ブラウザ機能サポート状況" src="https://sawara.me/ko/assets/images/browser_support-974e3e7c5d95620c1c655091db3e98f9.webp" width="862" height="702" class="img_ev3q"></p>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="便利な使い方活用シーン">便利な使い方・活用シーン<a href="https://sawara.me/ko/blog/benchmark/20260501#%E4%BE%BF%E5%88%A9%E3%81%AA%E4%BD%BF%E3%81%84%E6%96%B9%E6%B4%BB%E7%94%A8%E3%82%B7%E3%83%BC%E3%83%B3" class="hash-link" aria-label="便利な使い方・活用シーン에 대한 직접 링크" title="便利な使い方・活用シーン에 대한 직접 링크" translate="no">​</a></h3>
<p>単なる「性能測定」以上に、以下のような具体的なシーンで活用してもらえると嬉しいです！</p>
<ul>
<li class=""><strong>手元のデバイスのWeb性能のベンチマーク</strong><br>
<!-- -->手元にあるスマートフォンやタブレット、PCがどれくらいのWeb処理能力があるのか確認することができます。特にミドルレンジ以下の端末では、最新機能のサポート状況を知る良い指標になります。</li>
<li class=""><strong>ブラウザによる性能特性の比較</strong><br>
<!-- -->同じデバイスでも、Safari（WebKit）とChrome（Blink）ではJSエンジンの実装が異なります。どちらが演算に強く、最新機能に対応しているかを比べてみて、自分のデバイスにあったブラウザを見つけてみてください。</li>
<li class=""><strong>プロジェクトのターゲットデバイス選定</strong>:<br>
<!-- -->開発プロジェクトで「今回はDランク以上の端末を推奨環境とする」といった具体的な数値を定義するために。OSバージョンや発売日といった曖昧な指標ではなく、現在のWebブラウザにおける「実力値」をベースにした議論が可能になります。</li>
</ul>
<p>ぜひ、皆さんの手元のデバイスでも <a class="" href="https://sawara.me/ko/benchmark">Web快適度測定</a> を試してみてください！</p>]]></content:encoded>
            <category>Web快適度測定</category>
        </item>
        <item>
            <title><![CDATA[このサイトについて]]></title>
            <link>https://sawara.me/ko/blog/introducing-sawarame</link>
            <guid>https://sawara.me/ko/blog/introducing-sawarame</guid>
            <pubDate>Wed, 29 Apr 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Web快適度測定について]]></description>
            <content:encoded><![CDATA[<p><img decoding="async" loading="lazy" alt="Web快適度測定について" src="data:image/webp;base64,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" width="600" height="315" class="img_ev3q"></p>
<p>こんにちは。管理人の sawarame です。</p>
<p>このサイトは、個人的に日々の生活や仕事の中で「ちょっとこういうツールが欲しいな」と思ったものを形にして集めた、ツール集です。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="なぜ作ったのか">なぜ作ったのか？<a href="https://sawara.me/ko/blog/introducing-sawarame#%E3%81%AA%E3%81%9C%E4%BD%9C%E3%81%A3%E3%81%9F%E3%81%AE%E3%81%8B" class="hash-link" aria-label="なぜ作ったのか？에 대한 직접 링크" title="なぜ作ったのか？에 대한 직접 링크" translate="no">​</a></h3>
<p>世の中には便利なツールが溢れていますが、意外と「痒いところに手が届かない」ことや、「自分のデータをサーバーに送りたくない」という不安を感じることがありました。</p>
<p>そのため、このサイトのすべてのツールは <strong>ブラウザ上で完結（クライアントサイド処理）</strong> するように作られています。画像やPDF、パスワードの生成などは、サーバーに送られたりデバイスの外にデータが出ることはありませんので、安心して使うことができます。</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="公開しているツールについて">公開しているツールについて<a href="https://sawara.me/ko/blog/introducing-sawarame#%E5%85%AC%E9%96%8B%E3%81%97%E3%81%A6%E3%81%84%E3%82%8B%E3%83%84%E3%83%BC%E3%83%AB%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6" class="hash-link" aria-label="公開しているツールについて에 대한 직접 링크" title="公開しているツールについて에 대한 직접 링크" translate="no">​</a></h3>
<p>現在公開しているツールには、それぞれ地味ながらこだわったポイントがあります。似たようなツールは他にもありますが、自分なりに使いやすい機能に仕上げています。</p>
<ol>
<li class=""><strong>パスワードジェネレーター</strong><br>
<!-- -->単にパスワードを自動生成するだけでなく、<strong>URLパラメータとの同期</strong>にこだわりました。長さや使用文字の設定がすべてURLに反映されるので、お気に入りの設定をブックマークしたり、チームで「この設定でパスワード作って」と共有したりできます。</li>
<li class=""><strong>テキスト保存場所</strong><br>
<!-- -->ブラウザのローカルストレージを利用した、テキストデータを保存できる場所です。ブラウザを閉じてもデータが消えず、何かふと思ったことメモしておける機能として開発しました。よくコピペするワードとかを置いておけるスニペットとして使うこともできます。　<strong>ピン留め機能</strong> を実装したので、作業中に何度も使うテンプレを常に最上部に置いておけます。</li>
<li class=""><strong>デバイス情報チェッカー</strong><br>
<!-- -->デバイスの画面サイズやユーザーエージェントを確認できます。意外とスマホやタブレットのサイズってよくわからないことがあるので、実機でアクセスすることで実際の画面サイズを確認することができます。レスポンシブサイトとかを開発する際に役に立ちます。</li>
<li class=""><strong>QRコード作成</strong><br>
<!-- -->Wi-Fi、連絡先、カレンダー登録など、多彩なフォーマットに対応しています。ロゴ埋め込みもできるので、販促チラシを作成する際にオリジナリティのあるQRコードが作成できます。。</li>
<li class=""><strong>日付比較ツール</strong><br>
<!-- -->「2026年4月30日」といった日本語形式やUNIX TIMESTAMPなど、<strong>入力フォーマットの寛容さ</strong>にこだわりました。どんな形式でコピーしてきても、いい感じにパースして差分を出してくれます。常に現在時刻との比較を出すこともできますので、Xデーまでのカウントダウンや、過去の日付からどらくらいの時間が経過したか出力しておくこともできます。</li>
<li class=""><strong>写真Exif情報チェッカー</strong><br>
<!-- -->写真データからExifデータを取得し表示します。撮影条件だけでなく、GPS情報があれば緯度経度を表示し、<strong>Googleマップへのリンク</strong>を即座に生成します。</li>
<li class=""><strong>画像軽量化・クロップツール</strong><br>
<strong>WebPへの変換</strong>はもちろん、スライダーによる<strong>Before/Afterの比較プレビュー</strong>、主要なSNS（OGPやX）に合わせたアスペクト比プリセットなど、サイト・ブログ・SNS運営に便利な機能となるように開発しました。</li>
<li class=""><strong>PDF画像変換</strong><br>
<!-- -->ブラウザ内でPDFをレンダリングし、画像データに変換します。<strong>必要なページだけを選んでZIPで固める</strong> という、シンプルな機能でスムーズに使用できるようになっています。</li>
<li class=""><strong>Web快適度測定（ベンチマーク）</strong><br>
<!-- -->ただのスコア測定ではなく、<strong>Web Workerを用いたマルチスレッド演算</strong> によるマルチコアのベンチマークができます。また、最新のWeb技術（WebGPUやPasskeys等）への対応状況をカテゴリ別に診断する機能もあり、自分の環境の「モダンさ」を可視化できるようにしています。</li>
</ol>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="ブラウザ拡張機能も公開中">ブラウザ拡張機能も公開中<a href="https://sawara.me/ko/blog/introducing-sawarame#%E3%83%96%E3%83%A9%E3%82%A6%E3%82%B6%E6%8B%A1%E5%BC%B5%E6%A9%9F%E8%83%BD%E3%82%82%E5%85%AC%E9%96%8B%E4%B8%AD" class="hash-link" aria-label="ブラウザ拡張機能も公開中에 대한 직접 링크" title="ブラウザ拡張機能も公開中에 대한 직접 링크" translate="no">​</a></h3>
<p>日々のブラウジングを少し便利にする拡張機能も、Chrome Web Store で公開しています。</p>
<ul>
<li class=""><strong>EnvIcon</strong>:<br>
<!-- -->本番・検証・開発環境でfaviconを動的に書き換えます。「検証環境のつもりで本番を触っていた」という、<strong>エンジニアなら一度はやるヒヤリハット</strong> を防ぎたくて作りました。faviconの書き換えだけではなく、ページ内でのバッジ表示や、デベロッパーツールのコンソールの環境表示に対応しています。</li>
<li class=""><strong>Shiftless Enter for Gemini</strong>:<br>
<!-- -->Google Gemini のWEB UIのプロンプト入力を「Enterで改行、Cmd+Enterで送信」という挙動に変更します。改行しようと思っただけなのに、何度も送信してしまうことがあったので作ってみました。今後GeminiのWEB UIをアップグレードする機能を追加しようと思っているのですが、今のところ何も思いついていません、、、</li>
<li class=""><strong>MdPicker</strong>:<br>
<!-- -->閲覧中のページタイトルとURLを、ワンクリックでMarkdown形式のリンクにしてコピーします。ブログ執筆やドキュメント作成のスピードを上げるための必須ツールです。</li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="これから">これから<a href="https://sawara.me/ko/blog/introducing-sawarame#%E3%81%93%E3%82%8C%E3%81%8B%E3%82%89" class="hash-link" aria-label="これから에 대한 직접 링크" title="これから에 대한 직접 링크" translate="no">​</a></h3>
<p>自分自身が使いやすいと思うものを、これからも少しずつ増やしていく予定です。
「痒いところに手が届く」そんな場所を目指しています。</p>]]></content:encoded>
            <category>sawara.me</category>
        </item>
    </channel>
</rss>