Wander Monitor

👤 erergb 📦 v1.0.3 ⭐ 4.2 ⬇️ 892 下载
💻 开发编程 免费

📖 技能介绍


name: wander-monitor description: "Guides use of Wander to monitor GitHub Actions without polling. Use when the user pushes code and wants CI notifications, asks how to watch workflows, avoid refreshing the Actions page, or integrate Wander (smart-push, foreground/background/detached, wrappers, edge cases)."


Wander — CI Workflow Monitor

Don't watch. Wander. CLI toolkit for monitoring GitHub Actions. No polling; optional macOS notifications when runs finish.

Agent auto-trigger (mandatory)

After every git push that triggers GitHub Actions, start Wander in background mode unless the user opts out.

  1. If .workflows.yml exists in the repo root: prefer a project wrapper (scripts/watch-*.sh) when present.
  2. Otherwise: "$WANDER_HOME/watch-workflow-bg.sh" <workflow.yml> (or pass the workflow file the project uses).
  3. Run in the background so the session stays responsive.
  4. After ~8s, check terminal output and report initial status.

If there is no .workflows.yml but .github/workflows/ exists, offer monitoring but do not auto-start without confirmation.

When to use this skill

  • User wants to monitor a workflow after git push
  • User asks for notifications when CI completes
  • User wants to avoid manually refreshing the Actions page
  • Long-running E2E or publish pipelines (minutes)
  • Project integrates CI monitoring (e.g. ClawHub publish)

Prerequisites

  • gh CLI installed and authenticated
  • jq (used by scripts)
  • Wander clone on disk; WANDER_HOME or default ~/code/wander
  • macOS for notification center integration

Install (tool)

git clone https://github.com/ERerGB/wander.git ~/code/wander
cd ~/code/wander
chmod +x *.sh

Add to ~/.zshrc or ~/.bashrc:

export WANDER_HOME="${WANDER_HOME:-$HOME/code/wander}"
export PATH="$WANDER_HOME:$PATH"
alias wf='watch-workflow.sh'
alias wfbg='watch-workflow-bg.sh'
alias wfdt='watch-workflow-detached.sh'

Or run ./scripts/install-personal.sh from the Wander repo (see main README).

Usage patterns

Smart push (Wander repo or similar)

cd /path/to/wander
./smart-push.sh

Suggests smoke / e2e / skip from changed files, then push and monitor.

Manual control (any repo)

git push
cd /path/to/target-repo
"$WANDER_HOME/watch-workflow-bg.sh" publish.yml

Modes

Mode Script Use case
Foreground watch-workflow.sh Block until result
Background watch-workflow-bg.sh Keep working; notify when done
Detached watch-workflow-detached.sh Close terminal; logs under ~/.wander_logs/
#!/bin/bash
# scripts/watch-publish.sh
REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
WANDER_DIR="${WANDER_DIR:-$(dirname "$REPO_ROOT")/wander}"
cd "$REPO_ROOT"
exec "$WANDER_DIR/watch-workflow-bg.sh" publish.yml "$@"

Then: git push && ./scripts/watch-publish.sh

Examples elsewhere: openclaw-uninstall uses ./scripts/watch-publish.sh and watch-publish-detached.sh when present.

Workflow registry

For check_window / expected_duration, add .workflows.yml at project root or set WORKFLOW_REGISTRY_FILE:

workflows:
  - name: "publish.yml"
    description: "Publish to ClawHub"
    check_window: 120
    expected_duration: 30
    category: "publish"

Default check_window is 300 seconds when a workflow is not listed.

Edge cases

Scenario Behavior Tip
Workflow finishes in under ~30s May show "already completed" + quick notify watch-workflow-bg.sh detects recent completion
Push then monitor immediately Run may not appear for 5–10s Scripts wait up to ~30s for the run to show
Wrong branch No workflow after wait window Confirm workflow on: filters match current branch
No lockfile in repo setup-node with cache: npm can fail Remove cache: npm if there is no package lockfile

When CI fails

  1. Note the run ID from output or notification.
  2. View failed logs: gh run view <RUN_ID> --log-failed
  3. Fix and git push, or gh run rerun <RUN_ID> --failed

    7w4.net提供免费和付费技能下载。

WANDER_HOME resolution

  • Environment variable WANDER_HOME if set
  • Sibling path: $(dirname "$REPO_ROOT")/wander (common in wrappers)
  • Default: ~/code/wander

Reference

🤖 AI 评测

这个 Skill 质量不错,文档写得很详细全面,把监控 GitHub Actions 的各种场景都考虑到了。优点是说明清晰、使用方式写得明白,AI 助手能快速理解该怎么用。不足是压缩包里只有文档说明,实际的工具脚本需要另外安装,文件数量偏少,缺少具体的使用示例。总体来说是个靠谱的 Skill,但如果你想直接使用可能还需要额外配置。

📊 多维度评分

适应性4.5
规范性4.1
有效性4.2
可靠性4
可信度4.3

📁 包含文件 (3 个)

📄 README.md 1 KB
📄 SKILL.md 4.5 KB
📄 _meta.json 133 B