Communitygithub.com

カスタマー請求業務

Stripeなどの接続された請求ツールを使用して、サブスクリプション、返金、解約トリアージ、請求ポータルの復旧、プラン分析などの顧客請求ワークフローを運用します。顧客対応、サブスクリプション状態の確認、収益に影響する請求業務の管理が必要な場合に使用します。

カスタマー請求業務 とは?

このスキルは、AIエージェント(例:Claude Code、Cursor、Codex)が、実際の顧客請求業務を安全かつ効率的に遂行するためのものです。主にStripeなどの請求APIと連携し、サブスクリプションの重複確認、返金処理、解約トリアージ、請求ポータルの復旧、プラン分析などを実行します。ユーザーが「顧客の請求が壊れている」「返金したい」「解約できない」といった事象に直面した際に、エージェントが問題を分類し、最も安全で可逆性の高い対応を優先的に提案します。また、返金やキャンセルなどの操作に入る前に、顧客の身元確認、問題の分類(重複購入、チームプラン、決済失敗など)、そして段階的な修復ワークフローを実行します。最終的には、顧客の状態、実施したアクション、収益影響、フォローアップ文面、製品改善の提案を含む、運用担当者への明確なハンドオフ情報を生成します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/everything-claude-code/tree/main/skills/customer-billing-ops

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

カスタマー請求業務 は何をしますか?

このスキルは、一般的な決済API設計ではなく、実際の顧客業務のために使用します。

目的は、運用担当者が「この顧客は誰か、何が起こったか、最も安全な修正方法は何か、どのようなフォローアップを送るべきか」を答えられるようにすることです。

使用するタイミング

  • 顧客が請求が壊れている、返金を希望する、または解約できないと申し出た場合
  • 重複サブスクリプション、誤請求、更新失敗、解約リスクを調査する場合
  • プランミックス、アクティブなサブスクリプション、年払いと月払いの変換、チームシートの混乱を確認する場合
  • 請求ポータルのフローを作成または検証する場合
  • サブスクリプション、請求書、返金、または支払い方法に関連するサポート苦情を監査する場合

推奨ツール

  • まずStripeなどの接続された請求ツールを使用する
  • メール、GitHub、または課題トラッカーは補足的な証拠としてのみ使用する
  • プラットフォームが既に必要なコントロールを提供している場合は、カスタムアカウント管理コードよりもホスト型の請求/顧客ポータルを優先する

ガードレール

  • 応答に秘密鍵、完全なカード詳細、または不要な顧客PIIを決して公開しない
  • 盲目的に返金せず、まず問題を分類する
  • 以下を区別する:
    • 偶発的な重複購入
    • 意図的なマルチシートまたはチーム購入
    • 製品の欠陥または価値の不足
    • 失敗または不完全なチェックアウト
    • セルフサービス管理機能の欠如による解約
  • 年払いプラン、チームプラン、および按分状態については、アクションを起こす前に契約内容を確認する

ワークフロー

1. 顧客を明確に特定する

利用可能な最も強力な識別子から開始する:

  • 顧客のメールアドレス
  • Stripeの顧客ID
  • サブスクリプションID
  • 請求書ID
  • 請求にマッピングできることがわかっているGitHubユーザー名またはサポートメール

簡潔な身元情報を返す:

  • 顧客
  • アクティブなサブスクリプション
  • 解約済みサブスクリプション
  • 請求書
  • 重複するアクティブサブスクリプションなどの明らかな異常

2. 問題を分類する

アクションを起こす前に、ケースを1つのカテゴリに分類する:

ケース典型的なアクション
個人サブスクリプションの重複追加分を解約、返金を検討
本当のマルチシート/チーム意図シートを維持、請求モデルを明確化
支払い失敗/不完全なチェックアウトポータル経由で復旧、または支払い方法を更新
セルフサービス管理機能の欠如ポータル、解約パス、または請求書へのアクセスを提供
製品の欠陥または信頼の喪失返金、謝罪、製品問題を記録

3. 最初に最も安全で可逆性の高いアクションを実行する

優先順位:

  1. セルフサービス管理を復元する
  2. 重複または壊れた請求状態を修正する
  3. 影響を受けた請求または重複のみを返金する
  4. 理由を文書化する
  5. 短い顧客フォローアップを送信する

修正に製品作業が必要な場合は、以下を分離する:

  • 今すぐの顧客是正
  • バックログ用の製品バグ/ワークフローギャップ

4. 運用担当者側の製品ギャップを確認する

顧客の苦痛が運用担当者向けの機能不足に起因する場合、それを明示的に指摘する。一般的な例:

  • 請求ポータルがない
  • 使用量/レート制限の可視性がない
  • プラン/シートの説明がない
  • 解約フローがない
  • 重複サブスクリプション防止策がない

これらを単なるサポートインシデントとしてではなく、ECCまたはWebサイトのフォローアップ項目として扱う。

5. 運用担当者へのハンドオフを作成する

以下で締めくくる:

  • 顧客の状態の要約
  • 実行したアクション
  • 収益への影響
  • 送信するフォローアップテキスト
  • 作成する製品またはバックログの課題

出力形式

以下の構造を使用する:

顧客
- 名前 / メール
- 関連するアカウント識別子

請求状態
- アクティブなサブスクリプション
- 請求書または更新状態
- 異常

判断
- 問題の分類
- このアクションが正しい理由

実行したアクション
- 返金 / 解約 / ポータル / 何もしない

フォローアップ
- 短い顧客メッセージ

製品ギャップ
- 製品またはWebサイトで修正すべき点

適切な推奨の例

  • 「正しい修正方法は請求ポータルであり、まだカスタムダッシュボードではありません」
  • 「これは実際のチームシート購入ではなく、個人の重複チェックアウトのように見えます」
  • 「1つの重複請求を返金し、残りのアクティブサブスクリプションを維持して、後で必要に応じて顧客を組織請求に変換します」

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/claude-api

Anthropic Claude API patterns for Python and TypeScript. Covers Messages API, streaming, tool use, vision, extended thinking, batches, prompt caching, and Claude Agent SDK. Use when building applications with the Claude API or Anthropic SDKs.

affaan-m/everything-claude-code

End-to-end marketing campaign planning and execution. Covers audience research, positioning, campaign angle definition, landing page copy, email sequences, social posts, ad copy, short-form video scripts, and content calendars. Use as the orchestration layer for multi-channel product launches. Use when planning or executing a multi-channel product launch, or producing landing page, email, social, or ad copy.

affaan-m/everything-claude-code

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/everything-claude-code-conventions

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use when the user asks to build web components, pages, or applications and the visual direction matters as much as the code quality.

affaan-m/gget

gget CLI and Python workflow for quick genomic database queries, sequence lookup, BLAST-style searches, enrichment checks, and reproducible bioinformatics evidence logs.

affaan-m/literature-review

Systematic literature-review workflow for academic, biomedical, technical, and scientific topics, including search planning, source screening, synthesis, citation checks, and evidence logging.

affaan-m/motion-ui

Production-ready UI motion system for React/Next.js. Use when implementing animations, transitions, or motion patterns.

affaan-m/project-guidelines-example

Example project-specific skill template based on a real production application.

affaan-m/pubmed-database

Direct PubMed and NCBI E-utilities search workflows for biomedical literature, MeSH queries, PMID lookup, citation retrieval, and API-backed literature monitoring.

affaan-m/scholar-evaluation

Structured scholarly-work evaluation for papers, proposals, literature reviews, methods sections, evidence quality, citation support, and research-writing feedback.

affaan-m/uspto-database

USPTO patent and trademark data workflow for official record lookup, PatentSearch queries, TSDR checks, assignment data, and reproducible IP research logs.

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.

関連スキル