Workflow Schema Tuning

Ajuste les descriptions de workflow-schema.json qui orientent la génération de workflows par l'IA.

par breaking-brake · breaking-brake/cc-wf-studio

Testé · Fonctionne ★ 8.0/10

Workflow Schema Tuning — Ajuste les descriptions de workflow-schema.json qui orientent la génération de workflows par l'IA.

Ce que fait

À utiliser lors de la modification de `resources/workflow-schema.json` dans cc-wf-studio pour influencer la façon dont les agents IA génèrent des workflows via le skill cc-workflow-ai-editor. Se déclenche notamment sur : "AIが特定のノードタイプを選んでくれない", "ワークフロー生成のバイアスを調整したい", "スキーマの description を変えたい", "新しいノードタイプを追加したい", "嘘の制約がスキーマに混じっていないか確認したい". Couvre ce que le schéma fait réellement (des instructions pour l'IA, pas des contraintes d'exécution), la philosophie de conception…

Rapport de test

Testé la boucle complète : installation clone+copy à l'identique (propre, frontmatter YAML valide, tous les fichiers schema/build référencés présents) plus un A/B sur une tâche réelle de diagnostic de biais de type de nœud (l'IA choisit trop souvent subAgent plutôt que prompt pour des étapes triviales). Les deux variantes ont correctement identifié l'asymétrie de aiGenerationGuidance/examples comme source du biais, mais la variante avec skill a ajouté des réécritures contrastives des descriptions (son principe « orienter la direction, ne pas dicter de règles ») et l'étape essentielle de régénération/vérification TOON que la variante de base a omise — le correctif JSON brut de la base n'aurait silencieusement pas pris effet puisque le MCP sert du TOON. À noter : les fichiers référencés par l'installation (workflow-schema.json, .toon, ai-editing-skill-template.md, generate-toon-schema.ts) ne se résolvent qu'avec cwd=packages/core, et le repo est géré avec pnpm malgré la formulation « npm run generate:toon » du SKILL.

Testé le: 2026-07-12 · Claude Code 2.x (agent harness)

Installation

git clone https://github.com/breaking-brake/cc-wf-studio
cd cc-wf-studio
mkdir -p ~/.claude/skills
cp -r .claude/skills/workflow-schema-tuning ~/.claude/skills/workflow-schema-tuning

Commandes et exemples de prompts

  • /workflow-schema-tuningAjuste les descriptions de workflow-schema.json qui orientent la génération de workflows par l'IA.

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

  • Adjust the schema so AI picks the right node type
  • Change this schema description to reduce generation bias
  • Add a new node type to the workflow schema