mcpField
C
client-feedback

client-feedback

github.com/genericserviceテスト・品質039 回インストール23 週間前に更新
リポジトリ

client-feedback について

クライアントからのフィードバックメールを追跡・調査用のGitHub issueに整理し、丁寧な返信案の作成を支援するエージェントスキルです。Pythonスクリプトがメール取得や解析、添付ファイルの保存を行い、エージェントが分類、検証、修正を進めます。

主な機能

  1. 01送信元ドメインと期間でGmailを検索
  2. 02メール本文の取得と添付ファイルの保存
  3. 03スレッド概要を含むJSONレポートの作成
  4. 04フィードバックをGitHub issueに分類
  5. 05メールスレッドごとの返信案作成

活用シーン

  1. 01特定ドメインからの顧客フィードバック収集
  2. 02個別のフィードバックを別々のissueに整理
  3. 03報告内容の検証とコード上の問題の特定
  4. 04確認用の顧客返信案の準備

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/genericservice/claude-skills --skill client-feedback

インストール後、Claude Code で/client-feedbackを入力して読み込まれたか確認します。

同梱ファイルscripts/process_feedback.py

詳細

クライアントフィードバック処理

クライアントからのフィードバックメールを、追跡、調査、解決済みの GitHub issue に変換し、プロフェッショナルな返信メールを作成します。

このワークフローでは、スクリプトファーストのアプローチを採用しています。決定論的な Python スクリプトがメールの取得と解析という「作業」を処理し、エージェントは問題のトリアージと修正という「判断」を担当します。

使用方法

ユーザーから「フィードバックを処理して」「[domain] からのメールを確認して」「フィードバックを issue にして」と依頼された場合：

  1. 処理スクリプトを実行します：

    python3 ~/.agents/skills/client-feedback/scripts/process_feedback.py \
  --domain "<client-domain>" \
  --days 7 \
  --out "./feedback-batch-$(date +%F)"

  2. レポートを読みます： 生成された report.json と本文全体を含むテキストファイルを読み込み、フィードバックを把握します。

  3. GitHub にトリアージします： レポート内の個別のフィードバックごとに、GitHub issue を作成するか、既存の issue を更新します。

フェーズ 1：受け付け（スクリプト主導）

process_feedback.py スクリプトは、次のタスクを数秒で実行します：

  • 指定されたドメイン／送信者からのメールを Gmail で検索します。
  • メッセージのペイロード全体を取得します。
  • 添付ファイルをローカルディレクトリに自動でダウンロードします。
  • 読みやすいように、プレーンテキストの本文を個別のファイルに抽出します。
  • スレッド、参加者、抜粋をまとめた report.json を生成します。

フェーズ 2：トリアージ — GitHub issue

GitHub issue を主要な作業ボードとして使用します。メールごとではなく、項目ごとに issue を 1 つ作成します。

issue 本文のテンプレート
## Reported by
[Person name] — [date] "[email subject]" (thread [threadId])

## Issue
[Verbatim quote if short, paraphrase if long]

## Status
[Open / awaiting client / in progress]

カテゴリに基づいてラベルを付けます：feedback（常に）、bug、content、design、provider-data、question。

フェーズ 3：調査と修正

実際のコードベースと照らし合わせてフィードバックを検証します。対象を完全に削除または更新できていることを確認するため、全体を grep で検索してください。

フェーズ 4：返信

メールスレッドごとに整理して、プロフェッショナルな返信を作成します。

重要なルール： 送信前に、必ずチャット内に返信本文のドラフトを表示してください。

署名の方針

署名はシンプルでプロフェッショナルなものにします。クライアントとの関係上、明示的に問題がない場合を除き、AI の共同執筆を開示しないでください。

参考：Gmail のマルチパートアップロード

インライン画像（例：修正前／修正後の証拠）を含む返信を作成する必要がある場合は、スクリプトのコメントまたは process_feedback.py のロジックに記載されている gws のマルチパートアップロードフローを使用してください。

コメント

Markdown 対応