diff --git a/.agents/skills/clawsweeper/SKILL.md b/.agents/skills/clawsweeper/SKILL.md new file mode 100644 index 00000000000..697e3a56026 --- /dev/null +++ b/.agents/skills/clawsweeper/SKILL.md @@ -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//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//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= \ + -f before_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 ." +``` + +## 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/` + +Do not post GitHub comments from this lane. Commit Sweeper's public surfaces are +markdown reports and the `ClawSweeper Commit Review` check. diff --git a/.agents/skills/clawsweeper/agents/openai.yaml b/.agents/skills/clawsweeper/agents/openai.yaml new file mode 100644 index 00000000000..fdde4e3750b --- /dev/null +++ b/.agents/skills/clawsweeper/agents/openai.yaml @@ -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."