ドキュメント

最初のタスクを実行する

作業内容を記述し、計画を承認すれば、Coroidがそれを構築・検証する様子を確認できます。

あるタスクとは、1つのpull requestとして完了する作業単位です。以下から開始してください。新規作業を選択し、タスクを作成先に設定します。自動に設定すると、Coroidがタスクと計画のいずれかを選択します。

適切な最初のタスクを選ぶ

最適な最初のタスクは、規模が小さく、実際に実行可能で、既存のテストに近いものです。例えば「新しい--jsonエクスポートコマンドにフラグを付与し、インポートコマンドが既に対応している出力形式に合わせると、Coroidに明確なターゲットが設定され、結果を容易に把握できます。

初回実行時は以下の内容を避けてください:

  • 認証、決済、データ移行に関連する作業
  • まだ決定していない設計判断が必要な作業
  • 曖昧な整理作業 — 「エラーハンドリングの改善」には完了の基準が存在しません

求める成果を記述してください

実装方法ではなく、最終的な成果を記載します。作業完了時に満たされるべき条件を明記し、重要なファイルや遵守すべき規約、触れてはならない箇所など、分かりにくい点も併記してください。

計画を自ら作成する必要はありません。それはCoroidが最初に生成するものであり、あなたが承認するものです。

コードに含まれていない背景情報 — ADR、スタイルガイド、チケットなど — がある場合は、それらを添付してください。詳細は「プロジェクトコンテキスト」をご覧ください。プロジェクトコンテキストこれにより、明示的に指示しなくてもCoroidが既に把握している情報を活用できます。

新規作業
成果物を記述してください。Coroidがそれを実現する適切な方法を見つけ出します。
作成モード
自動タスク計画
Coroidが結果を選択するか、ご自身で指定できます。
プロジェクト
web-app
作業タイトル
顧客が請求書をCSV形式でエクスポートできるようにする。
概要

財務部門からは常に請求書をスプレッドシート形式で要求されます。請求書一覧にエクスポートボタンを追加し、現在のフィルター条件をCSV形式でダウンロードできるようにします。

完了条件:ファイルがExcelおよびNumbersで開けること、金額が勘定通貨で表示されること、1万行を超えるデータのエクスポートでもタイムアウトしないこと。

ファイルを添付
次のステップ:要件確認。まだ何も作成されていません。続行

新規作業フォーム:作成する内容を選択し、プロジェクトを指定した後、タイトルと簡単な説明で成果物を記述します。

資格審査の手順へ進む

選択してください続行まだ何も作成されていません。Coroidがリクエストを確認し、現在のリリース内容と照らし合わせて重複がないかをチェックし、処理経路を決定します。問題がなければタスクが作成され、キューに追加されます。Qualificationで却下された場合は、その理由が示されるので、リクエストを編集して再試行できます。必要な内容を記述する。

仕様書をレビューする

Coroidはあなたの記述内容を仕様書に変換します。これには開発対象、範囲外の項目、成功を判断する受入基準が含まれます。この仕様書はタスクの「仕様書」タブに表示されます。

開発が始まる前に必ず確認してください。受入基準が希望通りでなければ、今すぐ修正しましょう。後続の検証ステージではこの基準に基づいてテストが実施されるからです。詳細は仕様書。

計画を承認する

些細な変更以外の場合、仕様書は計画となり、これは順序付けられた手順の集合です。コードを記述する前にこの計画を承認する必要があります。

ここが修正を加えるのに最もコストが低い段階です。計画を却下するのにかかる時間はわずか1分ですが、完成したpull requestを却下すると、1回分の実行コストがかかります。

実行状況を確認する

タスクが作成されると、PENDINGに入り、エージェントスロットが空くまで待機します。IN_PROGRESS実行中の様子をリアルタイムで確認できます。実行された手順、呼び出されたツール、操作されたファイル、蓄積されるテスト結果などがわかります。

常に監視する必要はありません。必要な時や完了時に通知が届きます。

期待できること

  • 所要時間は変更の規模やテストスイートの実行時間によって決まり、所有するエージェントスロット数には依存しません。スロット数は同時に実行されるタスク数を制御します。
  • NEEDS_HUMAN_REVIEWは失敗ではありません。これはCoroidがあなたのみが判断できる事項に直面したことを意味します。回答すればタスクは続行されます。
  • 手直しは通常のことです。レビュアーが問題を発見した場合、あなたが確認する前に開発者に戻されます。

次へ

結果をレビューしてマージする— 届いた成果物と確認すべき点について