Communitygithub.com

SEKAI-SEEK/wechat-starter

Una habilidad para agentes diseñada para principiantes que permite crear Mini Programas y Mini Juegos nativos de WeChat desde cero hasta la vista previa en DevTools.

¿Qué es wechat-starter?

WeChat Starter es una habilidad para agentes de IA (como Claude Code, Cursor o Codex) que guía a desarrolladores primerizos en la creación de Mini Programas y Mini Juegos nativos de WeChat, desde una idea hasta una vista previa funcional en WeChat DevTools. Su objetivo es reducir la fricción inicial proporcionando un flujo de trabajo estructurado en siete etapas, con énfasis en la enseñanza paso a paso, la verificación constante y la recuperación ante errores. La habilidad prioriza el modo principiante, con explicaciones claras y sin jerga, pero permite cambiar al modo desarrollador si el usuario demuestra experiencia. Además, incluye reglas de seguridad estrictas para proteger credenciales, activos con licencia y el trabajo existente del usuario. Es compatible con Mini Programas y Mini Juegos nativos (WXML/WXSS/JavaScript o Canvas 2D), con soporte opcional para frameworks y CloudBase solo cuando se solicita explícitamente.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add SEKAI-SEEK/wechat-starter

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

WeChat Starter

Lleva a un desarrollador principiante desde una idea hasta una vista previa funcional en WeChat DevTools. Deja que el usuario controle cuándo comienza cada etapa; completa la etapa autorizada de principio a fin antes de esperar la siguiente instrucción.

Contrato de Operación

Por defecto, usa el modo Principiante. Cambia al modo Desarrollador solo cuando el usuario solicite menos explicación o demuestre que ya conoce los conceptos básicos de informática, Git y JavaScript.

Para cada etapa, sigue este ciclo:

  1. Enseñar: Explica el objetivo inmediato y define cada término nuevo en una oración sencilla.
  2. Hacer: Realiza el trabajo de código y sistema de archivos que se pueda completar de forma segura; proporciona un pequeño grupo de acciones para pasos que solo el usuario puede hacer en DevTools o en su cuenta.
  3. Verificar: Indica el resultado visible exacto, la salida del comando o el comportamiento que demuestra el éxito.
  4. Recuperar: Si la verificación falla, diagnostica una causa basada en evidencia a la vez y vuelve a intentar.
  5. Registrar: Actualiza el progreso de la etapa y crea un punto de control local de Git cuando se alcanza el hito.

No hagas más de tres preguntas esenciales en una ronda. Nunca vuelques un tutorial completo antes de que el usuario llegue al paso relevante.

Adáptate al idioma del usuario. Cuando el usuario escriba en chino, enseña en chino simplificado conciso y muestra el término técnico en inglés solo la primera vez que ayude al reconocimiento. El modo Desarrollador puede reducir la explicación, pero no debe debilitar la seguridad ni los hitos de aceptación.

Reglas de Seguridad

  • Inspecciona AGENTS.md, el estado del repositorio, los archivos existentes y las instrucciones actuales antes de editar.
  • Nunca sobrescribas, reviertas, elimines ni confirmes trabajo del usuario no relacionado.
  • Nunca expongas ni confirmes claves de API, valores de AppSecret, contraseñas, tokens, certificados privados, credenciales de CloudBase, materiales privados o imágenes sin licencia.
  • Usa marcadores de posición explícitos como <WECHAT_APP_ID> y <CLOUDBASE_ENV_ID> en ejemplos reutilizables.
  • En el proyecto local del usuario, permite que los identificadores de AppID y entorno necesarios se configuren de forma privada. No le pidas al usuario que los pegue en el chat, los muestre en la salida pública ni los copie en este repositorio de la habilidad.
  • Trata project.private.config.json, .env*, claves privadas, datos de cuenta local y capturas de pantalla que contengan identificadores como privados por defecto. AppSecret y las credenciales del servidor nunca deben entrar en el código frontend del Mini Programa o Mini Juego.
  • Usa solo activos propiedad del usuario, con licencia clara, de dominio público o generados recientemente. Registra la procedencia cuando un activo pueda publicarse más adelante.
  • Solicita confirmación antes de iniciar sesión en la cuenta, conceder permisos, tomar decisiones de privacidad, hacer cambios destructivos o realizar cualquier acción fuera del proyecto actual.
  • Mantén Git local. No hagas push, crees pull requests, publiques versiones, envíes a WeChat ni entres en el flujo de revisión de la plataforma.

Lee references/security.md antes de agregar credenciales, servicios en la nube, activos externos o datos del usuario.

Condiciones de Bloqueo

Detén la etapa actual y explica la siguiente acción única cuando:

  • El directorio de destino es desconocido, está fuera del espacio de trabajo aprobado o contiene trabajo no relacionado que no se puede separar de forma segura.
  • El usuario no ha aprobado el resumen de la primera vista previa.
  • La vista previa final requiere un AppID o inicio de sesión en DevTools que el usuario no ha completado.
  • La funcionalidad solicitada requiere un secreto en el código frontend, un activo sin licencia, recopilación de datos personales no revelada o una acción destructiva sin confirmación.
  • Un error de compilación, tiempo de ejecución, recurso o interacción permanece sin resolver en el hito actual.

No evites un bloqueador con credenciales inventadas, una afirmación de éxito falsa o una captura de pantalla promocional.

Elige la Ruta

Elige exactamente una ruta principal después de recibir los requisitos:

Usa un framework solo cuando el usuario lo solicite explícitamente o un repositorio existente ya dependa de él. Habilita CloudBase solo cuando los requisitos aceptados necesiten datos remotos, funciones en la nube, almacenamiento, autenticación o servicios de IA; luego lee references/cloudbase.md.

Muestra el Progreso de la Etapa

Muestra este estado compacto una vez por respuesta, preferiblemente al principio cuando la etapa cambia y al final en caso contrario:

WeChat Starter | <Principiante|Desarrollador> | <Mini Programa|Mini Juego>
Etapa <0-6>: <nombre de la etapa>
Estado: <esperando|trabajando|bloqueado|superado>
Próximo hito: <un resultado observable>

Crea una carpeta codex_showcase/ en el nuevo proyecto de destino a partir de las plantillas en assets/templates/. Mantenla limitada al resumen del proyecto, el progreso de la etapa, la evidencia y la lista de verificación de la vista previa.

Etapa 0: Preparar el Entorno

Lee references/beginner-onboarding.md. Verifica:

  • Cuenta de WeChat y la ruta de registro correcta para Mini Programa o Mini Juego.
  • Disponibilidad del AppID sin pedir al usuario que pegue credenciales privadas en el chat.
  • Instalación e inicio de sesión en WeChat DevTools.
  • Un directorio de proyecto dedicado con una ruta absoluta segura.
  • Disponibilidad de Git y si el directorio ya es un repositorio.

Proporciona las acciones que solo el usuario puede hacer en un grupo a la vez. Supera este hito solo cuando DevTools se abra y el espacio de trabajo local sea conocido.

No escribas un AppID inventado en un proyecto reutilizable. Si DevTools admite un modo de prueba documentado actual, explica sus límites; de lo contrario, deja que el usuario seleccione su propio AppID local dentro de DevTools.

Etapa 1: Definir la Primera Versión

Acepta una idea de una oración. Pregunta solo lo necesario para decidir:

  • Mini Programa o Mini Juego.
  • Usuario objetivo y un resultado principal o bucle de juego.
  • Si los datos solo locales son suficientes para la primera vista previa.

Divide los requisitos en Primera vista previa y Posterior. Rechaza el alcance que impida un primer bucle ejecutable. Completa codex_showcase/project-brief.md y espera la confirmación explícita del usuario antes de la implementación.

Supera este hito cuando el usuario apruebe un resumen con un flujo principal y una lista clara de lo que queda fuera del alcance.

Etapa 2: Andamiar y Compilar

Inspecciona el espacio de trabajo antes de crear archivos. Construye el esqueleto nativo más pequeño para la ruta seleccionada. Mantén los identificadores de cuenta reales en la configuración local/privada cuando sea posible y nunca coloques secretos en el código fuente.

Abre o importa el proyecto en WeChat DevTools. Resuelve los errores de configuración, punto de entrada, ruta y sintaxis antes de agregar funcionalidades.

Crea el punto de control local de Git scaffold solo después de la primera compilación limpia.

Etapa 3: Construir la Funcionalidad Vertical

Implementa un recorrido de usuario completo antes de expandir la amplitud:

  • Ejemplo de Mini Programa: abrir página -> ingresar o seleccionar datos -> desencadenar acción -> ver resultado persistido o calculado.
  • Ejemplo de Mini Juego: entrar en escena -> realizar la interacción principal -> recibir retroalimentación -> alcanzar un resultado o estado de reinicio.

Mantén la interfaz de usuario funcional y legible. Evita construir páginas secundarias, animaciones elaboradas, sistemas sociales, monetización o infraestructura en la nube antes de que este bucle funcione.

Crea el punto de control local de Git vertical-slice solo después de que el usuario pueda operar el bucle en DevTools.

Etapa 4: Completar las Funcionalidades Aceptadas

Implementa solo las funcionalidades aprobadas para la primera vista previa. Agrega estado, almacenamiento, audio, activos, acceso a la red y CloudBase de forma incremental. Después de cada adición, vuelve a ejecutar el flujo principal y explica solo el concepto introducido por ese cambio.

Mantén la representación, la entrada y los cálculos de estado alineados. Para proyectos con Canvas, verifica juntos la relación de píxeles del dispositivo, las coordenadas de diseño, las áreas seguras y las regiones táctiles.

Etapa 5: Robustecer la Vista Previa

Lee references/preview-gates.md. Verifica como mínimo:

  • Compilación limpia y sin errores de consola sin resolver.
  • Puntos de entrada, configuración, rutas y rutas de recursos.
  • Interacción principal, estados vacío/carga/error, comportamiento de reinicio o recuperación.
  • Adaptación de pantalla y objetivos táctiles en tamaños de simulador representativos.
  • Comportamiento de almacenamiento local y fallo de CloudBase cuando se usen.
  • Ciclo de vida del audio y carga de activos cuando se usen.
  • Presupuesto de paquete/recursos y exclusión accidental de archivos privados o solo de fuente.
  • Sin puertas traseras de depuración, contraseñas de prueba, secretos o materiales privados en el código fuente de la vista previa.

No equipares una verificación automatizada en verde con una vista previa exitosa. Se requiere evidencia visual y de interacción.

Etapa 6: Aceptar la Vista Previa en DevTools

Guía al usuario a través de una ejecución final de vista previa. Requiere todo lo siguiente:

  1. DevTools compila sin errores.
  2. El flujo principal es operable de principio a fin.
  3. Las comprobaciones de configuración, recurso y paquete requeridas pasan.
  4. Una captura de pantalla u observación concisa registra el resultado de la vista previa.
  5. El usuario confirma explícitamente la aceptación.

Actualiza codex_showcase/preview-checklist.md y crea el punto de control local de Git preview-ready. Detente aquí. No continúes con la carga, el envío, la revisión o el lanzamiento.

Diagnosticar Capturas de Pantalla y Errores

Lee references/troubleshooting.md cada vez que el usuario comparta una captura de pantalla, salida de consola, error de compilación, pantalla en blanco, activo faltante o interacción incorrecta.

Recopila la evidencia útil más pequeña:

  • Etapa y ruta actuales.
  • Texto de error exacto, no solo una paráfrasis.
  • Captura de pantalla con identificadores privados redactados cuando sea posible.
  • Archivo relevante y la última acción antes del fallo.

Clasifica el problema como de entorno, configuración, código, recurso, tiempo de ejecución, diseño/entrada, nube o permisos. Formula una hipótesis comprobable, haz el cambio seguro más pequeño y repite el paso de verificación fallido.

Mapa de Referencias

Skills relacionados