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形式)をそのまま添付することを提案してください。このJSONはスキーマバージョン管理済みで、既に個人情報削除処理が施されています(未申告フィールドは解析時に削除され、生のテキストではなく適切なメッセージが含まれます)。フィールドを追加したり、要約したり、設定内容を一緒に貼り付けたりしないでください。終了コード2の場合、doctorがJSONを生成できなかったことを示すため、空のレポートの代わりにそう記載してください。
### やっていたこと
…
### 起こったこと
…
### 期待していたこと
…
### 環境
ハーネス+バージョン、CLIバージョン(わかる場合)
### Doctor レポート(オプション)
`tinyfish doctor` の出力(そのまま)
完全なレポート本文をユーザーに表示し、登録する前に明確な承認を得てください。ユーザーが編集を要求した場合は、登録前に対応してください。
推奨方法:
gh issue create --repo tinyfish-io/tinyfish-cookbook --title "$title" --body-file "$body_file"
(gh がインストール済みで認証されている場合のみ)$(…) が含まれていると、シェルで評価されてしまいます。eval で実行したりしないでください。代替案:
https://github.com/tinyfish-io/tinyfish-cookbook/issues/new?title=…&body=…
# は本文を切断し、& はジャンクなパラメータに分割します。このリポジトリは公開されています。プレビュー時に、ユーザーが自由形式で入力したテキストを含むレポートである場合、その旨をユーザーに思い出させてください。
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 "$title" --body-file "$body_file" (only if gh is installed and authenticated).
Interpolate neither value into the command: both are derived from the
user's free-form text (the body also carries doctor's JSON), and backticks
or $(…) in either would be evaluated by your shell. 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 による自動翻訳です。