菜单
Run the emulator-gated Firestore test suites (session + park store) for the Go and Python ports. Use after changing session/park-store code or workflow event fields — these suites are excluded from the default `make ci` gate.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Update the okf/ knowledge bundle after a change to the system — the touched concepts, their index entries, the affected diagrams, and the bundle log. Use at the end of any change that alters system shape (an agent, a Kind, a route, a check name, a package, an env var, a port convention), or standalone when the bundle has drifted from reality.
Convert acceptance criteria, Jira tickets, Gherkin scenarios, PRDs, or any product requirements into a filled-in spec under specs/ using this repo's templates. Use when translating PM artifacts or informal asks into an add, change, migrate, or remove spec ready for implementation.
Scaffold a new deterministic, agent-free tooling package on the modern pair, with tests and its knowledge concept. Use when the system needs a new platform capability (an API client, ingress, transport, notifier-style package) rather than a new workflow.
Scaffold a new workflow agent end-to-end on the modern pair — ingest Kind, dispatcher registration, agent package, tests, webhook route, and the knowledge updates. Use when adding an entirely new workflow (a new fixer, digest, or reviewer-style agent) to the system.
Interview the user one question at a time to resolve every unfilled marker in a spec file (`<!-- TODO -->`, raw template placeholder prose, `<YYYY-MM-DD>`-style header stubs, empty plan steps, unconfirmed reverse-spec presumptions). Use on hand-authored specs, stale specs, or when the user says "grill me" or "stress-test this plan". The conversion skills (/ac-to-spec, /reverse-spec) embed this logic inline, so freshly-converted specs don't need a separate pass. Recommends an answer for every question, explores the codebase and okf bundle instead of asking when it can, and writes resolutions back with a Decisions log.
Execute a library, API, or framework swap on a port — mechanical migration that preserves observable behavior, verified against the shipped API. Use when bumping a major SDK version (e.g. the ADK), swapping a library, or moving to a new provider API.
| name | run-firestore-tests |
| description | Run the emulator-gated Firestore test suites (session + park store) for the Go and Python ports. Use after changing session/park-store code or workflow event fields — these suites are excluded from the default `make ci` gate. |
The Firestore session/park-store backends are validated against the Cloud Firestore emulator, not the default unit run — make cover deliberately excludes them so nobody needs the emulator for everyday work. This skill runs that gated slice explicitly.
Parameters: none
Usage examples:
/run-firestore-tests # start emulator, run go/ + python/ suites, stop emulator
The authoritative flow, backend matrix, and coverage rationale live in okf/standards/testing.md (Firestore-backed tests section) and okf/tooling/ci-gates.md. This skill is a thin driver.
After any change touching:
*_firestore backends, store conformance suites)SESSION_BACKEND switching logic or store construction in the setup layerNot needed for changes that never touch persisted state — the default make ci covers those.
Start the emulator (needs Java 17+; gcloud components install cloud-firestore-emulator one-time), capturing the PID so teardown kills exactly what was started:
gcloud emulators firestore start --host-port=127.0.0.1:8791 &
EMULATOR_PID=$!
Wait for the "Dev App Server is now running" line before proceeding.
Run the Go suite (from go/):
FIRESTORE_EMULATOR_HOST=127.0.0.1:8791 GOOGLE_CLOUD_PROJECT=test make cover-firestore
Run the Python suite (from python/):
FIRESTORE_EMULATOR_HOST=127.0.0.1:8791 make cover-firestore
Stop the emulator — kill the process you started (the gcloud wrapper spawns a Java child, so kill the process group, not just the PID):
kill -- -"$(ps -o pgid= -p "$EMULATOR_PID" | tr -d ' ')" 2>/dev/null || kill "$EMULATOR_PID" 2>/dev/null || true
Verify nothing is left listening: lsof -i :8791 should be empty. If the PID was
lost (different shell), fall back to pkill -f 'firestore.*8791' — scoped to this
port so unrelated emulators survive.
Report pass/fail per port. On failure, fix and re-run only the failing port's step (leave the emulator up between retries; still stop it when done).
FIRESTORE_EMULATOR_HOST is unset — that's expected, not a bug; set the var on the same command line.go/ and python/ have cover-firestore targets (the modern pair). The frozen pair (kotlin/, javascript/) is out of scope here./verify as usual too.