Saltar a contenido

BotCity Phoenix — Migración de UiPath a Python

BotCity Phoenix es una skill de Claude Code que convierte archivos de workflow UiPath (.xaml + .json) en automatizaciones Python listas para el ecosistema BotCity. Esta guía describe cómo instalar la skill y ejecutar tu primera conversión.

Prerrequisitos

  • Claude Code instalado en la máquina
  • Archivos del proceso UiPath disponibles localmente: el archivo .xaml (workflow) y el archivo .json (generalmente project.json)
  • Python con el BotCity SDK instalado:
pip install botcity-maestro-sdk

Instalar la skill Phoenix

Copia la carpeta de la skill al directorio de skills de Claude Code:

mkdir -p ~/.claude/skills
cp -r ./phoenix-botcity ~/.claude/skills/

Reinicia Claude Code para que la skill sea reconocida.

Consejo

Confirma que la skill fue instalada correctamente: al escribir / en Claude Code, phoenix-botcity debe aparecer en la lista de skills disponibles.

Abrir Claude Code en la carpeta del proyecto

Navega hasta el directorio donde están los archivos .xaml y .json del proceso UiPath:

cd /ruta/a/tu/proyecto-uipath

Abre Claude Code en ese directorio. La skill necesita acceder a los archivos del proyecto para realizar la conversión.

Ejecutar la conversión

En Claude Code, llama a la skill:

/phoenix-botcity

Para pasar contexto adicional — como mantener los nombres de variables originales o convertir un archivo específico —, incluye la instrucción en la llamada:

/phoenix-botcity convertir el ProcesoFacturacion.xaml manteniendo los nombres de variables originales

Para convertir un proyecto completo con múltiples archivos .xaml, apunta a la carpeta raíz e instruye a la skill:

/phoenix-botcity convertir el proyecto completo

Revisar los archivos generados

Después de la ejecución, la skill genera tres archivos en la carpeta del proyecto:

Archivo Contenido
.py Automatización convertida en Python
requirements.txt Dependencias BotCity necesarias
MIGRATION_NOTES.md Puntos que requieren revisión manual

Abre el MIGRATION_NOTES.md antes que cualquier otra cosa. Este lista:

  • Custom activities que se convirtieron en # TODO en el código Python
  • Selectores UiPath que pueden necesitar ajuste manual
  • Credenciales y variables de entorno que necesitan ser reconfiguradas

Atención

BotCity Phoenix es un acelerador de migración, no un conversor automático completo. Revisa el código generado y el MIGRATION_NOTES.md antes de usar la automatización en producción.

Resultado esperado

Al final del proceso, tendrás:

  • Un archivo .py funcional con la automatización convertida al estándar BotCity
  • Un requirements.txt con las librerías necesarias para ejecutar la automatización
  • Un MIGRATION_NOTES.md detallando todo lo que requiere atención humana antes de pasar a producción