菜单
Regenerate the frontend TypeScript API client from backend OpenAPI spec. Use after changing backend controller signatures or related data types. Triggers on: generateTypeScript, API regeneration, controller signature changed, OpenAPI lint failure, generated API code.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Set up and run the doughnut dev environment on Cursor Cloud VM (no Nix). Use when working on Cloud VM, running tests on Cloud VM, or encountering command errors related to missing nix. Triggers on: cloud VM, cloud agent, no nix available, /workspace path.
Retrospective on what made a task unexpectedly difficult. Triggered by the 5-minute timer hook. Reviews your own session to identify codebase friction and either fixes it or proposes improvements. Triggers on: 5-minute hook, slow progress, friction, hard to find, confusing.
Autonomously execute a phased plan under .planning/phases/ or .planning/quick/ (GSD PLAN.md files, or legacy flat/ongoing plans). Applies local wrap-up on every phase: Jidoka, post-change-refactor, plan update, commit, and push. Parallel waves OK when safe. Triggers on: execute plan, run plan, execute phases, start plan, do .planning, execute .planning, run .planning.
Decompose tasks into GSD-aligned phased plans with Behavior/Structure grammar (one observable behavior per phase, stop-safe). Use when planning new features, breaking down large tasks, when a task has been in progress for over 10 minutes, or when the planning timer hook fires. Triggers on: plan, decompose, phases, break down, task too large, stuck.
Profile a test suite, optimize the slowest top 10% in phased groups, and close with a re-profile. Works for unit/integration tests in any sub-project (backend, frontend, cli, mcp-server) or Cypress E2E. Use when the developer asks to optimize, speed up, or profile slow tests, top 10% slowest, or test performance.
Fix bugs with a test-first workflow. Use when the user reports a bug, asks to fix a defect, or describes unexpected behavior. Triggers on: bug, fix, defect, broken, regression, not working, unexpected behavior.
| name | generate-api-client |
| description | Regenerate the frontend TypeScript API client from backend OpenAPI spec. Use after changing backend controller signatures or related data types. Triggers on: generateTypeScript, API regeneration, controller signature changed, OpenAPI lint failure, generated API code. |
Purpose: Keep packages/generated/doughnut-backend-api in sync with Java
controllers — never hand-edit generated output.
Output: Regenerated client + green frontend tests + summary ending with
## API CLIENT GENERATED.
Never edit generated code directly. This includes whitespace-only cleanup in
sdk.gen.ts, types.gen.ts, and open_api_docs.yaml; if generated output
changes, accept it or fix the generator path.
Git does not use the Nix prefix. All other repo tooling does:
CURSOR_DEV=true nix develop -c …
Do not run raw git diff --check as a generated-client cleanup gate. Use
scripts/check_diff_whitespace.sh, which excludes generated API artifacts from
manual whitespace fixes.
Regenerate when:
pnpm openapi:lint or pnpm format:all fails with OpenAPI validation errors
CURSOR_DEV=true nix develop -c pnpm frontend:test
Fix any broken frontend code that used the old API signatures.
If `pnpm openapi:lint` fails: **do not** edit `open_api_docs.yaml` (it is generated). Fix Java controllers, regenerate, then re-lint. Playbook details: `.cursor/rules/linting_formating.mdc` → **OpenAPI Linting**.<success_criteria>
pnpm generateTypeScript run with Nix prefix## API CLIENT GENERATED
</success_criteria>## API CLIENT GENERATED
<out_of_scope>
sdk.gen.ts, types.gen.ts, or open_api_docs.yaml.git diff --check for generated-client whitespace gates.
</out_of_scope>