inferspec-scanlisted

# /inferspec-scan Bulk-infer OpenSpec specs for every capability in the current repo. Drafts are written with `[GAP]`/`[TBD]` markers — non-blocking, so even ambiguous code gets a starting spec. Follow up with `/inferspec-cap <slug>` to fill the gaps interactively (it also handles iterative gap-fill on existing specs). ## Output format Each `openspec/specs/<cap>/spec.md` has two H2 sections — `## Purpose` and `## Requirements`. Requirements use RFC 2119 keywords (MUST / SHALL / SHOULD / MAY) and carry `**Source:**` citations. ## Usage ``` /inferspec-scan # full scan (incremental if previous run exists) /inferspec-scan --force-rescan # bypass hash-skip /inferspec-scan --since HEAD~20 # only re-draft caps whose files changed since <rev> /inferspec-scan --exclude vendor third_party ``` ## When this skill is invoked, run these steps ### Step 0 — Parse flags + read config Parse the user's invocation for these flags: - `--force-rescan` → set `FORCE_RESCAN=1` - `--since <rev>` → set `SINCE_REV=<rev>` (used in Step 4 to filter caps) - `--exclude <name> [<name>...]` → collect excludes Read `.inferspec.yaml` from cwd if present. Use its `exclude:` list additively with the CLI `--exclude`. Use its `mcp_overrides:` to disable detected MCP servers the user wants to skip. Ensure `graphify-out/` is gitignored: ```bash if [ -f .gitignore ] && ! grep -qxF "graphify-out/" .gitignore; then echo "graphify-out/" >> .gitignore fi ```