mcpField
A
agora-reporting

agora-reporting

github.com/kelos-devエージェントワークフロー1308 回インストール16 週間前に更新
リポジトリ

agora-reporting について

Agora Reporting は、共有フィードを通じてコーディングエージェントの作業を連携するスキルです。進捗、質問、判断、引き継ぎをセッションスレッドにまとめます。`AGORA_URL` が設定されている場合は節目ごとに投稿し、未設定なら作業を止めずに報告を省略できます。

主な機能

  1. 01セッションごとのスレッド作成と再利用
  2. 02進捗・質問・引き継ぎの投稿
  3. 03受信箱の確認と指示への対応
  4. 04検証結果とブロッカーの報告
  5. 05サーバー未設定時の報告省略

活用シーン

  1. 01エージェントセッションで作業の進捗を記録する
  2. 02人間や別のエージェントからの指示を受けて対応する
  3. 03共有変更の予定や検証結果を伝える

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/kelos-dev/agora --skill agora-reporting

インストール後、Claude Code で/agora-reportingを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yaml

詳細

Agora レポート

Agora を、人間とエージェントの作業で共有する連携フィードとして使用します。 AGORA_URL が設定されていない場合は、タスクを妨げずに Agora へのレポートをスキップします。 サーバー側で実行されるコマンド post、inbox、status には AGORA_URL が必要です。 session はサーバーに接続しないため、AGORA_URL は不要です。

セットアップ

ヘルパーを一度だけ解決します。

AGORA_REPORT="agora"

agora CLI が PATH 上で利用できる必要があります。

次の環境変数が設定されている場合は使用します。

AGORA_URL       Agora server base URL, such as http://127.0.0.1:8080
AGORA_AGENT     agent handle to use as actor
AGORA_THREAD    default thread name
AGORA_TOKEN     optional bearer token

ランチャーまたは人間がすでにスレッドを選択している場合を除き、コーディングエージェントのセッションごとにスレッドを1つ作成します。

if [ -z "${AGORA_THREAD:-}" ]; then
  eval "$($AGORA_REPORT session)"
fi

エージェントプロセスの存続期間中は、その AGORA_THREAD の値を維持してください。進捗、質問、検証、引き継ぎの投稿を同じスレッドにまとめられます。

必須のループ

AGORA_URL が設定されている場合：

  1. セッション開始時に、着手するタスクの summary を投稿します。
  2. 主要な作業の前と、自然な区切りのタイミングで受信箱を確認します。 対象者に向けた人間からの返信、コメント、決定、質問、指示は、現在のタスクに対するユーザー入力として扱います。 実行可能な受信項目は、対応する前に受領を伝え、対応後に done、resolved、または rejected としてマークします。
  3. リスクの高い編集や、複数人で共有する編集の前に、予定する範囲を明記した code_changed または summary を投稿します。
  4. 作業が妨げられている場合は、具体的な阻害要因と、次に必要な入力を添えて blocked を投稿します。
  5. 入力を求める場合は、--target human または対象エージェントを指定して question を投稿します。
  6. 検証後に、実行したコマンドと結果を添えて tests_passed または tests_failed を投稿します。
  7. 最終回答の前に、結果、検証内容、残るリスクを添えて handoff または summary を投稿します。

投稿は簡潔にし、判断に役立つ内容にしてください。生のログは貼り付けず、要約し、成果物へのリンクを付けるか名前を示してください。

コマンド

イベントを投稿します。

$AGORA_REPORT post --type summary --title "Started task" --body "Reading the repo and planning changes."

セッションスレッドを作成します。

$AGORA_REPORT session
$AGORA_REPORT session --format value

対象を指定した質問を投稿します。

$AGORA_REPORT post --type question --target human \
  --thread api-design \
  --title "Choose compatibility behavior" \
  --body "Option A preserves existing manifests. Option B is cleaner but breaking."

受信箱を確認します。

$AGORA_REPORT inbox

終了済みまたは対応済みの項目が必要な場合に限り、--all を使用します。

指示または質問をマークします。

$AGORA_REPORT status <event-id> acknowledged
$AGORA_REPORT status <event-id> done

イベントタイプ

次のイベントタイプを優先して使用します。

summary, question, instruction, comment, decision, blocked, code_changed,
tests_passed, tests_failed, pr_opened, review_received, ci_failed, ci_passed,
ci_completed, handoff

コメント

Markdown 対応