refine-it

洗練する

ワークフロー

1. 成果物とその役割を特定します。

   • プロンプトと周辺の文脈から、成果物の種類、対象読者、目的、望ましいトーン、どの程度手を加えるべきかを推測します。
   • 修正、置換、追加、削除、訂正など、特定の編集を指定する依頼では、その編集に範囲を絞ります。自由に洗練するのは、そう求められた場合に限ります。
   • 明示された制約、事実の主張、決定事項を維持します。成果物をより明確で有用にできるなら、セクションの構成変更、統合、並べ替え、簡潔化を行います。
   • トリガー、権限、ラベル、ステータス、API 名、設定キー、ルーティング、適格性に関する文言などの運用上のテキストは、動作を定めるものとして扱います。文言やグループ分けは整えても、意味は変えません。
   • 意図が本当に曖昧な場合に限り、必要最小限の質問をします。それ以外は、成果物の役割を最もよく果たせる介入の程度を選びます。

2. 書き直す前に評価します。

   • 目的の不明瞭さ、構成の弱さ、繰り返し、曖昧な表現、隠れた前提、文脈の不足、トーンの不一致、過剰な主張、未完成の箇所を確認します。書き直す前に、すべてのセクションをこの観点から評価します。
   • 前提となる知識が導入される前に概念に依存していないか確認します。これは構成上の欠陥であり、通常は順序を入れ替えることで解決できます。確認すべき単位は単語ではなく概念です。専門用語を使っていなくても、読者が知らない考えを前提にした文章になっていることがあります。
   • 洗練の問題と戦略の問題を切り分けます。ユーザーから求められない限り、成果物の目標、対象読者、運用上の動作は変えず、現在の方向性を決然と改善します。
   • 成果物が役割をすでに十分に果たしているなら、軽く整えるだけにするか、実質的な修正は不要だと伝えます。目に見える違いを生むためだけに変更を作り出してはいけません。

3. 直接、洗練して磨き上げます。

   • レビューの指摘だけを求められていない限り、批評だけでなく、よりよい成果物を作成します。
   • 冗長な表現や重複を削り、具体的な動詞と名詞を選び、階層を明確にし、暗黙の決定を明示します。文章を残す価値があるかどうかは、感覚ではなく確認事項です。削ると何が損なわれるか、その文章は直前の内容にはない何を読者に与えるかを考えます。
   • 内容に合った形式を選びます。論旨は散文で、並列する項目はリストで示します。同じ形式が3回以上繰り返される場合は、表にする価値があります。引用は、文言そのものが重要な場合に使います。見出しには、単なる話題ではなく要点を示します。
   • 短くする前に、保護すべき用語、つまり専門用語、限定表現、制約、意図的に具体化された表現を特定し、明らかに重複している場合を除いて残します。
   • 既存の成果物から明確に導ける内容だけを追加します。
   • スキル、ランブック、ポリシー、エージェントプロンプトなど、実行者に指示する成果物では、動作も判断も変えない節を削ります。単なる強調や、直後のルールを言い換えただけの理由説明は省きます。実行者が自力で判断するための情報となる理由説明は残します。
   • ユーザーの声を維持します。くだけた、率直な、意見のはっきりした文章は、その文体のままにし、ありきたりな企業向けの文章に均さないでください。
   • このワークフローのルールに従うことで文が悪くなる場合は、別の方法で整えるか、そのままにします。ルールは読者のためのものであり、すべてのルールに従っていても機械的に聞こえる文章は失敗です。

4. 引き継ぎを完了します。

   • 推敲した文章をさらに圧縮し、意味やトーン、手順 3 で加えた明確さを保ちながら、できるだけ簡潔にします。
   • ユーザーがそのまま使う可能性が高い場合は、最終版を先に記載します。
   • 短い成果物では、混乱を防ぐ注記が必要な場合を除き、推敲した文章のみを返します。長い成果物では、最終版 の後に必要に応じて 注記 を記載します。
   • 注記は簡潔にし、主な変更点、前提、解消されていない曖昧さ、確認が必要な主張、削除・変更・簡略化した重要な用語など、有用な場合にのみ記載します。
   • リポジトリ内のファイルを編集する場合は、ファイルを更新し、変更したファイルを要約します。これはテキスト編集のみの作業です。リンター、リンクチェック、ビルド、その他のツールは実行しないでください。

例

編集前：「この機能を活用できるようにするには、ユーザーはまず設定を行う必要があります。」 編集後：「これを使うには、まず設定してください。」 （冗長な表現を削り、具体的な動詞を選び、意味と直接的なトーンを保っています。）