ドキュメント

必要な内容を記述する

新規作業フォームのすべての項目——作成対象の選択から品質管理、詳細設定まで。

「新規作業」は、ポータル内で作業内容を記述する場所です。成果物を一度だけ記述します。Coroidが作成前にリクエストを検証し、それをタスク、段階的な計画、レポート、または自動化処理に変換します。

作業内容は、課題追跡ツールや自社システム、自動化処理からも入力されます。こちらをご覧ください。作業開始の方法。

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

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

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

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

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

作成先を選択

最初の行で、リクエストが何になるかが決まります。

オプション生成されるもの
自動Coroidは「資格審査」の段階で処理経路を選択します。
タスク単一のタスクで、最終的に1つのpull requestが生成されます。
計画コードを記述する前に承認する段階的な計画です。
レポート生成されるレポートです。
自動化スケジュールに従って実行される、または何らかの事象が発生した際に動作する作業です。

自動デフォルトでは「自動」が選択されます。Coroidは資格審査中にリクエストを読み取り、適切な処理経路を選択します。すでに答えが分かっている場合は、自分で経路を指定できます:タスク作業内容が単一の変更で、レビュー担当者が一度に確認できる場合は、計画特定の順序で複数の変更が必要な場合、またはすべてを確定する前に全体のアプローチを確認したい場合は、

指定した経路と資格審査で推奨される経路が異なる場合、作成前にフォーム上でその旨が表示されます。推奨内容を受け入れるか、リクエストを編集できます。

複数のプロジェクトにまたがる作業は常に計画として扱われます。2つ目のプロジェクトを追加すると、「自動」のみが利用可能になります。自動と計画が利用可能です。

フォームはルートに合わせて自動調整されます。レポートではさらに下の方で固有の詳細を入力し、タスクや計画には仕様セクションが表示されます。自動化処理には専用のフォームがあり、実行タイミングと実行内容を指定できます。詳細はこちらをご覧ください。自動化処理。

フォームの横には2つのショートカットがあります:課題をインポートは、追跡ツールから作業内容を取り込みます。そしてCoroidに依頼は同じ作業をチャットアシスタント。

プロジェクト

この作業が属するプロジェクトを選択してください。自動と計画あなたはさらにプロジェクトを追加できます作業が関連する複数のプロジェクトにまたがる場合です。これがクロスプロジェクト作業の表現方法です。1つのタスクは必ず1つのプロジェクト内で実行されます。

作業内容を記述

2つのフィールドがあり、それぞれ役割が異なります。

作業タイトル:短い名称です。後で一覧で探す際に使用します。

概要:作業の本質です。成果物、背景、制約条件、元となる資料、そしてCoroidが提供すべき内容を記述します。実装方法ではなく成果物を記述してください。Coroidがそれを「検証可能な仕様書そして完成した作業がその約束事に合致しているかを確認します。

Add rate limiting to the public API.
100 requests per minute per API key. Exceeding it returns 429 with a
Retry-After header. Limits are per key, not per IP.
Internal service-to-service calls are exempt — they authenticate with
service tokens, not API keys.
Do not change the existing auth middleware's public interface.

最後の行が実際の作業を行っています。スコープ行によって、焦点を絞った変更と広範囲に及ぶ変更が区別されます。

「自動生成、タスクと計画概要欄の下にファイルをドラッグ&ドロップ、貼り付け、または添付できます:スクリーンショット、PDF、メモなど。タスクには画像を、計画にはPDFやテキストファイルも利用できます。

仕様書

タスクと計画には「仕様書」セクションがあり、2つの選択肢があります:

  • 概要から:デフォルトの設定です。Coroidが概要(意図、ユーザーストーリー、受入基準)から仕様書を作成し、それに基づいて作業を構築・検証します。
  • 自分で記述:生成された仕様書の代わりに自分で記述します。意図、ユーザーストーリー、受入基準、制約条件、ビジネス価値、スコープ、種類を自分で入力します。

「自分で記述、AIによる構造化概要からフィールドを下書きとして作成し、そこから編集できます。また、保持された内容、追加された内容、収まりきらなかった内容の履歴も表示されるため、概要の情報が失われていないかを確認できます。

受入基準が既に存在する場合(例えば製品要件書など)は自分で記述し、そうでなければ概要から始めてタスクの「仕様書」タブで結果を修正してください。詳細は仕様書駆動開発。

詳細設定

オプションです。表示されるフィールドは選択した経路により異なります。

計画のための詳細設定です。タスクには目標や制約条件の代わりに、最大トークン数、スプリント、対象リリースが表示されます。

SDLCワークフローを利用

デフォルトではオフです。これを有効にすると「意図と「仕様書計画を開始する前に。最終的なボタンは「作業の準備」に変わり、作業をすぐに作成する代わりに ガイド付きの準備画面が開きます。

アプローチが策定される前にチェックポイントを設けたいほど重要な作業の場合にこの機能を有効にし、 要件が明確な作業の場合は無効にしてください。詳細はSDLCワークフロー。

作業開始前の事前検証

デフォルトで有効です。組織のポリシーが許可する場合、リクエストに対して事前検証を無効にできます。 その際には理由を記入する必要があり、実行者、理由、時間、ポリシー情報は監査履歴に永続的に記録されます。 事前検証が省略された場合、詳細設定の見出しにその旨が表示されます。

目標

プランのみ。プランが達成すべき内容_以上_要件を超える内容。要件では何を構築するかが定義され、目標ではそれが何のためにあるかが定義されます。

AIプロファイル

この作業を実行するモデルはどれか。詳細はAIプロファイル。

QAチェック

適用される検証レベルは何か。ポリシーの既定値を使用プロジェクトまたは組織の品質管理ポリシーから継承されます。標準現在のチェックを実行します。徹底要件に対してより慎重なライブチェックを追加し、標準レベルで承認される作業を却下することがあります。

適用されるポリシーは実行開始時に確定します。その後のポリシーの変更は、すでに実行中の作業に遡及的に反映されません。詳細は品質ポリシーとゲート。

優先度

P0からP3までで、デフォルトはP2。優先度は、利用可能なエージェントスロット数よりも待機中の作業が多い場合にキューを並べ替えます。 ただし、処理能力を増やすわけではありません。詳細は処理能力とエージェントスロット。

トークン予算

プランにおいて、生成される各タスクのトークン予算は、生成される各タスクが消費できるコンテキスト量を制限します。タスクにおいて、最大トークン予算はタスク自体の上限を設定します。制限を設けない場合は空欄のままにしてください。 大規模なコードベース全体を参照する必要がある作業には予算を増やし、定型作業ではコストを抑えるために予算を減らしてください。

制約条件

プランのみ。プランの制約条件、非目標、依存関係、納品ルール。ここには明示的な非目標を記載し、スコープの拡大を防ぐ上で最も効果的なフィールドです。

開始元/プルリクエスト先

作業が開始されるブランチと、pull requestが対象とするブランチです。開始元と同じはデフォルトでチェックが入っており、両方が同じ設定を適用します。

main → new Coroid branch → PR into main

Coroidは常に作業用ブランチを作成します。これらのフィールドは分岐ポイントとpull requestが配置される場所のみを変更します。Coroidが既存のブランチに直接コミットすることはできず、続行する前にフォームでリモート上に該当ブランチが存在するかが確認されます。

デフォルトブランチ以外にマージする場合に使用します。例えばadevelopブランチやリリーストレインなどです。

スプリントとターゲットリリース

タスクと自動リクエストからタスクが生成されます。そのタスクをスプリントに配置し、計画済みのリリースに最初から関連付け、後から割り当てるのではありません。

続行:事前審査

「続行」を押しても何も作成されません。続行.Coroidはまずリクエスト内の認証情報やその他の機密値をスクリーニングし、その後で事前審査:

適格性審査項目

  1. 正規化およびサニタイズ
  2. プロンプトインジェクションをフィルタリング
  3. 現在のリリースを確認
  4. 重複を排除してクラスタリング
  5. 検証または再現
  6. 影響度と所有者を評価
  7. 作業経路を決定

審査に合格するまで作業は存在しません。

適格作業が作成されます

タスクはキューに入り、計画が立案を開始します。添付ファイルがある場合は、レビューで確認し、最初に作成します。

重複既に修正済み

新規作業なし。重複分は、既存のリクエストにマージされます。

再現不可レビューが必要

編集して再試行するか、閉じるか、権限があれば理由を記録して強制的に作成できます。

すべての提出内容は Quality Control → Qualification に保存されます。

チェック実行中は何も作成されません。審査結果によってリクエストが作業に変換されるかが決まり、すべての提出内容とその証拠は記録に残ります。

事前審査では、リクエストを現在のリリースと照合し、重複を探し、可能な範囲で検証または再現を行い、影響度・担当者・範囲・難易度を評価して処理経路を決定します。各チェックの状況をリアルタイムで確認できます。

次に実行される処理は判定結果によって異なります:

  • 承認済み:事前審査が通過すれば、添付ファイルがないタスクやプラン、SDLCワークフローがすぐに作成されます。そうでない場合は、レビューして作成というボタンに、作成される内容が表示されます: タスクを作成、プランを作成、レポートを生成または自動化を作成新しいタスクがすぐにキューに追加され、新しいプランの計画が開始されます。
  • 重複または既に修正済み:新たな作業は作成されません。重複する内容は、それをカバーする既存のリクエストに統合されます。
  • 既に解決済み:同じ問題や不具合が既に別のリクエストで対応中であり、どのプロジェクトでも同様です。その場合は、該当する作業にリクエストを紐付けます。
  • 変更不要:評価の結果、報告された動作が意図通りであると判明しました。作業は作成されません。
  • 延期:人が関与しない形で届くリクエスト、例えばワークインテイクAPIや監視システムからのもののみが対象です。作業は条件を満たしますが、実行を待つ必要があります。 命令の容量や予算の都合により、ここで作成したリクエストが延期されることはありません。
  • 再現不可、却下またはレビューが必要:作業は作成されません。リクエストを編集して証拠を追加するか、資格審査を再実行するか、または閉じてください。

判定結果に同意できない場合、権限を持つユーザーはそれでも作業を作成。上書きには理由が必要で、その理由は記録されます。

決定を待つリクエストは「作成」の下に一覧表示されます。ファクトリー → レビュー、そしてどのような判定結果であっても、各提出物はチェック内容、証拠、監査履歴を含む独自のページを保持します。