ralph-two-pass-scan
Cuts GitHub API calls by separating lightweight list scanning from full hydration
- License 许可
- MIT
- 所属仓库
- github/squad
- 最近更新
- 2026-11-15
- Stars
- ★ 3.4k
- Forks
- 520
01 前言 Front Matter
- name
- ralph-two-pass-scan
- domain
- work-monitoring
- source
- extracted
- confidence
- high
- description
- Cuts GitHub API calls by separating lightweight list scanning from full hydration
03 SKILL.md 正文
<!-- Generated by Squad from the Squad SDK (claude-plugin.ts). Do not edit: run node scripts/build-claude-plugin.mjs. -->
Skill: Ralph — Two-Pass Issue Scanning
Confidence: high Domain: work-monitoring Last validated: 2026-03-24
Context
Cuts GitHub API calls from N+1 to ~7 per round (~72% reduction) by separating list scanning from full hydration. Addresses the scanning inefficiency described in issue #596.
Pattern
Pass 1 — Lightweight Scan
gh issue list --state open --json number,title,labels,assignees --limit 100
Skip hydration if ANY of these match:
| Condition | Skip reason |
|---|---|
assignees non-empty AND no status:needs-review |
Already owned |
Labels contain status:blocked or status:waiting-external |
Externally gated |
Labels contain status:done or status:postponed |
Closed loop |
Title matches stale/noisy pattern ([chore], [auto]) |
Low-signal |
Pass 2 — Selective Hydration
For each issue surviving Pass 1:
gh issue view <number> --json number,title,body,labels,assignees,comments,state
Then apply normal Ralph triage logic. Rule of thumb: hydrate ≤ 30% of scanned list. If more than 30% survive Pass 1, tighten filter rules.
04 同仓库更多 Skills
windows-compatibility
Cross-platform path handling and command patterns
versioning-policy
SemVer rules for Squad's stable, preview, insider, and local package versions
tiered-memory
Three-tier agent memory model (hot/cold/wiki) for context reduction per spawn
test-discipline
Design assertions that prove the actual contract and fail on realistic regressions
squad
Squad's command catalog and interactive menu. Invoke via /squad (slash command) or natural language ("squad commands", "what can squad do", "show me squad options"). Presents categorized operations (Install & Upgrade, Team Management, Issues & PRs, Plugins & Skills, Model & Cost, Sessions & State) as an interactive picker. Routes to the right squad CLI command or the Squad coordinator agent.
squad-version-check
Internals of how @bradygaster/squad-cli stamps its version, how `squad upgrade` works (what it preserves vs overwrites), and how to probe the npm registry for the latest version from a coordinator prompt.