> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 良いタスクの書き方

> エージェントにタスクを任せるための実践的なヒントです。目標と完了の条件を示す、コンテキストを提供する、大きなタスクを分割する、適切な権限を選ぶ、繰り返しの作業を自動化する、エージェントに PR を作成させる方法を説明します。

タスクが明確であれば、エージェントの回り道が減り、作業を止めてあなたに確認する回数も少なくなります。以下のヒントは、ほとんどのセッションに当てはまります。

## 目標、範囲、完了の条件を示す

何を達成するか、どこを変更するか、何をもって完了とするかをエージェントに伝えます。次の 2 つを比べてみてください。

* 「ログインページを直してください。」
* 「Safari でログインページの入力欄がずれている問題を修正してください。変更はログインページのスタイルだけにして、他のページには手を加えないでください。完了したら既存のテストを実行し、Safari を対象とするテストを追加してください。」

2 つ目は、目標、範囲、結果の検証方法を示しています。エージェントは推測する必要がなく、どの時点で作業を止めてあなたに戻せばよいかがわかります。

## 関連するファイルとリンクを提供する

* **最初に適切なプロジェクトを選択** して、エージェントが正しいコードと環境で作業できるようにします。
* 関連するファイル、フォルダー、エラーメッセージ、ドキュメントのリンクをタスクに明記します。
* UI の問題では、スクリーンショットを添付するか、入力欄の **Take a screenshot** を使います。ログやデザインファイルなどは添付ファイルとして送信します。[セッションを開始する](https://docs.aihubmix.com/jp/cloud/sessions/start-a-session.md) を参照してください。
* エージェントが必要とするシークレットは、あらかじめプロジェクトのシークレットと環境変数に保存しておくと、エージェントが作業を止めて確認する必要がなくなります。[プロジェクトと環境構築](https://docs.aihubmix.com/jp/cloud/environments/projects.md) を参照してください。

## 大きなタスクを分割する

1 つのセッションは、通常 1 つのことに集中させると最も効果的です。大きな依頼は複数のセッションに分けます。たとえば、まずエージェントに選択肢を調査させ、その結果をもとに実装を始めます。

* タスクの各部分が独立している場合は、どの部分を並行して進められるかを伝えます。複雑なタスクでは、エージェントが [サブエージェント](https://docs.aihubmix.com/jp/cloud/sessions/subagents.md) を起動して同時に作業させ、すべて完了した後に結果を自動的にまとめます。
* 別のアプローチを試すには、返信から新しいセッションを **Fork** します。元のセッションには影響しません。
* エージェントの方向がずれた場合は、完了を待つ必要はありません。**Steer** を使ってすぐに修正するか、以前のメッセージを編集して再実行します。[エージェントとの共同作業](https://docs.aihubmix.com/jp/cloud/sessions/work-with-agent.md) を参照してください。

## 適切な権限を選ぶ

新しいセッションのデフォルトは **Full access** で、エージェントは手順ごとにあなたに確認しません。クラウドサーバー上でエージェントに自力で完了してほしいタスクに適しています。クラウドサーバー上のセッションが、あなたのコンピューターに触れることはありません。

次の場合は、**Ask for approval** または **Approve for me** に切り替えてください。

* セッションが自分のコンピューター上で実行され、重要なファイルやシステム設定に関わる場合。
* エージェントに自由に使わせたくないシークレットがプロジェクトにある場合。Full access では、エージェントはプロジェクト内のすべてのシークレットを読み取れます。
* タスクが外部のサービスや Web サイトに接続し、エージェントが操作する前に確認したい場合。

## 繰り返しの作業にはスケジュールタスクを使う

「平日の毎朝 9 時に依存関係の更新を確認する」のように定期的に行う必要がある作業は、セッションでエージェントに普段の言葉で伝えます。エージェントがスケジュールタスクの下書きを作成し、**Create** をクリックした後にのみ有効になります。「30 分後にもう一度デプロイを確認する」のように現在のセッションに関連するフォローアップは、エージェントにセッションタイマーの設定を依頼します。スケジュールタスクはクラウドサーバー上で実行され、コンピューターの電源が切れていても実行され続けます。[スケジュールタスク](https://docs.aihubmix.com/jp/cloud/automation/scheduled-tasks.md) を参照してください。

## エージェントに PR を作成させる

変更が完了したら、セッションでエージェントにコミット、プッシュ、または PR の作成を依頼します。例：「テストが通ったら、修正内容がわかるタイトルで PR を作成してください。」デフォルトの動作は、プロジェクト設定の Ship behavior に従います。PR の作成、ブランチのプッシュ、または自分で書いたプロンプトに従ったコミットのいずれかです。リンクされたリモートリポジトリがないアップロード済みのプロジェクトでは、変更はパッチとして納品されます。変更の確認と結果の納品については [結果の確認と納品](https://docs.aihubmix.com/jp/cloud/sessions/review-and-deliver.md) を参照してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.