القائمة
Apply when changing the REST API surface — actix handlers, utoipa annotations, or request/response types under server/.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | openapi |
| description | Apply when changing the REST API surface — actix handlers, utoipa annotations, or request/response types under server/. |
server feature. ApiDoc in src/server/run/mod.rs (module openapi); Swagger UI via utoipa-swagger-ui.openapi.schema.yaml (repo root, ~296 KB). A CI Schema job regenerates it and diffs against the committed file (stripping the version: line), so it must stay in sync.After ANY API-surface change (routes, handlers, #[utoipa::path], schema structs), regenerate and commit the schema in the same PR, or CI fails:
cargo run -- server schema --output-file openapi.schema.yaml
Because the file is large, expect big diffs — review them. The version: line doesn't matter (CI strips it).
Apply for build/test/lint, dependency or feature changes, and editing Cargo.toml or .cargo config in this repo.
Apply when creating or tracking a GitHub issue, or planning multi-step work — the issue template and the task convergence loop.
Apply when editing .proto files or the generated protobuf types (src/pbs/*) in this repo.
Apply when working with RocksDB storage — importing datasets, key encoding, column families, or query paths.
Apply when writing or editing Rust code in this crate — idioms, error handling, logging, docs, and lint rules.
Apply when writing or running tests, or updating insta snapshots, in this repo.