メニュー
Use when adding or changing an HTTP route under services/api. Walks the exact steps so the new route follows Helpline's gateway conventions.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | api-add-route |
| description | Use when adding or changing an HTTP route under services/api. Walks the exact steps so the new route follows Helpline's gateway conventions. |
| paths | services/api/** |
Activates for work in services/api. Follow these steps in order.
tickets.py for ticket
routes, a new module for a new noun). Signature is
(request: dict) -> dict.ValidationError —
never return an error dict by hand.packages/db) or another
service. The handler only orchestrates and shapes the response.routes.py inside build_app() —
app.route("METHOD /path", handler). A route not registered there does not
exist.tests/ that builds the app and dispatches the route.Full checklist with a worked example: references/route-checklist.md.
Use when creating or editing code under services/billing. Enforces Helpline's money-handling rules — integer cents only, seat limits, and BillingError for every violation.
Use after changing code, before claiming work is done — picks the correctly scoped pytest command instead of running the whole suite. Helps avoid the timeout-and-context-waste of full-suite runs on a one-service change.
Use after changing code, before claiming work is done — run the test command scoped to what you changed instead of the whole suite, to avoid the timeout and context waste of full-suite runs on a small change.