القائمة
Listen to SDD spec Markdown files in the browser with on-device TTS (Supertonic). Use after propose or on-demand for active changes and archived specs.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Guided complete flow to investigate and fix bugs — delegates investigation and fix to the refacil-debugger sub-agent in two passes separated by user confirmation
Internal reference — SDD-AI prerequisites shared by all other refacil skills (do not invoke manually)
Validate that the implementation meets the specs — builds a briefing with testCommand and CA/CR criteria, delegates to the refacil-validator sub-agent for the report, and handles corrections with user approval
Implement the tasks of a proposed change — verifies artifacts and working branch, builds a structured briefing, and delegates to the refacil-implementer sub-agent to execute the implementation in isolated context
Archive a completed change — move artifacts to archive and sync specs
Run the SDD implementation cycle autonomously after /refacil:propose was approved by the human — chains apply → test → verify → review → archive → up-code in a single invocation, and notifies the user via WhatsApp through Kapso when finished (success or failure). Use when the user says "autopilot", "ejecuta el resto del flujo", "termina solo", "modo autónomo", or indicates they will step away from the computer.
| name | refacil:read-spec |
| description | Listen to SDD spec Markdown files in the browser with on-device TTS (Supertonic). Use after propose or on-demand for active changes and archived specs. |
| user-invocable | true |
Play a Markdown spec aloud in the local browser using on-device TTS. The CLI parses the file(s), stores a short-lived session on the broker, and opens /read-spec.
Prerequisites: sdd profile from refacil-prereqs/SKILL.md.
Single file mode:
refacil-sdd-ai read-spec --file <path-relative-to-repo-root> [--lang es] [--voice M3] [--speed 1]
Folder mode (all SDD artifacts for a change in one browser panel with sidebar):
refacil-sdd-ai read-spec --change <changeName> [--select <file.md>] [--lang es] [--voice M3] [--speed 1]
--change <changeName>: loads all .md files from refacil-sdd/changes/<changeName>/ in order: proposal.md → design.md → tasks.md → specs.md → (others alphabetically). Opens a sidebar for navigation between files.--select <file.md>: pre-selects a specific file in the sidebar (default: proposal.md).--file and --change are mutually exclusive.Defaults: lang=es, voice=M3, speed=1.
The listen option is presented as option B in the /refacil:propose Step 3 review menu — handled directly by that skill. When the user selects B, run:
refacil-sdd-ai read-spec --change <changeName>
Language is auto-detected from the artifact content (no --lang flag needed). After playback, re-present the Step 3 review menu so the user can approve or request adjustments.
When there are no active folders under refacil-sdd/changes/ (except archive/):
refacil-sdd/specs/.read-spec --file refacil-sdd/specs/<name>/spec.md (verify the folder exists first).When there are active folders under refacil-sdd/changes/:
refacil-sdd-ai read-spec --change <changeName> [--select <file.md>]
If the user specifies a particular file (e.g. "I want to hear specs.md"), add --select specs.md.
When both active changes and refacil-sdd/specs/ exist:
read-spec --change <changeName> (with optional --select).refacil-sdd/specs/<name>/spec.md → run read-spec --file <path>.--file must stay inside the project root (the CLI enforces this).--change and --file are mutually exclusive — never pass both.