TinyFish に関する構造化されたフィードバック（バグ報告、セットアップ手順の不明な点、機能リクエスト、医療診断レポートなど）を記録できます。 ユーザーの承認を得た上で、GitHub（ソースコード共有プラットフォーム）の tinyfish-io/tinyfish-cookbook リポジトリに Issue（課題報告）を作成します。プレビューで内容を確認して明示的に許可するまで、何も送信されません。
File structured feedback about TinyFish — bug reports, confusing setup steps, missing features, or a doctor diagnostic report. Creates a GitHub issue on tinyfish-io/tinyfish-cookbook with the user's approval; nothing is sent without an explicit preview.
ユーザーからのフィードバックを集めて整理し、内容を確認してから送信します。ユーザーが実際のテキストを確認するまで、何も外部に送られません。
以下の3点を簡潔に質問します：
セットアップ、認証、接続に関する問題の場合は、npx -y @tiny-fish/cli@latest doctor を実行して、その JSON 出力をそのまま添付することを勧めます。この出力はスキーマ（データ形式の定義）が管理されており、すでに個人情報の削除が安全に行われています（不要な情報は自動削除、メッセージは編集済み）。項目を追加したり、内容を要約したり、設定内容をコピーペーストしてはいけません。終了コード 2 が返った場合は、JSON が生成されなかったことを知らせ、空のレポートは添付しないでください。
### 実行しようとしていたこと
…
### 実際に起きたこと
…
### 本来の期待
…
### 環境情報
使用ツール名とバージョン、CLI バージョン（わかれば）
### Doctor レポート（任意）
`tinyfish doctor` の出力（そのまま）
完全なフィードバック本文をユーザーに見せて、送信前に明示的な同意を求めます。ユーザーが変更を希望すれば、送信前に対応します。
推奨方法：本文とタイトルをファイルに書き込み、以下のコマンドを実行します：
gh issue create --repo tinyfish-io/tinyfish-cookbook --title "$(cat "$title_file")" --body-file "$body_file"
（gh コマンドがインストールされ、認証済みの場合のみ）
本文とタイトルはユーザーの自由形式テキストから取得するため、シェル（コマンド実行環境）に直接渡されてはいけません。title=… のような変数代入形式でも、バッククォートや $(…) は実行されます。cat の出力は再解析されません。コマンドを文字列で組み立てたり eval を通して実行してはいけません。
代替方法：あらかじめ入力された問題作成用 URL を開きます：
https://github.com/tinyfish-io/tinyfish-cookbook/issues/new?title=…&body=…
両方の値をパーセントエンコード（URL 安全な文字列形式）にしてください。エンコードされていない # は本文を切り詰め、& は無効なパラメータに分割されます。URL の長さ制限によって本文が切り詰められた場合は、ユーザーに知らせ、全文を表示して残りをコピーペーストできるようにしてください。
このリポジトリは公開されています。ユーザーが自由形式で入力したテキストが含まれている場合は、確認画面でその旨を思い出させてください。
Collect the user's feedback, structure it, preview it, then file it. Nothing leaves the machine without the user seeing the exact text first.
Ask (briefly) for: what they were trying to do, what happened instead, and
what they expected. For anything setup-, auth-, or connectivity-shaped, run
npx -y @tiny-fish/cli@latest doctor and offer to attach its stdout JSON
verbatim — it is schema-versioned and already redaction-safe (undeclared
fields stripped on parse, messages authored rather than raw). Do not add
fields, summarise it, or paste config contents alongside it. On exit 2
doctor produced no JSON — say so instead of attaching an empty report.
### What I was doing
…
### What happened
…
### Expected
…
### Environment
harness + version, CLI version (if known)
### Doctor report (optional)
`tinyfish doctor` stdout, verbatim
Show the complete issue body to the user and ask for an explicit yes before filing. Any edit they request happens before filing.
gh issue create --repo tinyfish-io/tinyfish-cookbook --title "$(cat "$title_file")" --body-file "$body_file" (only if gh is installed and authenticated).
Both values come from the user's free-form text (the body also carries
doctor's JSON), so neither may reach the shell as literal text — including
in a title=… assignment, where backticks or $(…) are evaluated just the
same. cat's output is not re-parsed. Never build the command as a string
or run it through eval.https://github.com/tinyfish-io/tinyfish-cookbook/issues/new?title=…&body=…).
Percent-encode both values — an unencoded # truncates the body and &
splits it into junk parameters. URL length limits truncate long bodies
anyway — if the body was truncated, tell the user and show the full text
so they can paste the remainder.This repo is public — remind the user of that in the preview if the report contains anything they typed free-form.
原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。