aurora-cli_skill

Overview

This skill runs the Aurora CLI to generate or regenerate frontend modules, add frontend packages, or scaffold a new Aurora frontend project. It helps automate codegen after YAML schema changes and manages flags that control file overwrites and interface updates. Use it when you need to update generated code or install Aurora front packages quickly and reliably.

How this skill works

The skill constructs and runs the appropriate aurora CLI command based on the requested action: load front module, add front package, or new front project. It supports flags like --force (-f), --overwriteInterface (-w), and --verbose (-v). When regeneration creates .origin files for manually edited files, the skill warns and instructs to run aurora-origin-merge to complete merges.

When to use it

• You need to regenerate or generate a frontend module from cliter/<bc>/<module>.aurora.yaml
• You want to add a preconfigured frontend package (oAuth, iam, common, etc.)
• You are creating a new Aurora frontend project
• After YAML schema changes that require code regeneration
• When you need to force overwrite or selectively overwrite interfaces

Best practices

• Always run git diff HEAD -- cliter/<bc>/<module>.aurora.yaml before merging to capture NEW/MODIFIED/DELETED fields
• Prefer -w to update TypeScript interfaces only when preserving custom code
• Avoid -f unless you intend to discard local customizations
• If .origin files are created, do NOT answer ‘n’ to the CLI prompt — that deletes origin files
• After regeneration, run aurora-origin-merge and follow its Step 0 using the YAML diff

Example use cases

• Regenerate the common/country module after updating its YAML: aurora load front module -n=common/country
• Force a full regen when intentionally discarding changes: aurora load front module -n=common/country -f
• Overwrite interfaces only to pick up new fields: aurora load front module -n=common/country -w
• Install the iam package into the frontend: aurora add front iam
• Create a fresh admin frontend app: aurora new front my-admin-panel