Skip to content

補足情報の詳細テキストを掲載 #15

@laiso

Description

@laiso

docs/index.html の補足情報セクションを更新してください。以下の3つの補足情報を、問題・症状・対処法の形式で詳細に記載してください。既存の補足情報の見出しだけの状態を、具体的な説明文に置き換えてください。

補足1: GitHub ActionsからのPR作成にはリポジトリ設定が必要(7.4節関連)

本書の記載:
本書7.4節に「プルリクエストの作成には、7.2節で設定したワークフロー権限(pull-requests: write)とリポジトリ設定(プルリクエスト作成の許可)の両方が必要です。」と記載されています。

問題:
このリポジトリ設定の具体的な手順が本書には記載されていません。

症状:
ワークフローを実行すると以下のエラーが発生します:
GitHub Actions is not permitted to create or approve pull requests

対処法:
リポジトリの Settings → Actions → General → Workflow permissions で「Allow GitHub Actions to create and approve pull requests」にチェックを入れてSaveしてください。

補足2: ISSUE_TEXTをCI向けプロンプトに埋め込む実装が必要(7.7節関連)

本書の記載:
本書7.7節では、ワークフローのYAMLで ISSUE_TEXT 環境変数に Issue 本文を設定しています。また「ISSUE_BODYには手動入力(inputs.task)のみを渡し、Issue本文はISSUE_TEXTとして参照専用に分離します」と説明しています。

問題:
しかし、bin/cli.ts の CI 向けプロンプト(issueDrivenInstructions)で ISSUE_TEXT の内容を参照する実装が、本書のコード例に含まれていません。環境変数として渡しているのに、プロンプトに埋め込むコードがないため、エージェントが Issue 本文を読めません。

症状:
Issue トリガーでワークフローが実行されても、エージェントは Issue のタイトルしか認識できず、本文に書かれた詳細な指示に従えません。

対処法:
bin/cli.ts の issueDrivenInstructions テンプレートリテラル内に、以下のように process.env.ISSUE_TEXT の内容を埋め込むコードを追加してください:

const issueText = process.env.ISSUE_TEXT || "";
// issueDrivenInstructions 内に以下を追加:
// ## Issue本文(参照用)
// ${issueText}

補足3: GitHub ActionsのVariables設定漏れに注意(7.2節関連)

本書の記載:
本書7.2節で gh variable set コマンドによる Variables の登録手順が記載されています。

問題:
Variables(LLM_PROVIDER, LLM_MODEL)を設定し忘れた場合のエラーについて説明がありません。Secrets(LLM_API_KEY)とは別に登録が必要ですが、両方とも「環境変数」として扱われるため混同しやすくなっています。

症状:
LLM_PROVIDER と LLM_MODEL が Variables に未登録の場合、ワークフローのログでこれらの値が空になり、bin/cli.ts の起動時に「LLM設定が不足しています」というエラーで終了します。

対処法:
以下のコマンドで Variables を登録してください:
gh variable set LLM_PROVIDER --body "openai"
gh variable set LLM_MODEL --body "gpt-4o-mini"
登録状況は gh variable list で確認できます。

作成後、createBranch でブランチを作り、commitChanges でコミットし、pushBranch でプッシュし、createPullRequest でPRを作成してください。

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions