Contrat de scène mixer

VérifiéSûr

Concevoir le contrat structuré pour les changements de scène mixer approuvés, incluant les champs de schéma, le modèle d'approbation et d'audit, des exemples CLI en mode dry-run et une liste de contrôle de tests.

Spar Skills Guide Bot
DeveloppementIntermédiaire
30/07/2026
Claude CodeCursorCodex
#schema-design#approval-workflow#audit-logging#cli-dry-run#mixer-control

Recommandé pour

Synthèse automatique

Conçoit le contrat structuré (schéma MixerSceneIntent, modèle d'approbation et d'audit, CLI en dry-run, checklist de tests) permettant d'armer des scènes et cues sur une console Soundcraft Ui24R sans exécution autonome.

Points forts

  • Délimite clairement l'opération « armer une scène/cue pour approbation » de l'exécution automatique et du générique arm_effect.
  • Impose des identifiants explicites (show_name, snapshot_name, cue_name, scene_id, setlist_ref) au lieu d'une résolution floue en direct.
  • Fournit un modèle d'audit complet : requête, intention, décision, ID d'approbation, opérateur et cible d'adaptateur.
  • Liste les fichiers de contexte et les tests unitaires à lire ou à couvrir, ce qui rend la spécification directement exploitable.

Limites

  • Skill de conception uniquement : il ne produit pas l'implémentation ni le code du schéma.
  • Suppose l'existence préalable des fichiers showDirector et CLI mentionnés dans le dépôt.
  • Le périmètre MVP exclut volontairement la recherche de scène en direct et toute exécution autonome.
Quand l'utiliser

À utiliser dès qu'une tâche touche à la définition ou à la révision du contrat de scènes mixer, du schéma, du flux d'approbation ou de la forme de la CLI dry-run.

Quand l'éviter

À éviter si l'objectif est d'écrire le code d'implémentation, de piloter réellement la console, ou de gérer d'autres effets de scène que ceux du mixer.

Analyse de sécurité

Sûr
Score qualité85/100

The skill is purely a design/specification workflow: it instructs reading source files and writing a contract document to a workspace markdown file. It declares no tools, performs no execution, and does not include destructive, exfiltration, or obfuscation patterns. The only filesystem action is writing a local markdown file, which is low risk.

Aucun point d'attention détecté

Comment cette analyse est faite

Exemples

Initial contract draft
Write the mixer scene contract for our AI party show director: define the MixerSceneIntent schema fields, the approval and audit model, dry-run CLI examples, action-plan mapping, and a unit-test checklist. Output to _workspace/ai-party-mixer/01_contract.md.
Revise for explicit IDs
Update the mixer scene contract so every request must carry show_name, snapshot_name, cue_name, scene_id or setlist_ref instead of a fuzzy live lookup, and show the new CLI dry-run shape plus audit entry.
Keep gain and mute blocked
Revise the show-director contract follow-up: confirm mixer_gain, pa_mute and audio_routing stay operator-only, separate mixer scene arming from arm_effect, and list the showDirector and cliAgent tests to add.

name: mixer-scene-contract description: "Design the MixerSceneIntent, approval state, JSON schema, CLI examples, audit entries, and tests for AI-Controlled Party mixer/Soundcraft Ui24R scene arming. Use whenever a task mentions mixer scenes, Ui24R snapshots/cues, operator-approved mixer control, show-director contract updates, schema updates, dry-run CLI shape, or follow-ups that revise this contract."

mixer-scene-contract

Design the structured contract for approved mixer scene changes. This skill is for design/spec work, not implementation.

Context to read

  • src/automation/showDirectorSchema.ts
  • src/automation/showDirectorRuntime.ts
  • src/cli/agent.ts around show-director
  • tests/unit/showDirector.test.ts
  • tests/unit/cliAgent.test.ts

Design rules

  • Keep mixer scene changes separate from generic arm_effect.
  • The MVP operation is "arm scene/cue for approval", not autonomous execution.
  • Require explicit names or IDs: show_name, snapshot_name, cue_name, scene_id, or setlist_ref. Do not design fuzzy live lookup as execution.
  • Preserve blocked/operator-only semantics for mixer_gain, pa_mute, and audio_routing.
  • Every accepted request needs an audit entry with request, intent, decision, approval ID, operator, and adapter target.

Output

Write _workspace/ai-party-mixer/01_contract.md with:

  1. proposed schema fields and examples;
  2. approval and audit model;
  3. CLI dry-run examples;
  4. mapping to action plans;
  5. compatibility notes;
  6. unit-test checklist.

Quality bar

The result should be specific enough that a builder can implement it without asking what fields exist or how approval flows.

Du fichier au premier essai

Le téléchargement contient exactement le contenu affiché sur cette fiche. Cette copie peut différer de la dernière version du dépôt source.

Consulter la source et ses fichiers annexes

Ce téléchargement contient uniquement SKILL.md. Les scripts, références, modèles et dépendances éventuels ne sont pas inclus. Récupérez les fichiers nécessaires depuis la source en conservant leur arborescence avant de poursuivre.

1. Télécharger le fichier

Télécharger SKILL.md

Depuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/mixer-scene-contract-ms71b317/SKILL.md, ou utilisez la commande suivante. Ce dossier sert à examiner la skill avant son installation.

Commande pour macOS/Linux ou WSL : un shell POSIX et curl sont nécessaires. Sous Windows sans WSL, utilisez le bouton de téléchargement et créez le dossier manuellement.

mkdir -p '.skill-downloads/mixer-scene-contract-ms71b317' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/mixer-scene-contract-ms71b317/download' --output '.skill-downloads/mixer-scene-contract-ms71b317/SKILL.md.part' && mv '.skill-downloads/mixer-scene-contract-ms71b317/SKILL.md.part' '.skill-downloads/mixer-scene-contract-ms71b317/SKILL.md'

2. Vérifier les prérequis

Lisez SKILL.md avant de l’utiliser. Si le fichier cite des scripts ou services externes, examinez-les et préparez les accès nécessaires dans votre environnement de test.

Aucune section de prérequis reconnue dans ce fichier. Cela ne signifie pas qu’il est autonome : les bibliothèques, outils et accès peuvent être cités ailleurs dans le contenu ou dans le dépôt source.

Les plateformes de la fiche sont des indications du catalogue. Les chemins ci-dessous suivent la documentation des outils ; ils ne prouvent pas que cette skill y a été exécutée. Aucune version minimale de ces outils n’est attestée pour cette fiche.

3. Charger la skill

Après vérification, copiez le dossier complet dans le projet avec l’une des commandes ci-dessous, puis ouvrez une nouvelle session de l’outil. La commande s’arrête si un dossier du même nom existe déjà : comparez les fichiers avant de le remplacer.

Claude Code
test -f '.skill-downloads/mixer-scene-contract-ms71b317/SKILL.md' && test -s '.skill-downloads/mixer-scene-contract-ms71b317/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/mixer-scene-contract' && cp -R '.skill-downloads/mixer-scene-contract-ms71b317' '.claude/skills/mixer-scene-contract'

Cursor
test -f '.skill-downloads/mixer-scene-contract-ms71b317/SKILL.md' && test -s '.skill-downloads/mixer-scene-contract-ms71b317/SKILL.md' && mkdir -p '.cursor/skills' && test ! -e '.cursor/skills/mixer-scene-contract' && cp -R '.skill-downloads/mixer-scene-contract-ms71b317' '.cursor/skills/mixer-scene-contract'

Codex
test -f '.skill-downloads/mixer-scene-contract-ms71b317/SKILL.md' && test -s '.skill-downloads/mixer-scene-contract-ms71b317/SKILL.md' && mkdir -p '.agents/skills' && test ! -e '.agents/skills/mixer-scene-contract' && cp -R '.skill-downloads/mixer-scene-contract-ms71b317' '.agents/skills/mixer-scene-contract'

OpenSkills

OpenSkills doit déjà être installé. La procédure locale install/read est contrôlée avec OpenSkills 1.5.0, qui exige Node.js ≥ 20.6.0. Aucun slug du catalogue n’est résolu automatiquement.

Installation officielle d’OpenSkills
openskills install './.skill-downloads/mixer-scene-contract-ms71b317'

openskills read 'mixer-scene-contract-ms71b317'

La lecture doit afficher le contenu du fichier installé et son dossier de base. Elle ne lance ni la skill ni ses dépendances.

Pour un agent qui lit AGENTS.md, synchronisez ensuite l’index. Cette commande modifie AGENTS.md : relisez le diff avant de l’utiliser.

openskills sync

Mode manuel ou autre outil : joignez SKILL.md à une conversation, ou ouvrez-le dans un agent capable de lire les fichiers. Ajoutez les ressources annexes nécessaires. Il n’existe pas de dossier universel reconnu par tous les outils.

4. Faire un premier essai

Utilisez une entrée courte et fictive : un endpoint d’API, un petit document ou un brief d’interface. Dans une nouvelle conversation, joignez le fichier ou donnez son chemin à l’agent, puis adaptez cette demande :

Lis .skill-downloads/mixer-scene-contract-ms71b317/SKILL.md et applique ses instructions à cet exemple : [décrire une entrée de test]. Indique les fichiers, dépendances ou accès qui manquent. Produis le résultat demandé par la skill sans inventer de données ni exécuter de script non examiné.

Résultat attendu : une sortie correspondant aux instructions de la skill, ou une liste précise des prérequis manquants. Une simple confirmation de lecture ne valide pas le premier usage. Si une ressource externe est indisponible, ce parcours reste à tester.

Skills similaires