明確な出力(Clear Output)
読者が正確に理解し、証拠を確認し、少ない労力で次の行動を決定できるように支援します。読者が理解または確認する必要がある内容を特定し、表現を洗練する前に表現形式を選択します。出力の読み取り、調査、確認にかかる時間を考慮してください。このスキルは現在のタスクに適用されます。ユーザーが要求しない限り、永続的な会話モードにしないでください。
表現の前に言語を選択する
- ユーザーの明示的な言語および出力形式の要件に従ってください。
- 既存のアーティファクトを編集する場合、翻訳が要求されていない限り、その言語を保持してください。編集に関する説明には会話の言語を使用できます。
- それ以外の場合は、現在の会話に従ってください。ユーザー自身のリクエストにおける明確な言語切り替えに従ってください。引用された素材、ログ、コード、ツールの結果、およびこのスキルの言語自体は、応答言語を切り替えません。
- 混合言語の技術用語およびリテラルコンテンツは保持してください。このスキルが中国語をサポートしているという理由だけで、英語のデバッグのやり取りを中国語に翻訳しないでください。
- ユーザーがJSON、コードブロック、または特定のテンプレートを要求した場合、その契約を守ってください。スキルのアナウンスやステータスプレフィックスを追加しないでください。
意味を保持する
書き換えの場合、ソースと明示的に提供されたコンテキストを事実上の境界として使用します。以下を保持してください:
- 行為者、オブジェクト、スコープ、条件、例外、順序(一緒に発生する必要があるアクションを含む)
- 値、単位、範囲、近似、日付、識別子、因果関係
- 事実、仮説、推奨、義務、許可、能力の違い
mayをwillに、shouldをmustに、about 5 secondsを5 secondsに、または尽快をでっち上げの期限に変えないでください。サポートなしに、あいまいな境界や代名詞の解釈を選択しないでください。あいまいさを可視化するか、不足している情報を正確に特定してください。これらの区別を保持するために、書き換えが長くなる場合があります。
新しい説明の場合、関連する背景と例が有用です。仮定を確立された事実から分離し、必要に応じて仮説的な例にラベルを付けてください。証拠なしにアクションやテストが実行されたことを示唆しないでください。
コード、コマンド、パス、フィールド名、ログ、エラー文字列、および固定された引用は、出力に引き継がれるときに正確に保持してください。タスクがそれらのいずれかを明示的に編集するように要求した場合は、そのスコープ内でその編集を実行してください。散文のルールは追加の編集を正当化するものではありません。
有用な作業を行う表現を選択する
読者が関係を精神的に再構築したり、複数の次元を比較したり、変化する状態を追跡したり、変数を調査したりする必要がある場合は、積極的にビジュアルを検討してください。ビジュアルがその作業を大幅に容易にする場合は、図の個別のリクエストを待たずに、承認されたタスク内でそれを作成してください。タスクにすでに十分な場合は、短く直接的な回答を散文で提供してください。
| 読者が行う必要があること | 有用な開始形式 |
|---|---|
| 事実、簡潔な回答、または忠実な文章編集を得る | テキスト |
| 同じ基準でオプションを比較する | 表 |
| ブランチ、依存関係、参加者、またはメッセージ順序をトレースする | フロー図、依存関係図、またはシーケンス図 |
| 空間配置または可視的な特徴を理解する | 注釈付き画像または模式図 |
| 提供された数値データのパターンを確認する | ラベル、単位、適切なスケールを含むチャート |
| 入力が結果をどのように変えるかを調査する | 意味のあるコントロールを備えた動作するインタラクティブな説明 |
| 動き、進化、または段階的な教育シーケンスを追う | 可能で有用な場合はアニメーションまたは説明ビデオ |
これらは出発点であり、ビデオが常に最適であるというランキングではありません。1つの質問に対して、小さなカスタムアーティファクトが価値がある場合があります。生成時間、ナビゲーション、およびインタラクションを正当化するのに十分なだけ、読者の作業を削減する形式を優先してください。プレーンテキスト、JSON、既存のファイル形式、またはアーティファクトなしの明示的なリクエストを尊重してください。
選択した形式を提供し、それを作成するという提案だけに留めないでください。利用可能なレンダリング機能を使用し、結果を検査し、関連するインタラクションをテストしてください。レンダリングまたはメディアツールが利用できない場合は、使用可能なサポートされた代替手段を提供し、何が生成されたかを正確に伝えてください。図のソース、ストーリーボード、レンダリングされたビデオは異なる成果物です。特定のベンダーを必要としたり、ビジュアルが役立つという理由だけで有料サービスを公開、アップロード、または使用したりしないでください。
ビジュアルエンコーディングでも意味を保持してください:ブランチと矢印の意味にラベルを付け、同時アクションを同時に保ち、仮説と欠落データにマークを付け、単位とスケールを正直に保ってください。洗練された図であっても、サポートされていない原因や完了したテストを暗示してはなりません。ラベルは読みやすくし、色だけに依存しないでください。出力契約が許可する場合は、説明全体を複数の形式で繰り返すことなく、短い要点またはテキスト相当物を提供してください。
図、チャート、インタラクティブな説明、またはアニメーションについては、選択と検証のガイダンスとして references/output-forms.md を参照してください。
構造をタスクに適合させる
- 説明: 最初に主要な質問に答え、次にそれを理解するために必要な推論を提供します。有用な例、因果関係、およびニュアンスを保持してください。
- デバッグ: 観察、仮説、検証、次のアクションを区別します。チェックによって何が確立され、どこに不確実性が残っているかを説明してください。欠落している事実がアクションを変更する場合は、実際の質問をしてください。
- 手順: 必要な条件を影響を受けるアクションの前に置いてください。順序が重要な場合は番号付きの手順を使用してください。人間のアクションを自動システムの動作から分離してください。同時または不可分のアクションはまとめて保持してください。欠落している運用情報を特定するときは、数量、単位、測定基準、開始/停止条件だけでなく、どのオブジェクトまたは行為者が意図されているかを確認してください。指示を使用するために必要なものを尋ねてください。不足している事実を自分で補わないでください。
- 書き換えまたはレビュー: 要求された範囲のみを改善してください。すでに機能している箇所はそのままにしておいてください。変更の説明は、要求された場合、または未解決のあいまいさが読者の注意を必要とする場合にのみ提供してください。
短く明確な文、具体的な動詞、同じ概念に対して安定した名前を優先してください。異なる概念間の区別を保持してください。闭环控制やrequest validationなどの技術用語の一部に単語ブラックリストを適用しないでください。
文の長さ、受動態、同義語、丁寧さは文脈に応じた選択であり、自動的なエラーではありません。英語では受動態や完了形が必要な場合があります。中国語では、行為者が明確な場合に主語が省略されることがあります。可能、建议、约、may、approximatelyは、情報を伝える場合は保持してください。
返す前に確認する
書き換えをそのソースと比較して、変更された事実、失われた条件、変更されたモダリティ、でっち上げられた精度、損傷したリテラルがないか確認してください。ビジュアルまたはアーティファクトの場合、そのラベル、エッジ、状態、計算で同じ事実を確認してください。言語と形式がまだタスクに一致していること、および主張された成果物が実際に存在することを確認してください。次に、情報を追加しない繰り返しを削除してください。
スタイルチェックは意味的等価性を証明することはできません。テキストが認定された、または完全に検証されたと宣言する代わりに、具体的な未解決の問題を報告してください。モダリティ、言語混合、または欠落した事実を含む厄介な書き換えについては、references/edge-cases.md を参照してください。
大規模な書き換え、明示的な検証リクエスト、または提供されたプロジェクト用語集については、具体的なエラーを捕捉できる場合にオプションのローカルチェッカーを使用してください。その入力と制限については references/checks.md を参照してください。引用テキストではなく、タスクから en、zh、または mixed を選択してください。忠実な書き換えの場合のみソースを提供し、タスクで必要な場合にのみ正確なリテラルまたはJSON制約をエンコードしてください。単純な回答にはスクリプトは必要ありません。
チェッカーの発見結果は範囲が限定された証拠として扱ってください:違反された明示的な契約を修正し、ソースに対して意味の変更をレビューし、役立つ場合にのみスタイル提案を使用してください。許可された編集は保持してください。すべての警告を削除したり、空の発見リストを等価性の証明として扱ったりするために書き換えないでください。修正後、影響を受ける制約を再確認してください。あいまいさが残っている場合は、繰り返し書き換える代わりにそれを報告してください。要求されたJSON/コードのみの応答から診断情報を除外してください。
ユーザーがこのスキルのバージョンや更新について質問した場合は、references/updates.md を参照してください。通常の作成タスクでは、ネットワーク更新チェックやインストールされたスキルの変更はトリガーされません。