Goose の「plan.md」を使用してカスタム プランを作成する方法

グースとは何ですか?
Goose は、端末または IDE 内のコーディング タスクを自動化することでソフトウェア開発を強化する開発者エージェントです。入力に基づいて、プロジェクトのニーズをインテリジェントに分析し、必要なコードを生成し、変更を自律的に実装します。 Goose を使用する場合、特定の目標に向かってその実行をガイドするための構造化された方法が不可欠です。ここで plan.md ファイルが登場します。 plan.md ファイルを使用すると、柔軟なテキスト形式と Jinja テンプレートの機能を使用して、動的で再利用可能な目標指向の計画を作成し、Goose 用にカスタマイズされた計画を定義できます。

Goose のセットアップ方法
カスタム plan.md ファイルを作成する前に、Goose をセットアップする必要があります。

ステップ 1: GitHub 上で Goose および Goose Plugin リポジトリをフォークし、クローンを作成します。

ステップ 2: Homebrew をインストールする — brew.sh にアクセスしてインストール手順に従うか、次のコマンドを実行します:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

ステップ 3: Goose をインストールするには、pipx を使用します。まず、pipx がインストールされていることを確認します:

brew install pipx
pipx ensurepath

ステップ 4: 次に Goose をインストールします:

pipx install goose-ai

ステップ 5: セッションを開始します — ターミナルから、開始したいディレクトリに移動して次を実行します:

goose session start

Goose は好みの LLM で動作します。デフォルトでは、openai を LLM プロバイダーとして使用します。 API キーを設定するように求められます。

「plan.md」ファイルとは何ですか?

plan.md ファイルは、Goose が従うべき青写真として機能するテキスト ファイルです。これは 2 つの重要なコンポーネントで構成されています:

A kickoff message that sets the context and overall goal
A structured list of tasks for Goose to execute.

plan.md ファイルを使用する理由

• カスタマイズ:
  Goose のアクションを特定のタスクやプロジェクトに合わせて調整できます。

• 再利用性:
  テンプレートを使用すると、同様の目標に向けて計画を簡単に再利用したり変更したりできます。

• 明瞭度:
  目標と手順の概要を示すことで、より適切な管理と予測可能性が確保されます。

最初の plan.md ファイルの作成

Goose に新しいデザイン システムのセットアップを手伝ってもらいたいとします。 plan.md の例を次に示します。

Your goal is to set up a fresh design system for our app's redesign.

- Create folders for design components (buttons, forms, colors)
- Set up color palette based on brand guidelines
- Create typography styles for headings and body text
- Design basic button components with all states
- Create form elements (inputs, dropdowns)

タスクの各行の先頭にあるダッシュ (-) が見えますか?超重要！ Goose はこれらを検索して、どのような手順を実行する必要があるかを理解します。このプランで Goose を実行するには:

goose session start --plan plan.md

プランでの Jinja テンプレートの使用
Jinja は、変数、ループ、条件文をテキスト ファイルに直接埋め込むことができるテンプレート エンジンです。 Jinja を使用すると、plan.md ファイルを動的で適応性のあるものにすることができます。

主要な Jinja 構文

• 変数: {{ 変数 }}

• ループ: {% for item in list %}...{% endfor %}

• 条件: {% if 条件 %}...{% endif %}

plan.md ファイルを思い出してください。jinja テンプレートを使用した拡張バージョンは次のようになります。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

プランに引数を渡す
実行中に引数を plan.md ファイルに渡すことができます。たとえば、デザイン システムのセットアップ プランを動的で再利用可能にするために、Jinja テンプレートを使用します。これにより、特定のプロジェクト、ブランド、またはデザイン要件に基づいてコンテンツをカスタマイズする引数を渡すことができます。さまざまな引数のセットを渡すことで、再設計や製品のパーソナライズされた計画を簡単に生成できます。

例: Jinja で引数を渡す

データの定義: 最初のステップは、テンプレートに渡すデータを準備することです。これには、ブランド名、色、タイポグラフィースタイル、その他のデザイン固有の詳細などの値が含まれます。

brew install pipx
pipx ensurepath

このプランと引数を指定して Goose を実行するには、次のコマンドを実行します。

pipx install goose-ai

Goose は、plan.md 内のプレースホルダーにこれらの値を設定します。

goose session start

ベスト プラクティスとヒント

• 明確な目標を定義する: 各計画が明確な目標から始まるようにします。
• 再利用可能なテンプレートを使用する: さまざまなプロジェクトに合わせてカスタマイズできる一般的なテンプレートを作成します。
• ドキュメントの前提条件: プレースホルダーと構造を説明するコメントまたはメモを追加します。
• 小さな変更をテストする: plan.md ファイル内の各変更を検証して、正しくレンダリングされることを確認します。

結論
plan.md ファイルは、Goose の実行をガイドして目標を達成するための多用途ツールです。明確な目標、構造化された手順、動的な Jinja テンプレートを組み合わせることで、再利用可能で高度にカスタマイズ可能な計画を作成できます。モバイル アプリの UX を改善する場合でも、複雑なプロジェクトに取り組む場合でも、plan.md を使用すると、Goose に明確さ、適応性、正確性を提供できます。

以上がGoose の「plan.md」を使用してカスタム プランを作成する方法の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。