SkillProof tested Claude skills

Workflow Schema Tuning

Regola le descrizioni di workflow-schema.json che orientano la generazione dei workflow AI.

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

Promosso ★ 8.0/10

Workflow Schema Tuning — Regola le descrizioni di workflow-schema.json che orientano la generazione dei workflow AI.

Cosa fa

Da usare quando modifichi `resources/workflow-schema.json` in cc-wf-studio per influenzare il modo in cui gli agenti AI generano i workflow tramite lo skill cc-workflow-ai-editor. Si attiva su frasi come "AIが特定のノードタイプを選んでくれない", "ワークフロー生成のバイアスを調整したい", "スキーマの description を変えたい", "新しいノードタイプを追加したい", "嘘の制約がスキーマに混じっていないか確認したい". Copre cosa fa realmente lo schema (istruzioni per l'AI, non vincoli a runtime), la filosofia di design…

Rapporto di test

Testato l'intero ciclo: installazione verbatim clone+copy (pulita, frontmatter YAML valido, tutti i file di schema/build referenziati presenti) più un A/B su un task reale di diagnosi del bias di tipo-nodo (l'AI sceglie troppo spesso subAgent invece di prompt per step banali). Entrambi i bracci hanno correttamente identificato l'asimmetria di aiGenerationGuidance/examples come fonte del bias, ma il braccio con skill ha aggiunto riscritture contrastive delle description (il suo principio "orienta la direzione, non imporre regole") e il passaggio essenziale di rigenerazione/verifica TOON che il braccio base ha omesso — la patch al JSON grezzo del braccio base non avrebbe avuto effetto in silenzio, dato che l'MCP serve TOON. Nota: i file referenziati dall'installazione (workflow-schema.json, .toon, ai-editing-skill-template.md, generate-toon-schema.ts) si risolvono solo con cwd=packages/core, e il repo è gestito con pnpm nonostante la dicitura 'npm run generate:toon' dello SKILL.md.

Testato il: 2026-07-12 · Claude Code 2.x (agent harness)

Installazione

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

Comandi e prompt di esempio

  • /workflow-schema-tuningRegola le descrizioni di workflow-schema.json che orientano la generazione dei workflow AI.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • 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

Rapporto completo →