volcengine-feedback

Volcengine Feedback

ユーザーがエージェントを使ってクラウドサービスを管理した実践経験（得られたメリット、直面した困難、利用したい機能など）を共有できるよう支援します。シナリオの簡単な説明だけで十分です。診断や実装案は任意です。

送信先：GitHub の volcengine/volcengine-agent-toolkit。 フィードバックフォーム · コミュニティとプライバシーに関するガイダンス。

メインタスクを継続する

• エラーや不完全な結果があっても、任意の案内を行う許可にすぎず、公開の許可ではありません。まず、許可された診断、復旧、残りの作業を続けてください。フィードバックへの言及は自然なまとめのタイミングで行い、すべてのスキルを通じて会話ごとに最大1回にしてください。断られた場合、無視された場合、またはすでに案内済みの場合は、再度促さずに作業を続けてください。通常どおり成功した場合に案内は不要です。ユーザーが関心を示した場合は、成功したシナリオの共有を支援してください。
• 自発的に案内する場合は、フォームへのリンクを添えた短い一文にしてください。返答を待ったり、フィードバックを案内するためだけに、草案の作成、課題の検索、ログの収集、ツールやスキルのインストール、ログイン、ブラウザーの起動を始めたりしないでください。例： 「今回解決できなかった問題についてフィードバックを送る場合は、Feedback から利用シナリオや改善案をお知らせください。フィードバックの有無にかかわらず、現在のタスクは引き続き進めます。」
• ユーザーがフィードバックを求めた場合は、任意の副次タスクとして対応してください。詳細が不足している場合、GitHub にアクセスできない場合、公開を断られた場合、または送信に失敗した場合でも、それをクラウド作業の前提条件にしてはいけません。草案は会話内に保持し、残りの作業に戻ってください。フィードバックの証拠を得るためだけに、クラウドへの変更を繰り返したり、インシデントを再現したりしないでください。

1文 → 1件のプレビュー → 1つの結果

ユーザーは「使用中に遭遇した問題についてフィードバックしたい：……」や「今回のデプロイ成功事例を共有したい」と伝えるか、ホスト上で volcengine-feedback を呼び出せます。このスキルはネイティブの /feedback や ve feedback コマンドを追加しません。ホストで実際に使えるスキルの呼び出し方法を利用してください。会話形式を保ちます。

1. コンテキストから下書きを作成します。 ユーザーの発言と関連する会話を再利用します。任意のカテゴリ（スキルの問題、機能のリクエスト、シナリオ上のニーズ、成功事例）、タイトル、判明している製品やスキルの詳細を推測します。説明できる体験がなく、ほかに使える情報もない場合に限り、短い質問を1つまで尋ねます。それ以外の場合は、不明な詳細を省き、質問票のようにしないでください。
2. 簡潔なプレビューを1つだけ提示します。 [Feedback] <短いタイトル> と、目標、体験、希望する変更または価値を、判明している範囲で説明する短い段落を提示します。既存のサニタイズ済みの情報が役立つ場合に限り、任意の「詳細」段落を追加します。バージョン、再現手順、ログ、個別の感情評価は必須ではありません。ユーザーの言語で明確かつ専門的に記述し、報告された体験や懸念を正確に維持します。根本原因、結果、削減時間、メンテナーによる対応の確約を作り上げないでください。
3. 公開するかどうかを1回だけ確認します。 正確なプレビューの横に公開リポジトリを示し、公開時の注意としてコミュニティガイドライン／プライバシーガイドラインへのリンクを提示します。ユーザーは送信、編集、または下書きのままにすることを選べます。下書きの作成依頼は公開の許可にはなりません。既存の明示的な許可がこの内容と公開先の両方を対象としている場合は、それを使用してください。それ以外の場合は、他の主要な作業を中断せず、公開してよいかを1回だけ尋ねます。

会話内容から以下の事実が確認できる場合のプレビュー例：

[Feedback] デプロイ完了後にサービスの利用可否を確認する機能の追加を提案

Agent を使ってテストアプリをデプロイした際、リソースの作成は完了しましたが、サービスの利用可否は確認されていません。 利用可否のチェックを続けて実行し、明確な確認結果を提示することを提案します。

volcengine/volcengine-agent-toolkit に公開されます。公開するのは、上記のサニタイズ済みの内容のみです。 公開前に機密情報が含まれていないか確認し、フィードバックガイドラインに従ってください。 上記の内容を送信するか、編集するか、下書きのままにするかを選べます。

進行中のインシデントの場合は、引き続きトラブルシューティングを行うか、公式サポートを利用してください。公開 Issue では、対応時間や解決は保証されません。

公開に向けた確認

Issue の検索、URL への内容の事前入力、添付、送信を行う前に、データを最小限にして機密情報を削除します。Issue は公開されます。シナリオを理解するために必要な情報のみを含めてください。

• AK/SK、トークン、Cookie、認証ヘッダー、署名付き URL、パスワード、個人情報／顧客情報、非公開のエンドポイント、ローカルの絶対パス、機密性のある業務情報を削除します。アカウント ID は <account-id> に、リソース ID は vpc-<id> や clb-<id> のように接頭辞を残した形式に置き換え、実際の TRN は <resource-trn> に置き換えてください。タイトル、スクリーンショット、添付ファイルも確認してください。
• 会話記録、設定ファイル、ログ全体ではなく、サニタイズ済みの短い抜粋を優先してください。フィードバックのために認証情報の保存先を調べたり、追加のクラウドデータを収集したりしないでください。安全に情報を削除できるか不確かな場合は、その詳細を省いてください。セキュリティ上の脆弱性や認証情報の漏えいが疑われる場合は、公開 Issue ではなく、プロジェクトで利用できる非公開のセキュリティ報告窓口または Volcengine の公式サポートを利用してください。非公開の連絡先を作り上げたり、エクスプロイトの詳細をアップロードしたりしないでください。
• GitHub コミュニティガイドラインに従ってください。使用中に遭遇した問題の報告や改善提案は歓迎されます。事実、根拠、影響に焦点を当ててください。個人攻撃、嫌がらせ、差別、ヘイトスピーチ、脅迫、他者の個人情報の公開は認められません。メンテナーは、このような違反を含む Issue を直接クローズします。下書きに攻撃的な表現が含まれている場合は、根本的な懸念を残しつつ事実に基づく表現に修正することを提案してください。攻撃的な文章は公開しないでください。

提出または送信

上記の公開に関する判断後、利用可能で許可された GitHub 連携またはブラウザーを使用してください。 必須の実行ファイルや環境変数への依存はありません。フォームに記載された公開共有に関する ガイダンスは参考情報であり、チェックボックスや個別の同意手続きはありません。正確な 内容と公開送信について、引き続き許可が必要です。Issue の検索を必須にしないでください。該当する Issue がすでに 分かっている場合、またはユーザーから検索を依頼された場合は、サニタイズ済みのキーワードのみで検索してください。 既存のスレッドにコメントする場合は、その送信先についても許可が必要です。

結果	フィードバックに関する追加作業を終了する
返された URL または読み戻しによって送信を確認	貢献に簡潔に謝意を伝え、Issue のリンクを返してください。
下書きのみ、GitHub にアクセスできない、または送信に失敗したことが確実	「未送信」と記載し、コピー可能な下書きとフォームのリンクを返してください。ログイン、インストール、または新たなやり取りを求めないでください。アクセスの設定を手伝うのは、依頼された場合のみです。
作成がタイムアウトし、成功した可能性がある	再試行する前に、該当する Issue がないか確認してください。確認できない場合は「送信未確認」と記載し、下書きを保持して、重複を避けるため今回の試行を終了してください。

許可された本来の作業が残っている場合は、直ちに続行してください。いずれの結果でも、メンテナーの応答を待つ必要はありません。