Workflow Schema Tuning

Stemt de beschrijvingen in workflow-schema.json af die AI-workflowgeneratie beïnvloeden.

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

Getest · Werkt ★ 8.0/10

Workflow Schema Tuning — Stemt de beschrijvingen in workflow-schema.json af die AI-workflowgeneratie beïnvloeden.

Wat het doet

Te gebruiken bij het aanpassen van `resources/workflow-schema.json` in cc-wf-studio, om te beïnvloeden hoe AI-agents workflows genereren via de cc-workflow-ai-editor-skill. Triggers zijn onder meer "AIが特定のノードタイプを選んでくれない", "ワークフロー生成のバイアスを調整したい", "スキーマの description を変えたい", "新しいノードタイプを追加したい", "嘘の制約がスキーマに混じっていないか確認したい". Behandelt wat het schema daadwerkelijk doet (instructies aan de AI, geen runtime-restricties), de ontwerpfilosofie…

Testrapport

De volledige loop getest: letterlijke clone+copy-installatie (schoon, geldige YAML-frontmatter, alle verwezen schema-/buildbestanden aanwezig) plus een A/B op een realistische node-type-bias-diagnosetaak (AI kiest te vaak subAgent boven prompt bij triviale stappen). Beide varianten identificeerden de asymmetrische aiGenerationGuidance/examples correct als de bron van de bias, maar de skill-variant voegde contrasterende description-herschrijvingen toe (het principe 'stuur de richting, schrijf geen regels voor') en de essentiële TOON-regeneratie-/verify-stap die de basisvariant oversloeg — de raw-JSON-patch van de basisvariant zou stilletjes niet werken, omdat de MCP TOON serveert. Let op: de door de installatie verwezen bestanden (workflow-schema.json, .toon, ai-editing-skill-template.md, generate-toon-schema.ts) zijn alleen te vinden met cwd=packages/core, en de repo wordt met pnpm beheerd, ondanks de 'npm run generate:toon'-formulering van de SKILL.

Getest op: 2026-07-12 · Claude Code 2.x (agent harness)

Installatie

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

Commando's en voorbeeldprompts

  • /workflow-schema-tuningStemt de beschrijvingen in workflow-schema.json af die AI-workflowgeneratie beïnvloeden.

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

  • 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