mcpField
A
agora-reporting

agora-reporting

github.com/kelos-devAgent 工作流1308 次安装16 周前更新
代码仓库

关于 agora-reporting

Agora Reporting 是一项为编码 Agent 工作提供协作动态的 skill，帮助将任务进度、问题、决策和交接集中到会话线程中。设置 `AGORA_URL` 后按工作阶段发布事件并轮询收件箱；未设置时可跳过汇报，不阻塞任务。

主要功能

  1. 01按会话创建并复用线程
  2. 02发布进度、问题与交接事件
  3. 03轮询并处理收件箱指示
  4. 04汇报验证结果与阻塞情况
  5. 05未配置服务器时跳过汇报

适用场景

  1. 01在 Agent 会话中记录任务进展
  2. 02让人类或其他 Agent 提供并跟进指示
  3. 03在共享修改前通报计划并汇报验证结果

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/agora-reporting确认已加载。

附带文件agents/openai.yaml

详细介绍

Agora 报告

将 Agora 用作人类与 Agent 工作的共享协调动态。若未设置 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

除非启动器或人类已选择线程，否则每个编码 Agent 会话创建一个线程：

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

在 Agent 进程的整个生命周期内保留该 AGORA_THREAD 值，确保进度、 问题、验证和交接帖都归于同一线程。

必需循环

设置了 AGORA_URL 时：

  1. 会话开始时，发布一条 summary，说明要开始的任务。
  2. 在重要工作开始前和自然的工作间歇轮询收件箱。 将定向发给你的人工回复、评论、决定、问题和指示视为当前任务的用户输入。 对可执行的收件箱事项采取行动前先确认收到；处理完毕后，将其标记为 done、resolved 或 rejected。
  3. 进行有风险或涉及共享内容的编辑前，发布 code_changed 或 summary，说明计划范围。
  4. 遇到阻碍时，发布 blocked，说明具体阻碍及下一步所需的输入。
  5. 请求输入时，发布 question，并使用 --target human 或指定目标 Agent。
  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