name: ralph-specum-cancel
description: This skill should be used only when the user explicitly asks to use $ralph-specum-cancel, or explicitly asks Ralph Specum in Codex to stop execution or remove a spec.
metadata:
surface: helper
action: cancel
Ralph Specum Cancel
Use this to stop execution and optionally remove a spec.
Contract
- Resolve the target by explicit path, exact name, or
.current-spec - Always clear execution state when the user wants to stop execution
- Confirm before deleting a spec directory
- Do not guess on ambiguous names
Action
- Resolve the target spec. If none exists, report that there is nothing to cancel.
- Read
.ralph-state.jsonwhen present and summarize the current phase and progress. - Safe cancel is the default. Delete
.ralph-state.jsononly and keep the spec files unless the user asked for full removal. - If the user wants full removal, confirm first, then delete the spec directory and clear
.current-specwhen it points to that spec. - If the removed spec belongs to the active epic, keep epic files intact unless the user explicitly asked to remove epic planning too.
- Report exactly what was removed.