المهارات scaffolding-openai-agents
🤖

scaffolding-openai-agents

آمن ⚡ يحتوي على سكربتات🌐 الوصول إلى الشبكة⚙️ الأوامر الخارجية

Crear agentes OpenAI con el SDK

Crear agentes de IA desde cero requiere comprender patrones asíncronos, integración de herramientas y traspasos entre múltiples agentes. Esta habilidad proporciona patrones de andamiaje listos para producción para que puedas enfocarte en la lógica de tu agente en lugar de código repetitivo.

يدعم: Claude Codex Code(CC)
📊 71 كافٍ
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "scaffolding-openai-agents". Create an agent that helps students learn Python with async patterns and function tools for code execution

النتيجة المتوقعة:

  • Agente configurado con nombre, instrucciones y herramientas
  • Función main asíncrona usando el patrón Runner.run()
  • Decorador de herramienta de función para operaciones personalizadas
  • Continuación de la conversación con historial de mensajes
  • Manejo de respuesta en streaming para salida en tiempo real

استخدام "scaffolding-openai-agents". Build a multi-agent system with a triage agent that routes programming questions to specialist agents

النتيجة المتوقعة:

  • Agente de triaje con descripciones de handoff
  • Agentes especialistas para conceptos, depuración y ejercicios
  • Enrutamiento automático basado en el contenido de la pregunta
  • Implementación de handoff entre agentes con transferencia completa de contexto

استخدام "scaffolding-openai-agents". Add input validation to prevent non-programming questions from reaching the tutoring agent

النتيجة المتوقعة:

  • Función de guardrail de entrada que comprueba palabras clave de programación
  • GuardrailFunctionOutput con la marca tripwire_triggered
  • Agente configurado con la lista input_guardrails
  • Preguntas no relacionadas con programación bloqueadas antes del procesamiento del agente

التدقيق الأمني

آمن
v5 • 1/16/2026

Pure documentation skill containing example code patterns and a simple validation script. No malicious code, no credential access, no network exfiltration, no persistence mechanisms. All static findings are false positives from the scanner misinterpreting documentation text and markdown code blocks as executable code.

3
الملفات التي تم فحصها
792
الأسطر التي تم تحليلها
3
النتائج
5
إجمالي عمليات التدقيق

عوامل الخطر

⚡ يحتوي على سكربتات (1)
scripts/verify.py:1-44
🌐 الوصول إلى الشبكة (1)
SKILL.md:213
⚙️ الأوامر الخارجية (1)
SKILL.md:16
تم تدقيقه بواسطة: claude عرض سجل التدقيق →

درجة الجودة

45
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
21
المجتمع
100
الأمان
87
الامتثال للمواصفات

ماذا يمكنك بناءه

Crear agentes de tutoría

Construye agentes de tutoría inteligentes que expliquen conceptos y guíen a los estudiantes a través de materiales de aprendizaje

Orquestar agentes especialistas

Diseña sistemas multiagente donde agentes especialistas manejan distintas tareas mediante enrutamiento por handoff

Integrar agentes con FastAPI

Envuelve agentes de OpenAI en endpoints FastAPI para despliegue de API en producción con soporte de streaming

جرّب هذه الموجهات

Configuración básica de agente 
Create an agent using OpenAI Agents SDK that answers questions about Python programming. Include async Runner usage and streaming responses.
Herramientas de función 
Add function tools to an existing agent. Create a weather lookup tool using httpx and a calculator tool that safely evaluates expressions.
Sistema multiagente 
Design a multi-agent system with a triage agent that routes queries to specialist agents. Use handoffs for agent communication.
Guardrails de producción 
Add input and output guardrails to an agent. Validate that user questions are programming-related and that outputs do not contain complete solutions.

أفضل الممارسات

  • Usa siempre patrones async/await con Runner.run() para ejecución escalable de agentes
  • Marca agentes con descripciones de handoff claras para un enrutamiento efectivo en sistemas multiagente
  • Usa modelos Pydantic con output_type para respuestas JSON estructuradas garantizadas
  • Implementa guardrails desde el inicio para validar entradas y evitar salidas no deseadas

تجنب

  • No uses eval() en herramientas de función para evaluar expresiones: usa safe_eval o bibliotecas matemáticas en su lugar
  • No omitas la validación de entrada: siempre valida el contenido del usuario antes de procesarlo
  • No hardcodees claves API: usa variables de entorno para credenciales

الأسئلة المتكررة

¿Cuál es la diferencia entre handoffs y agentes como herramientas?
Los handoffs transfieren el control total de la conversación a otro agente. Los agentes como herramientas permiten que un agente llame a otro como subtarea mientras mantiene el control.
¿Cómo manejo respuestas en streaming en producción?
Usa Runner.run_streamed() e itera sobre stream_events() para entregar deltas en tiempo real para tu respuesta de streaming en FastAPI.
¿Se envían mis datos a OpenAI cuando uso esta habilidad?
Sí, los agentes envían entradas a OpenAI para su procesamiento. Revisa la política de datos de OpenAI para requisitos de cumplimiento antes de desplegar.
¿Puedo usar esto con Claude en lugar de modelos GPT?
Esta habilidad está diseñada para OpenAI Agents SDK. Para agentes de Claude, usa frameworks de agentes específicos de Claude o integraciones de API.
¿Cómo evito que el agente dé soluciones completas?
Usa output_guardrails para escanear respuestas en busca de indicadores de solución y activar un tripwire cuando se detecten.
¿Cuál es la forma más segura de evaluar expresiones matemáticas en herramientas?
Usa la biblioteca math o ast.literal_eval para evaluar expresiones de forma segura. Nunca uses eval() con entradas no confiables.

تفاصيل المطور

المؤلف

Asmayaseen

الترخيص

MIT

المستودع

https://github.com/Asmayaseen/hackathon-2/tree/main/.claude/skills/scaffolding-openai-agents

مرجع

main

بنية الملفات

📁 scripts/

📄 verify.py

📄 SKILL.md