mcpField
C
clawsweeper-status

clawsweeper-status

github.com/steipete云与 DevOps7.4k95 次安装1 周前更新
代码仓库

关于 clawsweeper-status

通过附带脚本报告目标仓库的 ClawSweeper 工作流与队列状态，并整理近期仓库活动，说明队列状态及容量信息。

主要功能

  1. 01报告 Worker 与工作流状态
  2. 02汇总队列健康状况和退避信息
  3. 03展示发布队列指标
  4. 04列出近期合并、审查和评论
  5. 05支持仓库、时间范围和行数选项

适用场景

  1. 01检查仓库的 ClawSweeper 活动
  2. 02找出等待操作人员处理的停放项目
  3. 03查看近期合并和关闭的项目
  4. 04检查队列容量与重试状态

安装

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

$npx skills add https://github.com/steipete/agent-scripts --skill clawsweeper-status

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

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
scripts/
clawsweeper-status.sh
clawsweeper-status.test.sh
scripts/fixtures/
public-exact-review-queue.json

详细介绍

ClawSweeper 状态

快速开始

先运行随附的状态脚本：

/Users/steipete/Projects/agent-scripts/skills/clawsweeper-status/scripts/clawsweeper-status.sh

有用的选项：

# Last 10 hours for the default target repo, openclaw/openclaw
/Users/steipete/Projects/agent-scripts/skills/clawsweeper-status/scripts/clawsweeper-status.sh --hours 10

# A different target repo
/Users/steipete/Projects/agent-scripts/skills/clawsweeper-status/scripts/clawsweeper-status.sh --repo openclaw/clawhub

# More rows per activity section
/Users/steipete/Projects/agent-scripts/skills/clawsweeper-status/scripts/clawsweeper-status.sh --limit 15

输出约定

简要报告以下部分：

  • Workers：工作流状态、相对于配置容量的 Codex 任务数、精确审核队列及可用时的目标占用率，以及活跃工作流组。即使没有私有目标占用率，公共队列汇总数据仍然可用；occupancy unavailable 不代表为零。
  • Queue health：只要状态不是 healthy，就优先报告此项。仅凭待处理队列深度不能判断情况——请查看脚本在其下方打印的分类：
    • ready/admissible 接近零而待处理队列很深，表示该通道在有意暂缓处理项目，并非陷入停滞。
    • Queue backoff: throttle_retry N 表示 GitHub 正在实施速率限制；配额恢复后，该通道会自行恢复。
    • Queue parked (needs operator): review_retry_exhausted N 不会自动恢复。暂停的项目会在 5/10/20 分钟后重试，然后等待人工处理。务必明确指出这些项目。
    • Shed since reset 增至数千，表示持续过载，而非短暂波动。
  • Publication tail：汇总待处理、就绪、退避、暂停和活跃数量，以及可用时的容量；同时报告重试和暂停原因。此项与审核积压分开，不代表各目标的活动；不含此通道的旧版响应会报告 unavailable。
  • Recently merged：已合并 PR 的 URL 及一行标题。
  • Recently reviewed：ClawSweeper/Codex 审核评论的 URL 及一行评论摘要。
  • Recently commented：ClawSweeper 近期其他评论的 URL 及一行评论摘要。
  • Recently closed：已关闭 issue/PR 的 URL 及一行标题。

如果脚本未返回某部分的行，请写明 none found in window。

活跃工作流组最多显示 20 个，按运行次数降序排列；活动部分最多显示 --limit 行。大型工作流快照仍须涵盖所有活动部分。必要的数据获取或解析失败仍属致命错误；可选的队列/容量遥测可以保持不可用。

高效数据源

优先使用该脚本，因为它会限制 API 调用范围：

  • 对 openclaw/clawsweeper 进行字段范围受限的 Actions 运行查询和有界活跃任务探测；
  • 获取小型自动化限制配置和精确审核队列状态端点，以提供容量背景信息；
  • 获取近期 issue 评论中的审核/评论 URL；
  • 使用字段范围受限的已关闭项目搜索获取关闭 URL 和操作者；
  • 获取字段范围受限的近期已合并 PR。

进行这些检查时不要浏览网页。直接使用 gh。

解读

  • 当同一项目出现更新事件时，已取消的 repository-dispatch 审核运行通常是预期的取代行为。
  • 根据实际进行中/排队的任务统计 Codex 用量；使用 setup-action 步骤和已知通道名称识别 Codex 工作。
  • 将 pending 工作流运行视为等待并发资源，而非排队的 Codex 任务。
  • 谨慎看待过时的工作进程数量；当数字不一致时，将按状态筛选的 gh run list 结果与默认的近期运行列表进行比较。
  • 队列读取无需身份验证。即使没有私有项目键，公开的最早待处理时长仍有参考价值；缺失的健康计数应标记为 unknown，而非零。
  • 最终答复中使用完整的 GitHub URL。

评论

支持 Markdown