Workflow Schema Tuning

Dostraja opisy w workflow-schema.json, które wpływają na generowanie workflow przez AI.

Autor: breaking-brake · breaking-brake/cc-wf-studio

Testowano · Działa ★ 8.0/10

Workflow Schema Tuning — Dostraja opisy w workflow-schema.json, które wpływają na generowanie workflow przez AI.

Co robi ten skill

Użyj, gdy modyfikujesz `resources/workflow-schema.json` w cc-wf-studio, żeby wpłynąć na to, jak agenci AI generują workflow przez skill cc-workflow-ai-editor. Triggery obejmują: "AIが特定のノードタイプを選んでくれない", "ワークフロー生成のバイアスを調整したい", "スキーマの description を変えたい", "新しいノードタイプを追加したい", "嘘の制約がスキーマに混じっていないか確認したい". Obejmuje to, co schema faktycznie robi (instrukcje dla AI, nie ograniczenia runtime), filozofię projektową…

Raport z testu

Przetestowano cały cykl: instalacja słowo w słowo (git clone + cp) zadziałała czysto (poprawny YAML frontmatter, obecne wszystkie referencjonowane pliki schema/build), plus test A/B na realnym zadaniu diagnozowania biasu typu węzła (AI zbyt często wybiera subAgent zamiast prompt przy trywialnych krokach). Oba warianty poprawnie zidentyfikowały asymetryczne aiGenerationGuidance/examples jako źródło biasu, ale wariant ze skillem dodał kontrastowe przepisanie opisów (zgodnie z jego zasadą „nadawaj kierunek, nie narzucaj reguł”) oraz kluczowy krok regeneracji/weryfikacji TOON, który wariant bazowy pominął — łatka bazowa na surowym JSON po cichu by nie zadziałała, bo MCP serwuje TOON. Uwaga: pliki referencjonowane przez instalację (workflow-schema.json, .toon, ai-editing-skill-template.md, generate-toon-schema.ts) rozwiązują się tylko przy cwd=packages/core, a repo jest zarządzane przez pnpm, mimo że SKILL sugeruje polecenie „npm run generate:toon”.

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

Instalacja

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

Komendy i przykładowe prompty

  • /workflow-schema-tuningDostraja opisy w workflow-schema.json, które wpływają na generowanie workflow przez AI.

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

  • 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