Communitygithub.com

Operaciones de Facturación de Clientes

Gestiona flujos de trabajo de facturación de clientes como suscripciones, reembolsos, triaje de bajas, recuperación de portales de facturación y análisis de planes utilizando herramientas conectadas como Stripe. Úsalo cuando el usuario necesite ayudar a un cliente, inspeccionar el estado de una suscripción o gestionar operaciones de facturación que afectan los ingresos.

¿Qué es Operaciones de Facturación de Clientes?

Esta habilidad está diseñada para que los operadores realicen operaciones reales de facturación de clientes, no para el diseño genérico de API de pago. Su objetivo principal es ayudar al operador a responder preguntas clave: quién es el cliente, qué sucedió, cuál es la solución más segura y qué seguimiento se debe enviar. Es compatible con herramientas de facturación conectadas como Stripe, y se recomienda usarla como primera opción, utilizando el correo electrónico, GitHub o los rastreadores de problemas solo como evidencia de respaldo. La habilidad proporciona un flujo de trabajo estructurado de cinco pasos: identificación limpia del cliente, clasificación del problema (por ejemplo, duplicado accidental, compra deliberada multi-asiento, fallo del producto), toma de la acción reversible más segura (priorizando restaurar la autogestión, luego corregir estados duplicados o rotos, y finalmente reembolsar), verificación de brechas de producto del lado del operador, y producción de un resumen de transferencia para el operador. Incluye salvaguardas importantes como no exponer claves secretas ni datos personales innecesarios, no reembolsar a ciegas, y verificar la forma del contrato para planes anuales o de equipo antes de actuar. El formato de salida estructurado incluye un resumen del cliente, el estado de facturación, la decisión tomada, la acción realizada, el mensaje de seguimiento y las brechas de producto identificadas.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/ECC/tree/main/skills/customer-billing-ops

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Operaciones de Facturación de Clientes?

Usa esta habilidad para operaciones reales con clientes, no para diseño genérico de API de pago.

El objetivo es ayudar al operador a responder: quién es este cliente, qué sucedió, cuál es la solución más segura y qué seguimiento debemos enviar.

Cuándo Usarla

  • El cliente dice que la facturación está rota, quiere un reembolso o no puede cancelar
  • Investigar suscripciones duplicadas, cargos accidentales, renovaciones fallidas o riesgo de baja
  • Revisar la combinación de planes, suscripciones activas, conversión anual vs. mensual, o confusión con asientos de equipo
  • Crear o validar un flujo de portal de facturación
  • Auditar quejas de soporte que toquen suscripciones, facturas, reembolsos o métodos de pago

Superficie de Herramienta Preferida

  • Usa primero herramientas de facturación conectadas como Stripe
  • Usa correo electrónico, GitHub o rastreadores de problemas solo como evidencia de respaldo
  • Prefiere portales de facturación/cliente alojados sobre código personalizado de gestión de cuentas cuando la plataforma ya proporciona los controles necesarios

Salvaguardas

  • Nunca expongas claves secretas, detalles completos de tarjetas ni PII innecesaria del cliente en la respuesta
  • No reembolses a ciegas; primero clasifica el problema
  • Distingue entre:
    • compra duplicada accidental
    • compra deliberada multi-asiento o de equipo
    • producto defectuoso / valor no cumplido
    • pago fallido o proceso de compra incompleto
    • cancelación por falta de controles de autogestión
  • Para planes anuales, planes de equipo y estados prorrateados, verifica la forma del contrato antes de actuar

Flujo de Trabajo

1. Identifica al cliente limpiamente

Comienza desde el identificador más sólido disponible:

  • correo electrónico del cliente
  • ID de cliente de Stripe
  • ID de suscripción
  • ID de factura
  • nombre de usuario de GitHub o correo electrónico de soporte si se sabe que se asigna a la facturación

Devuelve un resumen de identidad conciso:

  • cliente
  • suscripciones activas
  • suscripciones canceladas
  • facturas
  • anomalías obvias como suscripciones activas duplicadas

2. Clasifica el problema

Clasifica el caso en un solo grupo antes de actuar:

CasoAcción típica
Suscripción personal duplicadacancelar las extras, considerar reembolso
Intención real multi-asiento/equipopreservar asientos, aclarar el modelo de facturación
Pago fallido / proceso de compra incompletorecuperar mediante portal o actualizar método de pago
Falta de controles de autogestiónproporcionar portal, ruta de cancelación o acceso a facturas
Falla del producto o quiebre de confianzareembolsar, disculparse, registrar el problema del producto

3. Toma la acción reversible más segura primero

Orden preferido:

  1. restaurar la gestión de autogestión
  2. corregir el estado de facturación duplicado o roto
  3. reembolsar solo el cargo afectado o duplicado
  4. documentar la razón
  5. enviar un breve seguimiento al cliente

Si la corrección requiere trabajo de producto, separa:

  • remediación del cliente ahora
  • error de producto / brecha en el flujo de trabajo para el backlog

4. Verifica las brechas de producto del lado del operador

Si el dolor del cliente proviene de la falta de una superficie de operador, menciónalo explícitamente. Ejemplos comunes:

  • sin portal de facturación
  • sin visibilidad de uso/límite de tasa
  • sin explicación del plan/asiento
  • sin flujo de cancelación
  • sin protección contra suscripciones duplicadas

Trátalos como elementos de seguimiento para ECC o sitio web, no solo como incidentes de soporte.

5. Produce la transferencia para el operador

Termina con:

  • resumen del estado del cliente
  • acción realizada
  • impacto en ingresos
  • texto de seguimiento para enviar
  • problema de producto o backlog para crear

Formato de Salida

Usa esta estructura:

CLIENTE
- nombre / correo electrónico
- identificadores de cuenta relevantes

ESTADO DE FACTURACIÓN
- suscripciones activas
- estado de factura o renovación
- anomalías

DECISIÓN
- clasificación del problema
- por qué esta acción es correcta

ACCIÓN REALIZADA
- reembolso / cancelación / portal / sin operación

SEGUIMIENTO
- mensaje breve al cliente

BRECHA DE PRODUCTO
- qué debería solucionarse en el producto o sitio web

Ejemplos de Buenas Recomendaciones

  • "La solución correcta es un portal de facturación, no un panel personalizado todavía"
  • "Esto parece un proceso de compra personal duplicado, no una compra real de asientos de equipo"
  • "Reembolsa un cargo duplicado, mantén la suscripción activa restante, luego convierte al cliente a facturación de organización más tarde si es necesario"

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/content-engine

Create platform-native content systems for X, LinkedIn, TikTok, YouTube, newsletters, and repurposed multi-platform campaigns. Use when the user wants social posts, threads, scripts, content calendars, or one source asset adapted cleanly across platforms.

affaan-m/ECC

Multi-platform content distribution across X, LinkedIn, Threads, and Bluesky. Adapts content per platform using content-engine patterns. Never posts identical content cross-platform. Use when the user wants to distribute content across social platforms.

affaan-m/fal-ai-media

Unified media generation via fal.ai MCP — image, video, and audio. Covers text-to-image (Nano Banana), text/image-to-video (Seedance, Kling, Veo 3), text-to-speech (CSM-1B), and video-to-audio (ThinkSound). Use when the user wants to generate images, videos, or audio with AI.

affaan-m/manim-video

日本語翻訳:このファイルは manim-video 用の日本語翻訳が必要です

affaan-m/remotion-video-creation

Remotion のベストプラクティス - React で動画を作成する。3D、アニメーション、音声、字幕、チャート、トランジションなどをカバーするドメイン固有の29のルール。

affaan-m/video-editing

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

agent-self-evaluation

Use after completing any non-trivial task. The agent self-rates its output on 5 axes — accuracy, completeness, clarity, actionability, conciseness — with concrete evidence per criterion. Produces a structured 1-5 scorecard with specific improvement suggestions.

agent-sort

Build an evidence-backed ECC install plan for a specific repo by sorting skills, commands, rules, hooks, and extras into DAILY vs LIBRARY buckets using parallel repo-aware review passes. Use when ECC should be trimmed to what a project actually needs instead of loading the full bundle.

ai-first-engineering

Engineering operating model for teams where AI agents generate a large share of implementation output. Use when setting team process, review gates, or ownership rules for a codebase largely written by agents.

ai-regression-testing

Regression testing strategies for AI-assisted development. Sandbox-mode API testing without database dependencies, automated bug-check workflows, and patterns to catch AI blind spots where the same model writes and reviews code. Use when adding regression coverage to AI-assisted code, or when the same model both wrote and reviewed a change.

android-clean-architecture

Clean Architecture patterns for Android and Kotlin Multiplatform projects — module structure, dependency rules, UseCases, Repositories, and data layer patterns. Use when structuring modules, layers, or data flow in an Android or KMP project.

angular-developer

Generates Angular code and provides architectural guidance. Trigger when creating projects, components, or services, or for best practices on reactivity (signals, linkedSignal, resource), forms, dependency injection, routing, SSR, accessibility (ARIA), animations, styling (component styles, Tailwind CSS), testing, or CLI tooling.

Skills relacionados