効率的な質問の仕方

答えやすい問題で、長くある必要はありませんが、相手に何をしているのか、実際に何が起きたのか、同じ問題をどう確認できるのかが分かるようにしてください。

まずは疑問、再現可能な不具合、機能提案のどれに当たるかを判断し、それに対応する資料を準備してください。

まず適切な入口を選択

あなたの状況	推奨入口
設定の問題か製品の問題か分からない	【設定】→【私たちについて】→【フィードバック】→【Agent を使って送信】
再現可能な不具合であることを確認済み	GitHub Bug Report
新しい機能を追加してほしい	GitHub Feature Request
使い方や案について議論したい	GitHub Discussion / Questions
操作手順だけ確認したい	現在のドキュメントと Cherry Assistant

Cherry Assistant は現在のインストールパッケージ情報を読み取り、あなたの同意後に必要な診断情報を収集できます。まず匿名化したプレビューを表示してから、フィードバックを送信するか診断パッケージを生成します。事前にログの見方を覚えておく必要はありません。

問題には何を含めるべきか

1

1. 目的を一文で説明する

例：「Agent に平日の朝、日報を Feishu のグループに送ってほしい。」

2

2. 実際の結果と期待する結果を書く

実際の結果：「タスクの実行は成功したが、Feishu にはメッセージが届かなかった。」期待する結果：「実行完了後、指定したグループに日報が 1 件届く。」

3

3. 最短の再現手順を示す

問題が安定して発生する入口から始め、3〜6 ステップでクリックの流れ、選択した内容、エラーが発生した場所を明確に書いてください。

4

4. 環境を補足する

OS、【設定】→【私たちについて】に表示されているバージョン、関連するサービス提供者またはチャンネルの種類を記載してください。API Key やアカウント認証情報は公開しないでください。

5

5. スクリーンショット、録画、ログを追加する

スクリーンショットにはエラーとその画面を含めてください。ログは関連する時間帯だけを切り出し、先に匿名化してください。モデル出力の問題では、入力、モデル、期待する形式を添付してください。

そのまま使えるテンプレート

タイトル：Agent の定時タスクは成功したが、Feishu チャンネルに結果が届かない

目的：平日 09:00 に運営日報を指定した Feishu グループへ送信する。
実際の結果：実行履歴では成功と表示されるが、Feishu にはメッセージがない。
期待する結果：グループ内に日報メッセージが 1 件届く。

再現手順：
1.【設定】→【定時タスク】を開く。
2. 日報タスクを選択して【実行】をクリックする。
3. タスク完了まで待つ。
4. Feishu グループを確認すると、新しいメッセージはない。

環境：macOS / Cherry Studio の【私たちについて】に表示されているバージョン / Feishu チャンネル。
試したこと：チャンネルを再有効化した；Feishu でボットにテストメッセージを送信した。
添付：認証情報を隠したチャンネル状態のスクリーンショット、対応する実行記録。

スクリーンショットとログで削除すべきもの

送信前に API Key、Authorization、Cookie、ボット Token、App Secret、メールアドレス、完全なローカルパス、チャット内容、業務データを削除してください。秘密情報が公開された場合は、すぐにサービス提供者またはプラットフォームで失効させてください。

調査を速くするためのちょっとした習慣

• 一度に再現するのは 1 つの問題だけにする；
• 問題が出る最小構成を使う；
• 問題が安定して発生するかを説明する；
• 「使えない」だけでなく、エラーの原文を添える；
• 問題と関係のないログ全体はアップロードしない；
• 同じ Issue を見つけたら、環境情報と新しい手がかりを補足し、重複作成はしない。

Cherry Assistant にそのまま代わりに送信してもらえますか？

はい。【フィードバック】から Cherry Assistant に入り、問題を説明したうえで、送信してほしいと明確に伝えてください。診断データの権限を求め、匿名化プレビューを表示したうえで、あなたが選んだ方法で処理します。GitHub を明示的に要求した場合にのみ GitHub Issue として送信されます。