abhishekkumar541/pre-ai-writing

Pre-AI（AI以前）の書き方

ドキュメントがLLMの出力として読めてしまうのは、単語レベルの修正では直せない構造的な理由によります。

• 先頭の説明ラベル（「一行での答えは。」）
• リーディングガイド
• あらゆる事実へのステータスタグ
• 各セクションへの反論
• 何にでも表を使う
• あらゆる段落にURL

2022年11月以前の人々が書いていたように書きましょう：目的を最初に、次に前提、プレーンな見出し、各セクションの要点は最初の文に、主に散文で、最後に番号付きのソースリスト。その後、humanizerスキル（https://github.com/blader/humanizer）が文を処理します。

references/rules.mdには、すべてのルールとそのBefore/Afterが記載されています。references/structures.mdには、ドキュメントタイプごとに1つのテンプレートがあります。以下のパスは、このスキルのフォルダからの相対パスです。

ワークフロー

1. フレーミング。 チャットの1行で、以下の4つを指定します。

   • 読み手
   • 読み手が読む状況（受信箱、面接パネル、フィード）
   • タイプ：持ち帰り課題、メモ、メール、カバーレター、投稿、履歴書、スライド、ランディングページ、ドキュメント
   • ティア

   高リスクとは、求人応募や持ち帰り課題、クライアントへの納品物、経営陣向けのもの、またはユーザーが高リスクと呼ぶものを指します。この行が書かれた時点で完了。

2. 執筆前の情報収集。 以下のものを集めます。

   • ブリーフの正確な言葉（文字数やページ数の制限を含む）。
   • カバレッジテーブル：ブリーフが求めるすべての項目と、それに答えるセクションをマッピングしたもの。これはチャットまたはメモに残し、ドキュメントには決して入れません。
   • 一次証拠：各項目に出典を付けて。
   • ユーザー自身の言葉：メモや以前のメッセージから。
   • クライアント向けのコピーの場合：クライアント自身の表現を15～20件。

   出典のない主張は「要確認」とマークします。すべての予定された主張に出典または「要確認」がある時点で完了。

3. 構造化。 references/structures.mdのテンプレートを選び、各セクションに重要度に応じた単語予算を割り当てます。ブリーフに制限がある場合は、デフォルトの長さよりもそちらを優先します。予算付きのアウトラインが存在する時点で完了。

4. ドラフト作成。 <名前>_draft.md に、references/rules.md と references/evidence.md に従ってドラフトを作成します。ステータスラベル、アクセス日、番号付きテーブルは <名前>_notes.md に記述します。

5. リント。 以下を実行します。

   python3 scripts/lint_doc.py --type <タイプ> <ファイル>
   

   スライドの場合は、スライドフォルダを渡します。<aside> はスピーカーノートとして読み取られます。すべての FAIL を修正します。各 WARN は修正するか、なぜそのままにするのかをチャットで説明します。終了コードが0になった時点で完了。

6. Humanizer。 humanizer スキルをSkillツールで呼び出します（たった3行のメールの場合でも）。手動の「自分で確認した」パスはカウントされません。新しいセッションはテストでこのステップをスキップしました。散文のみに対して埋め込みモードで実行します。表、引用コピー、コード、ソースリストはそのままにします。結果を新しいファイルとして保存し、再度リントを実行します。新しいファイルのリントがクリーンになった時点で完了。

7. ユーザーに関する主張。 ユーザーの行動、習慣、結果、使用状況、感情を述べているすべての文をリストアップします。それぞれをユーザーの履歴書、メモや記憶、またはこの会話での発言に照らしてトレースします。出典のないものは質問するか、削除します。チャットの表（主張｜出典｜保持、削除、質問中）がそのような文すべてをカバーした時点で完了。

8. 指定された読み手としての読み直し。 各質問に「はい」「いいえ」で答え、間違った答えをすべて修正します。

   • 各セクションの最初の文にその要点が書かれていますか？
   • 読み手は、各段落が削除されたら見逃すでしょうか？
   • ドキュメント自体を説明している文はありますか？
   • セクションの長さは重要度に従っていますか？
   • ここで、一次情報からしか得られないものは何ですか？（具体的に挙げてください。何もなければ、ドラフトは一般的です。）
   • すべての数字はメノにたどれますか？
   • 次のステップまたは依頼で終わっていますか？
   • フォーマットは、それが送られる場所に適していますか？（メールやLinkedInはプレーンテキスト、Markdownは不可。）

9. 高リスクティアのみ。 このステップは、ステップ1で高リスクと指定された場合に必須です（短いテキストも含む）。references/high-stakes.md に従います。

   • 新しいエージェントによる読者レンズレビュー
   • 持ち帰り課題やピッチの場合：ベースラインと scripts/sameness_check.py、および scripts/blind_pack.py によるブラインドレビュー

   合格基準を満たしたか、不合格が報告された時点で完了。

10. 引き渡し。 送り先の形式で行います。

    • メールや投稿はプレーンテキスト
    • ドキュメントはMarkdownまたはドキュメント形式
    • スライドはスライド形式

    カバレッジテーブル、主張テーブル、ステータステーブルはチャットまたは <名前>_notes.md に残します。PDFは、ユーザーが依頼した場合、または成果物がPDFの場合にのみ作成します。

    python3 scripts/build_pdf.py in.md out.pdf --title "..." --footer-left "..."
    

    その後、ソースページを含むページ画像を確認します。-I なしで実行します（markdown をインポートするため）。

他のスキルを上書きするルール

• ダッシュ。 U+2014（―）やU+2013（–）は、引用やメモを含め、どこにも使用しません。これは作者のハウスルールです。スタイルでダッシュを許可する場合は、scripts/lint_doc.py の dash チェックを削除してください。
• 改訂は新しいバージョン。 元の成果物を黙って編集しないでください。
• プロセスはページに書かない。 方法、プロセス、AIの使用は、ソーススライドまたはメモの1行に収め、セクションやスライドにしてはいけません。
• このスキルが最終パスです。 コピーライティング、メール、履歴書のスキルはコンテンツをドラフトします。このスキルはそれらの後で実行され、それらの代わりにはなりません。

ファイル

• scripts/lint_doc.py：構造と表現のリンター。--help でフラグを確認。--fix-typography OUT で修正済みコピーを出力。
• scripts/sameness_check.py、scripts/blind_pack.py：高リスクキット。
• scripts/build_pdf.py：MarkdownからPDFへの変換とチェック。
• scripts/prompt_trigger.py：オプションのUserPromptSubmitフックで、Claudeにこのスキルの使用を促します（README参照）。
• references/：
  • structures.md
  • rules.md
  • evidence.md
  • voice.md
  • high-stakes.md
• templates/blind_review_prompt.md
• tests/test_lint_doc.py：ルールを変更したら実行します。