Workflow Schema Tuning

Ajusta las descripciones de workflow-schema.json que sesgan la generación de workflows por IA.

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

Probado · Funciona ★ 8.0/10

Workflow Schema Tuning — Ajusta las descripciones de workflow-schema.json que sesgan la generación de workflows por IA.

Qué hace

Úsala al modificar `resources/workflow-schema.json` en cc-wf-studio para influir en cómo los agentes de IA generan workflows a través de la skill cc-workflow-ai-editor. Los disparadores incluyen "AIが特定のノードタイプを選んでくれない", "ワークフロー生成のバイアスを調整したい", "スキーマの description を変えたい", "新しいノードタイプを追加したい", "嘘の制約がスキーマに混じっていないか確認したい". Cubre lo que realmente hace el esquema (instrucciones para la IA, no restricciones en tiempo de ejecución), la filosofía de diseño…

Informe de la prueba

Se probó el ciclo completo: instalación literal con clone+copy (limpia, frontmatter en YAML válido, todos los archivos de schema/build referenciados presentes), más una prueba A/B en una tarea real de diagnóstico de sesgo de tipo de nodo (la IA elige subAgent en vez de prompt para pasos triviales con demasiada frecuencia). Ambos brazos identificaron correctamente el aiGenerationGuidance/examples asimétrico como el origen del sesgo, pero el brazo con skill añadió reescrituras contrastivas de las descripciones (su principio de 'alinear la dirección, no prescribir reglas') y el paso esencial de regeneración/verificación de TOON que el brazo base omitió — el parche en JSON crudo del base no habría surtido efecto de forma silenciosa, ya que el MCP sirve TOON. Nota: los archivos referenciados en la instalación (workflow-schema.json, .toon, ai-editing-skill-template.md, generate-toon-schema.ts) solo se resuelven con cwd=packages/core, y el repositorio se gestiona con pnpm pese a que el SKILL usa la redacción 'npm run generate:toon'.

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

Instalación

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

Comandos y prompts de ejemplo

  • /workflow-schema-tuningAjusta las descripciones de workflow-schema.json que sesgan la generación de workflows por IA.

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • 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