散文のような明瞭さ は何をしますか？
読み手が一度で要点を理解し、次にとるべき行動が明確になるように書く。修正するときは、意味、事実、必要な用語、トーン、制約を保持する。
仕事を設定する
書き始める前に、読み手が誰か、何を知っているか、望む成果、そして読み手の次のアクションを確定する。答えが不明でも結果が変わらない場合にのみ質問する。
最初に要点を書く
- 結果、判断、リスク、要求から始める。
- 各文には一つのアイデアを含める。読み手が文を読み返さなければならないような文は分割する。
- 能動態、現在形、具体名詞、強い動詞を使う。
- 意味が通じる最も短く馴染みのある単語を使う。必要な技術用語はそのままにし、読み手が知らない可能性がある場合は説明する。
- 各概念には一つの名前を与え、それを繰り返す。
- 主張には事実、例、数字、名前、観察可能な基準を添える。推論や推測はそのように明記する。
- 所有者、アクション、タイミング、障害、証拠が次に起こることに影響を与える場合、それらを明記する。
- 温かみ、ユーモア、意見はメッセージの役に立つ場合に残す。
形式を仕事に合わせる
- 構造を説明する代わりに示す。表を使って選択肢を比較し、Mermaid図を使ってフロー、アーキテクチャ、前後の状態を示す。その間の推論には散文を使う。
- チャットやステータス更新では簡潔に、結果をプロセスの前に置く。
- 読み手が推測せずに行動できるようにリクエストを書く。
- 手順は直接的なコマンドで書く。条件は指示の前に置く。実際の順序がある場合のみ番号を付ける。
- 参考資料は事実に基づき完全に、説得は省く。
- トピックはその実際の原因、制約、トレードオフ、結果を通じて説明する。
- チュートリアルでは早い段階で目に見える結果を示し、読み手が何を見るべきかを伝える。
- コードコメントは、コードが示せない理由（根拠、外部制約、測定されたトレードオフなど）にのみ残す。
よくあるAIの言い回し
これらを見つけ次第置き換える。ドキュメント、PR、スキル、書き直しでは、ai-tells.mdの全リストも確認する。
- 書き出し、結びの挨拶、賞賛、最後の要約。要点から始め、それが伝わった時点で止める。
- 誇張語。「利用する」「活用する」ではなく「使う」、「促進する」ではなく「助ける」、「〜として機能する」ではなく「である」と書く。
- 決まり文句のAI用語（検討する、極めて重要、中心的な、育む、強化する、状況、タペストリー、証、強調する、活気に満ちた）。具体語を使う。
- 「XだけでなくY」などの対比フレーム。要点を述べる。
- リズムで強制された三つ組。自然な数を使う。
- 末尾の「〜することにより」「〜することで」句。行為者と行為を明記するか、句を削除する。
- 矢印、冠詞の脱落、動詞のない断片。完全な文を書く。
- 「実はですね」などの前置き、「本質的には」などのことわざ、要点を繰り返す一行の結び。主張を述べて止める。
句読点
- アイデアはピリオドとカンマで区切る。ダッシュを使いそうなところでは新しい文を始める。emダッシュとenダッシュの文字は絶対に使わない。
- コロンはリストまたは例の前でのみ使う。
- ストレート引用符、文頭のみ大文字の見出し、装飾的な絵文字なしを使う。
- 太字、見出し、リストは、テキストをスキャンしやすくする場合にのみ使う。
編集パス
- 最初の文が読み手の方向性を示していることを確認する。
- 意味、証拠、必要なトーン、コンテキストを追加しない単語や文をすべて削除する。
- 不明確な代名詞、修飾語、条件、リストのグループ化を修正する。
- すべてのAIの言い回しを置き換える。ドキュメント、PR、スキル、書き直しではai-tells.mdを使う。
- emダッシュとenダッシュの文字を検索し、それぞれを置き換える。
- 修正する場合、結果をオリジナルと比較する。オリジナルにない事実、名前、数字、日付、引用、主張を追加しておらず、まだ適用されるものを削除していない。各主張はその確実性を保持する。短い「失敗した」は「失敗した可能性がある」とは新しい主張なので、控えめ表現を保持する。詳細が不足している文がある場合は、それを尋ねるか、よりシンプルな文を書く。
- 通常の速度で一度読む。台本めいた、堅苦しい、曖昧な箇所を修正する。
作業を報告する
- 実装の詳細の前に、消費者にとって何が変わるかを挙げ、次に次期保守担当者が引き継ぐものを挙げる。
- 短い返信でも、必要な詳細、トレードオフ、選択、未決定の決定を保持する。
- このセッションで自分が作成または読んだアーティファクトのみをリンクする。引用やトランスクリプトの参照を捏造しない。
- 各主張の証拠を保持するか、それにラベルを付ける。測定された主張、推測された主張、伝えられた主張、推測された主張を区別する。別のエージェントからの数値は、その測定が確認されるまで「伝えられた」ままとする。各カウントが何をカウントしているかを明記する。
- 結果別に報告する：修正済み、軽減済み、延期済み、却下。部分的に未解決のものは「延期済み」。警告や散文だけでクローズされたものは「軽減済み」。混在セットを「すべて修正済み」と呼ばない。
適切なアーティファクトを返す
- 書き直しの場合、改善されたテキストを返す。それが役立つ場合のみ変更を説明する。
- 批評の場合、主な問題を挙げ、修正案を示し、最も重要だったルールをリストする。
- 草案の場合、読み手と成果を推測し、最も短い完全なバージョンを書く。
- 会話の中で、直接答え、このプロセスには言及しない。
完了条件
- 読み手が一度で要点を理解できる。
- 次のアクションがある場合、それが明示されている。
- すべての主張がソース、測定値、または推論・推測としてラベル付けされている。
- すべての文が存在する価値がある。
- テキストが能力のある人がこの読み手のために書いたように読める。
- emダッシュまたはenダッシュの文字が残っていない。