Skip to content

Commit 5290e4c

Browse files
laisoclaude
andcommitted
docs: 補足情報の誤りを訂正 (ch02/ch08 削除、ch07.4 文言修正)
実際に動作確認した結果、以下の補足情報に問題が見つかったため訂正する。 - ch02-env-gemini: 削除 @google/genai SDK は GOOGLE_API_KEY と GEMINI_API_KEY の両方を読み、 両方設定時は GOOGLE_API_KEY を優先する (index.mjs:19568-19575)。 README.md:121 も GOOGLE_API_KEY を正式な環境変数として案内しており、 本書の .env 例は SDK の動作と一致している。errata ではないため削除。 - ch08-3-bubblewrap-sys-admin: 削除 本書の --cap-add=SYS_ADMIN の指示は Docker コンテナ内で bubblewrap を 動作させるための安全なデフォルトであり、本文の記述は正しい。 errata ではないため削除。 - ch07-4-pr-permission: 本書の記載欄を修正 ワークフロー権限の設定手順は 7.2 節にあり、7.4 節では参照されているのみ。 「7.4 節で設定手順が記載」という記述を「7.4 節で言及されるリポジトリ設定 の具体的手順は本文に含まれていない」と訂正。 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 9dc37b2 commit 5290e4c

1 file changed

Lines changed: 5 additions & 65 deletions

File tree

workspace/docs/index.html

Lines changed: 5 additions & 65 deletions
Original file line numberDiff line numberDiff line change
@@ -251,10 +251,6 @@ <h1>作って学ぶ AIエージェント サポートサイト</h1>
251251
<aside class="toc">
252252
<h2>補足情報</h2>
253253
<nav>
254-
<h3>第 2 章</h3>
255-
<ul>
256-
<li><a href="#ch02-env-gemini">環境変数 GEMINI_API_KEY</a></li>
257-
</ul>
258254
<h3>第 3 章</h3>
259255
<ul>
260256
<li><a href="#ch03-3-llm-api-error">3.3 節 LLMApiError のコンストラクタ引数</a></li>
@@ -266,44 +262,13 @@ <h3>第 4 章</h3>
266262
<h3>第 7 章</h3>
267263
<ul>
268264
<li><a href="#ch07-2-variables">7.2 節 Variables の設定</a></li>
269-
<li><a href="#ch07-4-pr-permission">7.4 節 PR 作成の権限設定</a></li>
265+
<li><a href="#ch07-4-pr-permission">7.4 節 PR 作成に必要なリポジトリ設定</a></li>
270266
<li><a href="#ch07-7-issue-text">7.7 節 ISSUE_TEXT の埋め込み</a></li>
271267
</ul>
272-
<h3>第 8 章</h3>
273-
<ul>
274-
<li><a href="#ch08-3-bubblewrap-sys-admin">8.3 節 bubblewrap と SYS_ADMIN 権限</a></li>
275-
</ul>
276268
</nav>
277269
</aside>
278270

279271
<div>
280-
<section class="chapter-group">
281-
<h2>第 2 章</h2>
282-
283-
<article id="ch02-env-gemini">
284-
<header>
285-
<span class="chapter-label">第 2 章</span>
286-
<h3>環境変数 GEMINI_API_KEY</h3>
287-
<a class="anchor" href="#ch02-env-gemini">#</a>
288-
</header>
289-
<dl>
290-
<dt>本書の記載</dt>
291-
<dd>
292-
<p>第 2 章の <code>.env</code> 例に <code>GOOGLE_API_KEY=AI...</code> が記載されています。第 6 章の <code>createModelFromEnv</code> の実装でも <code>process.env.GOOGLE_API_KEY</code> を参照する形で説明されています。</p>
293-
</dd>
294-
<dt>症状</dt>
295-
<dd>
296-
<p><code>@google/genai</code> SDK が参照する標準の環境変数名は <code>GEMINI_API_KEY</code> です。<code>GOOGLE_API_KEY</code> だけを設定した場合、SDK からは空と判定されます。</p>
297-
</dd>
298-
<dt>対処</dt>
299-
<dd>
300-
<p><code>.env</code> には <code>GEMINI_API_KEY</code> を設定します。本リポジトリの <code>src/providers/google.ts</code><code>GEMINI_API_KEY ?? GOOGLE_API_KEY</code> のフォールバックを備えているため両方の環境変数名を受け付けますが、新規設定では <code>GEMINI_API_KEY</code> を使用してください。</p>
301-
<pre><code>GEMINI_API_KEY=AI...</code></pre>
302-
</dd>
303-
</dl>
304-
</article>
305-
</section>
306-
307272
<section class="chapter-group">
308273
<h2>第 3 章</h2>
309274

@@ -389,22 +354,22 @@ <h3>Variables の設定</h3>
389354
<article id="ch07-4-pr-permission">
390355
<header>
391356
<span class="chapter-label">7.4 節</span>
392-
<h3>PR 作成の権限設定</h3>
357+
<h3>PR 作成に必要なリポジトリ設定</h3>
393358
<a class="anchor" href="#ch07-4-pr-permission">#</a>
394359
</header>
395360
<dl>
396361
<dt>本書の記載</dt>
397362
<dd>
398-
<p>7.4 節でワークフロー権限 <code>pull-requests: write</code> の設定手順が記載されています</p>
363+
<p>第 7 章 7.4 節に「プルリクエストの作成には、7.2 節で設定したワークフロー権限(<code>pull-requests: write</code>)とリポジトリ設定(プルリクエスト作成の許可)の両方が必要です」と記載されています。具体的なリポジトリ設定の手順は本文に含まれていません</p>
399364
</dd>
400365
<dt>症状</dt>
401366
<dd>
402-
<p>ワークフロー権限だけではプルリクエストを作成できず、実行時に次のエラーで失敗します。</p>
367+
<p>ワークフロー権限のみを設定した状態では、プルリクエストを作成できず、実行時に次のエラーで失敗します。</p>
403368
<pre><code>GitHub Actions is not permitted to create or approve pull requests</code></pre>
404369
</dd>
405370
<dt>対処</dt>
406371
<dd>
407-
<p>リポジトリの Settings → Actions → General → Workflow permissions を開き、「Allow GitHub Actions to create and approve pull requests」にチェックを入れて Save してください。ワークフロー権限の設定と併用することで、プルリクエストの作成が許可されます。</p>
372+
<p>リポジトリの Settings → Actions → General → Workflow permissions を開き、「Allow GitHub Actions to create and approve pull requests」にチェックを入れて Save してください。7.2 節で設定したワークフロー権限と併用することで、プルリクエストの作成が許可されます。</p>
408373
</dd>
409374
</dl>
410375
</article>
@@ -438,31 +403,6 @@ <h3>ISSUE_TEXT の埋め込み</h3>
438403
</article>
439404
</section>
440405

441-
<section class="chapter-group">
442-
<h2>第 8 章</h2>
443-
444-
<article id="ch08-3-bubblewrap-sys-admin">
445-
<header>
446-
<span class="chapter-label">8.3 節</span>
447-
<h3>bubblewrap と SYS_ADMIN 権限</h3>
448-
<a class="anchor" href="#ch08-3-bubblewrap-sys-admin">#</a>
449-
</header>
450-
<dl>
451-
<dt>本書の記載</dt>
452-
<dd>
453-
<p>bubblewrap の実行に <code>--cap-add=SYS_ADMIN</code> が必要と記載されています。</p>
454-
</dd>
455-
<dt>症状</dt>
456-
<dd>
457-
<p>全ての環境でこのオプションが必須とは限りません。</p>
458-
</dd>
459-
<dt>対処</dt>
460-
<dd>
461-
<p>ホストのカーネル設定 <code>kernel.unprivileged_userns_clone=1</code> が有効な環境では、<code>--cap-add=SYS_ADMIN</code> なしで bubblewrap を起動できる場合があります。実行環境のカーネル設定を確認のうえ、必要に応じてオプションを付与してください。</p>
462-
</dd>
463-
</dl>
464-
</article>
465-
</section>
466406
</div>
467407
</div>
468408

0 commit comments

Comments
 (0)