| name | polish |
| description | Repo-wide consistency sweep. Aligns naming, docstring style, log fields, error message phrasing, and removes dead code. |
| argument-hint | [--scope=<dir|file>] |
| user-invocable | true |
| disable-model-invocation | true |
/polish
Canonical algorithm
- Resolve scope: default = entire
src/eawf/; --scope=<dir|file> narrows.
- Sweep checks: naming, docstrings, log fields, error message phrasing, dead code, citation density, draft sentinels, scrub status.
- Apply fixes inline. If a change touches public API, stop and ask.
Pre-flight checklist
Decision surfaces
Public-API renames, dead-code deletions, and anything matching polish.deletion_policy MUST be raised via AskUserQuestion (options: apply / defer-to-backlog / skip) instead of asking in free text. polish.auto_apply_safe=true bypasses the prompt for the small "safe" subset only (formatting, comment phrasing).
Output contract
Skill envelope with a change list grouped by category and a deferred- items list for changes needing user OK.