作業はポータル、Slack、Telegram内のユーザー、自社システムやアシスタント、そしてCoroidの自動化処理からCoroidに届きます。ポータルで作業内容を記述する「新規作業」もその一つです。これらすべては同じ実行パスに集約されます。仕様定義、プラン作成、ビルド、検証、レビュー、プルリクエスト。
| ルート | 利用シーン |
|---|---|
| 新規作業 | 誰かが何かを望んでおり、それを説明するためにここに来た場合 |
| 課題のインポート | Jira、Linear、Trello、またはGitHub Issuesに既に該当する要求が存在する場合 |
| Coroidに依頼する | 会話形式で説明したい場合 |
| SlackまたはTelegram | 誰かがチャットで要求を出した場合 |
| 作業受付API | 自社製品内の機能要求フォームなど、別のシステムが要求を登録する場合 |
| イベント自動化 | GitHub、Slack、Telegram、またはJira内の何かが作業になるべき場合 |
| Coroid MCP | Hermes、Codex、Claude Codeなどのアシスタントやエージェントが作業を管理する場合 |
| スケジュール | トリガーは時間です |
| フック | トリガーはプラットフォームイベントです |
| レポートと調査結果 | レポートや品質チェックで修正すべき問題が見つかった場合 |
リクエスト
新規作業
誰かが説明する
課題のインポート
トラッカーから取り込む
APIを介した情報の取り込み
自社製品またはエージェント
イベント自動化
pull request、コメント、またはメッセージ
資格審査
リクエストをスクリーンし、重複を排除して検証した上で、処理経路を決定します。適格性を満たすまで何も作成されません。
成果物
- タスク
- 計画
- レポート
- スケジュール
いずれかを選択するか、[Create] を [Automatic] に設定し、Qualification が自動的に選択させます。
タスクと計画:仕様、計画、ビルド、検証、レビュー、pull request
確認後、ルーティングされる
新規作業やインポートからの要求は到着後すぐには作成されません。まずはQualificationプロセスを経ます。Coroidは機密情報の有無を確認し、現在のリリース版との整合性をチェックし、重複を探し、内容を検証して最終的な形を決めます。条件を満たすまで何も作成されません。詳細は必要なものを記述する。
作業受付APIからの要求も同様にこのプロセスを経由し、イベント自動化がQualificationに送るイベントも同様です。
最終的にたどり着くのは以下の4つのルートのいずれかです:
| ルート | 生成物 |
|---|---|
| タスク | 単一のタスクで、最終的に1つのpull requestが生成される |
| プラン | コードを記述する前に承認する段階的なプラン |
| レポート | 生成されたレポート |
| 自動化 | スケジュールに従って、または何らかのイベントが発生した際に実行される作業 |
新規作業フォームでは、自分でルートを選択するか、自動設定のままにしておくこともできます。自動そしてQualificationに選択させます。一方を選択した場合にQualificationが別のものを推奨したときは、その推奨内容が表示され、それに基づいて決定します。
Coroidの動作は他とは異なります。アシスタントモードでは、チャットアシスタントがQualificationを介さずに直接タスクやプランを作成します。ガイド付きSDLCワークフローであるPrepare Workチャットでは、承認済みの仕様書をQualificationに送り、その後で計画を開始します。詳細はこちら。チャットアシスタント。
他のルートではQualificationを介さずに直接作業が作成され、どの作業を開始するかはそれぞれの設定により決まります。MCPサーバーの場合、これらは承認ルールや自動化ポリシーとなります。
作業が開始されるタイミング
ポータル内で作業受付APIからの要求やイベント自動化を待つことはありません。CoroidはQualificationの承認を得てから数分以内に作業を作成します。タスクが自動的に開始されるかどうかは、要求の出所によります:
| ソース | 自動的に開始 |
|---|---|
| 承認済みの作業を自動的に開始するように設定されたサービスアカウント | はい |
| GitHubのpull requestまたは、リポジトリへの書き込み権限を持つ発行者による課題 | はい |
| Coroidを言及するGitHubのコメントで、執筆者によるもののみが対象 | はい |
| その他のサービスアカウント | いいえ |
| Slack、Telegram、Jiraおよびその他のソース | いいえ |
自動的に開始しないタスクは、誰かが開始するのを待ちます。Qualificationには、誰かが開始するのを待つ要求として表示され、タスクへのリンクが付随します。プランは常に承認を待つため、決して自動的に開始しません。スケジュールは、実行時期を決定するために人がレビューを行うまで待機します。
Coroidは、このリスト内で最初にアクティブなメンバーとして作業を作成します。すなわち、要求を提出した人、自動化を設定した人、サービスアカウントの作成者、プロジェクトの作成者、組織のオーナーです。
プロジェクトが指定されていない要求は、組織内で唯一のプロジェクトに割り当てられます。複数ある場合は、要求はQualificationでのレビューを待ち、承認時にレビュー担当者がプロジェクトを選択します。
タスクかプランか?
判断の目安はレビュー可能性です。完成した作業が同僚が一気に読める程度のpull requestであればタスクです。定められた順序で複数の変更が必要な場合、または構築前にアプローチを承認したい場合はプランとなります。
迷った場合は、重要な作業には必ずプランを選択してください。プランを使えばコードが存在する前に承認チェックポイントが設けられ、考えを変えるのに最もコストがかかりません。タスクが大きすぎた場合は、処理できる容量を超えてしまいます。
インポートされた作業
トラッカーからインポートされた課題は、同じ資格審査プロセスを経ます。重複した課題や既に修正済みの課題、検証できない要求はそこで除外され、残りのものがタスクや計画になります。バックログは希望リストなので、このフィルターは他の場所よりもインポート時により重要です。詳細は作業のインポート。
自社システムから
別のシステムは、作業受付用のAPIを通じて要求を送信できます。例えば、自社製品内の機能要求フォームや、顧客の要望を伝えるサポートツールなどです。
APIにはサービスアカウントが必要で、これはProfessionalプランおよびEnterpriseプランに含まれています。作成は設定 → サービスアカウント。そのAPIキーには、次のスコープが必要です:intake:write。キーは作成時に一度だけ表示され、サービスアカウントを無効にすると、関連するすべてのキーが使用不可になります。
各要求をAPIゲートウェイに送信し、キーをビアー・トークンとして指定します:
curl -X POST https://api.coroid.ai/api/v1/organizations/work/intake \
-H "Authorization: Bearer ak_…" \
-H "Content-Type: application/json" \
-d '{"title": "Export invoices as CSV", "content": "Customers want to download their invoices as CSV from the billing page."}'| フィールド | 必須 | 説明 |
|---|---|---|
title | はい | 最大500文字の短い名前 |
content | はい | 要求内容で、最大20,000文字 |
projectId | いいえ | 作業が属するプロジェクト |
workType | いいえ | task、plan、reportまたはschedule |
signal | いいえ | 要求の発生源となるエラー、アラート、または課題で、以下に説明があります |
作業タイプが指定されていない場合、資格審査プロセスが処理経路を決定します。資格審査はすべてのAPI要求に対して実行され、スキップすることはできません。
要求が監視システムや他の自動化ソースから来る場合は、そのシグナルを説明してください。Coroidはこれを利用して、どのプロジェクトでも同じインシデントが二重に登録されるのを防ぎ、タスクの成果物契約。
signalフィールド | 必須 | 説明 |
|---|---|---|
fingerprint | はい | エラートラッカー内の課題IDなど、インシデントを一意に識別する安定した情報 |
source | いいえ | シグナルの発生源で、例えばglitchtipまたはsentry |
routes | いいえ | インシデントの影響範囲となるルートで、最大50件まで |
minExposure | いいえ | 結果が判定されるまでに、これらのルート上で処理されるべきリクエスト数はいくつか |
url | いいえ | インシデントへのリンク |
〜と共にroutesおよびminExposureこれらがあれば契約は測定可能になる:インシデントは無音状態を保たなければならない。これらがなければ、契約では測定不能と記録される。要件測定不能な作業を開始することを拒否できる。
サービスアカウントからの承認済みタスクは、誰かが開始するのを待ちます。オーナーまたは管理者は、サービスアカウント設定画面でこの設定を変更できます:承認済み作業を自動的に開始するこの機能は、そのアカウントから送信される作業がすべて信頼できるユーザーによるものである場合のみ有効にしてください。詳細はこちら作業の開始時期。
GitHub、Slack、Telegram、Jiraのイベントもリクエストになり得ます。再入力の手間は不要です。イベント自動化機能がこれらをQualificationに送信します。詳細はこちらトリガーと送信先。
アシスタントからの作業
Hermes、Codex、Claude Codeなど、ご自身で運用するアシスタントやエージェントは、MCPサーバーを介してCoroidと連携できます。プロジェクトや作業内容を読み取り、許可された範囲内で作業の作成・実行・納品が可能です。これらが作成する作業はQualificationを経由しません。詳細はこちらCoroidをMCPサーバーとして利用。
自動エントリー
スケジュールやフックにより、人の指示なしで作業が開始されます。違いはトリガーだけで、時間指定または何かの発生が契機となります。どちらも自動化処理これらはファクトリーに一覧表示され、新規作業で作成されます。
品質チェックにより修正作業も発生します。品質ポリシーがレポートを検査し、製品に問題が見つかると、Coroidがそれらに対する修正タスクを作成します。ファクトリー → レビュー特定のタスクに割り当てられていないテスト失敗を一覧表示します。修正これを選択すると修正タスクに変換されます。
これらすべては実際のエージェントスロットとモデル利用料を消費します。人が待っている作業よりも自動化作業の優先度を低く設定してください — 詳細はこちら処理能力とエージェントスロット。