diff --git a/.agents/skills/openclaw-pr-maintainer/SKILL.md b/.agents/skills/openclaw-pr-maintainer/SKILL.md index ff03e429131..5bea778d261 100644 --- a/.agents/skills/openclaw-pr-maintainer/SKILL.md +++ b/.agents/skills/openclaw-pr-maintainer/SKILL.md @@ -7,6 +7,22 @@ description: Review, triage, close, label, comment on, or land OpenClaw PRs/issu Use this skill for maintainer-facing GitHub workflow, not for ordinary code changes. +## Start issue and PR triage with ghcrawl + +- Anytime you inspect OpenClaw issues or PRs, check local `ghcrawl` data first for related threads, duplicate attempts, and already-landed fixes. +- Use `ghcrawl` for candidate discovery and clustering; use `gh`, `gh api`, and the current checkout to verify live state before commenting, labeling, closing, or landing. +- If `ghcrawl` is missing, stale, lacks the target thread, or has no embeddings for neighbor/search commands, fall back to the GitHub search workflow below. +- Do not run expensive/update commands such as `ghcrawl refresh`, `ghcrawl embed`, or `ghcrawl cluster` unless the user asked to update the local store or the stale data is blocking the decision. + +Common read-only path: + +```bash +ghcrawl threads openclaw/openclaw --numbers --include-closed --json +ghcrawl neighbors openclaw/openclaw --number --limit 12 --json +ghcrawl search openclaw/openclaw --query "" --mode hybrid --json +ghcrawl cluster-detail openclaw/openclaw --id --member-limit 20 --body-chars 280 --json +``` + ## Apply close and triage labels correctly - If an issue or PR matches an auto-close reason, apply the label and let `.github/workflows/auto-response.yml` handle the comment/close/lock flow. @@ -59,9 +75,9 @@ Use this skill for maintainer-facing GitHub workflow, not for ordinary code chan ## Search broadly before deciding -- Prefer targeted keyword search before proposing new work or closing something as duplicate. -- Use `--repo openclaw/openclaw` with `--match title,body` first. -- Add `--match comments` when triaging follow-up discussion. +- Prefer `ghcrawl` first. Then use targeted GitHub keyword search to verify gaps, live status, comments, and candidates not present in the local store. +- Use `--repo openclaw/openclaw` with `--match title,body` first when using `gh search`. +- Add `--match comments` when triaging follow-up discussion or closed-as-duplicate chains. - Do not stop at the first 500 results when the task requires a full search. Examples: