chore: add ClawSweeper agent skill

This commit is contained in:
Peter Steinberger
2026-04-29 02:48:34 +01:00
parent 1f41b8b44b
commit 610e575844
2 changed files with 113 additions and 0 deletions

View File

@@ -0,0 +1,109 @@
---
name: clawsweeper
description: Inspect ClawSweeper commit-review and issue/PR-sweeper reports for OpenClaw, including recent per-commit reports, finding summaries, GitHub Checks, Actions monitoring, manual backfills, and report links.
---
# ClawSweeper
ClawSweeper lives at `~/Projects/clawsweeper`. Use this skill when Peter asks
about ClawSweeper reports, commit-review checks, recent findings, historic
backfills, or whether the sweeper/dispatch lane is healthy.
## Start
```bash
cd ~/Projects/clawsweeper
git status --short
git pull --ff-only
pnpm run build
```
Do not overwrite unrelated local edits. If the tree is dirty, inspect status
and keep report-reading commands read-only unless Peter asked to commit.
## Recent Commit Reports
Canonical reports are flat:
```text
records/<repo-slug>/commits/<40-char-sha>.md
```
Use the lister instead of browsing date folders:
```bash
pnpm commit-reports -- --since 6h
pnpm commit-reports -- --since "24 hours ago" --findings
pnpm commit-reports -- --since 7d --non-clean
pnpm commit-reports -- --repo openclaw/openclaw --author steipete --since 7d
pnpm commit-reports -- --since 24h --json
```
One report per commit. Reruns overwrite the same SHA-named file. Results:
`nothing_found`, `findings`, `inconclusive`, `failed`, `skipped_non_code`.
## Monitor Actions
Receiver lane in `openclaw/clawsweeper`:
```bash
gh run list --repo openclaw/clawsweeper --workflow "ClawSweeper Commit Review" \
--limit 12 --json databaseId,displayTitle,event,status,conclusion,createdAt,updatedAt,url
gh run list --repo openclaw/clawsweeper --workflow "ClawSweeper Commit Review" \
--status in_progress --limit 20 --json databaseId,displayTitle,event,status,createdAt,url
```
Target dispatcher in `openclaw/openclaw`:
```bash
gh run list --repo openclaw/openclaw --workflow "ClawSweeper Dispatch" \
--event push --limit 8 --json databaseId,displayTitle,event,status,conclusion,headSha,url
git ls-remote https://github.com/openclaw/openclaw.git refs/heads/main
```
Check the target commit's published report check:
```bash
gh api "repos/openclaw/openclaw/commits/<sha>/check-runs?per_page=100" \
--jq '.check_runs[] | select(.name=="ClawSweeper Commit Review") | [.status,.conclusion,.details_url] | @tsv'
```
## Manual Backfill
Use the workflow when Peter asks to review a specific commit or historic range:
```bash
gh workflow run commit-review.yml --repo openclaw/clawsweeper \
-f target_repo=openclaw/openclaw \
-f commit_sha=<end-sha> \
-f before_sha=<start-sha> \
-f create_checks=true \
-f enabled=true
```
For a targeted rerun with extra instructions, add:
```bash
-f additional_prompt="Review this commit with focus on <topic>."
```
## Report Reading
Lead with counts and useful findings:
```bash
pnpm commit-reports -- --since 24h
pnpm commit-reports -- --since 24h --findings
```
If findings exist, open the markdown report and summarize:
- SHA and author/co-authors
- result, confidence, severity, check conclusion
- concrete finding and affected file
- whether the report includes tests/live checks
- GitHub report URL:
`https://github.com/openclaw/clawsweeper/blob/main/<report-path>`
Do not post GitHub comments from this lane. Commit Sweeper's public surfaces are
markdown reports and the `ClawSweeper Commit Review` check.

View File

@@ -0,0 +1,4 @@
interface:
display_name: "ClawSweeper"
short_description: "Inspect ClawSweeper commit review reports and Actions runs."
default_prompt: "Review recent ClawSweeper commit reports and summarize findings."