本を出したいと考えている方へ: テーマ選びから発売まで、「Vibe コーディングのゼロの基礎」で私がたどった本づくりの全プロセス
本日、「Zero Basics of Vibecoding（新しいタブで開く）」が Bloglai、Jinshitang、Duzhu Life の新しいコンピューター情報書籍リストに同時に掲載され、同時に 3 位になりました。
この本を書く前に、私はある質問について考えていました。市場にはすでに AI プログラミングを教える本がたくさんありますが、そのほとんどは、読者がすでにプログラム ロジックを少し知っていることを前提としています。 基本的な知識がなく、AI を使って自分で何かをしたいだけの人はどうすればよいでしょうか?どこから始めますか?
本書はこの疑問に答えることを目的としています。 コードを 1 行も記述することなく、AI を利用して独自の Web サイト、アプリ、さらには作業自動化ツールを作成できます。 この本は、Andrej Karpathy 氏が言及したバイブコーディングの概念から始まり、アイデアから制作まですべての人を助けます。 執筆の過程で私が最もよく自問するのは、「手続き型プログラミングに触れたことのない人がこの本を読んでいる場合、このステップでつまづいてしまうだろうか?」ということです。
私にとって、リストに載ったことの最大の意義は、ランキングそのものではなく、この判断が正しいかもしれないということを証明することだ。ゼロから書かれ、人間の言語を話す AI プログラミングの本を待っている人々が実際に大勢いるのだ。
ここで、特に何人かのグループの人々に感謝したいと思います。 この本を購入し、読んで、さらには本の手順に従って何かを作ってくれたすべての読者に感謝します。あなたのフィードバックは、この本に対する最も直接的な受け入れです。 Qifeng Information の編集チームには、構成の議論からテキストの磨き上げ、表紙のデザインに至るまで、私の指導ノートを実際に棚に並べられる本にするのに協力してくれてありがとう。 出版は決して一人のビジネスではありません。
このため、ここ数日、多くの友人が私に同じことを尋ねてきました。 「私も本を書きたいのですが、どこから始めればよいですか?」
そこで、テーマ選定から提案、交渉、執筆、入稿、校正、上場前後の業務までの全行程を書き記しました。 この記事では精神的な方法については説明せず、実践についてのみ説明します。 それは従うべきプロセスであると考えることができます。
▲書籍出版の8段階：テーマ選定から掲載、運営まで
書く前に: まず、サービスを受けていない読者のグループを見つけます。
ほとんどの著者の最初の本が売れない理由は、その文体が原因であることはほとんどありませんが、主にこの本を明らかに待っている読者がいないことが原因です。
初心者のライターが始める最も一般的な方法は、「自分が一番書きたいことは何だろう?」と自問することです。 確かに質問に間違いはありませんが、本を裏付けるには十分ではありません。 本とは、棚に置かなければならないものであり、本屋で見知らぬ人に手に取ってもらう必要があるものであり、30秒以内に代金を支払うかどうかを決める必要があるものです。 あなたが書きたいと思うことと、誰かが読みたい、買いたいと思うことは全く別のことです。
より有益な質問は次のとおりです。 このトピックについて関心を持っていない読者のグループはどれですか?それとも既存の本を読み飛ばしてもいいですか？
私が使っている方法はシンプルで、週末の午後に行うことができます。
実際の書店に行って、書きたいトピックに対応するセクションを見つけてください。自分に近い本を 3 ～ 5 冊選び、目次と最初の章を 1 つずつ開き、ノートに 1 つのことを書きます。 「この本の著者は、読者がすでに知っていると想定していることは何ですか?」
書き終わるとリストが表示されます。 そして、そのリストはスキップされた視聴者です。
▲ Reader’s Ladder: 既存の本のほとんどは 3 段目から始まり、下 2 段は空いています
私はコンピューター書籍のコーナーに立って、長い間勉強しました。そして得た答えは次のとおりでした。AI プログラミングの教育に関する書籍のほとんどは、読者が少なくとも変数とは何か、関数とは何か、端末とは何かを知っていることを前提としています。 まあ、もちろん作者はそんなつもりで言ったわけではありません。 この本を書いた本人はすでにそれを知っていて、その前提は彼の目にはまったく前提として見なされません。 しかし、時間を節約するためにちょっとしたツールを作りたいだけの管理者、教師、企業、またはクリエイターにとって、これらの前提条件は間違いなく高い壁です。
その壁にぶつかったとき、テーマが決まります。 あなたの本が他の本よりも新しく、優れている必要はありません。 場合によっては、他の本より 1 レベル低いだけで十分です。
将来の参考のために保持できる基準は次のとおりです。 あなたのトピックがそれをすでに知っている人だけを引き付けることができる場合、市場は小さいでしょう。あなたのトピックが玄関先でさまよっている人々を捕まえることができれば、市場は大きくなるでしょう。 ご存知のとおり、ドアの前には常に最も多くの人が立っています。
一方で、非常に魅力的ですが注意が必要なトピックもあります。その概念は新しいもので、それについて話すことに興奮していますが、実際にそれに苦しんでいる人は誰もおらず、問題を解決するためにお金を払いたいとさえ思っていません。 この種の文章を書くのが最も楽しいですが、それを売るのが最も難しいです。判断するのは難しくありません。 ただ尋ねる必要があるのは、インターネット上のあらゆる場所でこれについて尋ねた人はいますか?質問する人が見つからない場合は、おそらく時期尚早です。
アイデアを提案に変える: パブリッシャーが本当に求めている 6 つのこと
読者の概要を把握したら、急いで書く必要はありません。 次のステップは出版提案書を書くことです。
想像上の計画は非常に形式的で完全な文書であるため、多くの人がここでつまずいてしまいます。 実際、必要なのは 6 つの質問に答えるだけで、3 ページから 5 ページで書くことができます。
▲ 事業計画を公開する際に答えるべき 6 つの質問
まず、一文での位置づけです。 この本を読んだ後、誰が、どんな問題に遭遇し、何ができるのか。 最後の段落と何ができるかに注目してください。 参考書の価値は、読んだ後に得を感じることではなく、読んだ後に完成したものを手にすることにあります。 私の本の答えは次のとおりです。プログラムを書いたことのない人でも、この本を読んだ後、AI を使用して自分の Web サイトや ウィジェット（新しいタブで開く） をオンラインに公開できるようになります。
2つ目は、対象となる読者の具体的な姿です。 私の新しい本「Vibe コーディングのゼロの基本（新しいタブで開く）」を例に挙げてみましょう。 AIに興味がある会社員については書かないでください。この書き方は書かないのと同じです。特定できる人物を書いてください。 たとえば、週に 4 時間手作業でレポートを作成している 35 歳の経営幹部などです。 ChatGPT について聞いたことはありますが、開発ツールをインストールしたことはありません。彼はコンピュータープログラミングの本を何冊か購入しましたが、いつも第 2 章で止まってしまいます。 具体的にすればするほど、編集者は本のどこに掲載すべきか、表紙がどうあるべきかをより適切に判断できるようになります。
3つ目は、市場比較本です。 似たような本を 3 ～ 5 冊挙げて、あなたとその本との違いを書き出してください。 編集者は毎日提案書を読むと、自動的に頭の中で既存の書籍リストと比較します。最初にそれを明確に説明すれば、彼が宿題を終わらせるのを手伝ってくれるでしょう。 1 つ注意していただきたいのは、他の人の本を故意に軽視するのではなく、異なる読者に向けたものであることを明確にしてください。
第四に、章の構成。 少なくともセクションレベルまでは書きます。 これは、あなたが明確に考えていることと、書き終えることができるという 2 つのことを同時に証明するため、編集者のあなたに対する信頼を直接決定することになります。
五番目、証明。 単なる要約ではなく、実際の完成品として、完全な章を 1 つまたは 2 つ用意します。 理由は簡単で、編集者が見たいのは文章のリズム、絵と文字の比率、または説明能力だからです。これらのことは、抽象的なものだけを見ているだけでは見えません。
第 6 に、導入できる経路。 この点は著者によって見落とされがちですが、意思決定の重要な部分です。 出版社は内容が良いかどうかだけでなく、本が売れるかどうかも評価します。 ニュースレターの購読数、コミュニティの追跡、コースの受講者数、頻繁に協力するユニットの数などをすべて書き込むことができます。 私を例に挙げると、私の「Vista ニュースレター（新しいタブで開く）」には 20,000 人近くの購読者がおり、私が運営している AI コミュニティ（新しいタブで開く） には 110,000 人以上の読者がいます。 私のプライベートエリアからだけで、10万人以上の人々と連絡を取ることができます。
6点目に関して、特に言いたいのは、数字をわざと埋めずに、実際の数字を書いてください。 数字が小さいからといって恥ずかしくないようにしてください。 1,000 人の電子登録リストはそれほど多くないように思えるかもしれませんが、開封率が高ければ、10,000 人の無言フォローよりも説得力があります。 水増しされた数字は発売後にのみ明らかになり、出版は何度も維持したい長期的な関係になります。
計画を作成した後、誰に送信する必要がありますか?編集者をすでに知っている場合は、その編集者に直接送信することもできます。 そうでない場合は、本棚に同様の本を置いている出版社を探してください。 ほぼすべての公式 Web サイトには投稿メールボックスがあります。 手紙の本文は、あなたは誰ですか、この本は誰に役立ちますか、添付ファイルは計画書とサンプルシートの 3 つの段落を書くだけです。
契約交渉: 恐れることはありませんが、明確に質問してください
運が良ければ、出版社の好意を勝ち取り、出版の意思を受け取った後、契約手続きに入ります。 初めて本を出版する著者は、恥ずかしくて質問できないため、契約の重要性を無視し、このレベルで相手が提示した条件をすべて受け入れてしまうことがよくあります。
私の提案は、契約条項は議論するためのものであり、問題点のリストを作成して編集者に送信することは、実際にはプロフェッショナリズムの表れであり、トラブルを探しているわけではないということです。
最初の本を出版するときに少なくとも尋ねるべきだと思うことがいくつかあります。 各出版社の慣行は大きく異なるため、数字は示さず、質問だけに留めます。
▲ 8 つの契約期間、それぞれがどの期間に影響するか
ロイヤルティの計算の基礎は価格設定または実際の領収書に基づいていますか?特にチャンネルが割引されている場合、両者の間には大きな差があります。
決済と支払いのサイクル。 決済はどのくらいの頻度で行われますか、決済後の支払いにはどのくらいの時間がかかりますか、最低支払い基準額はあるかどうか。 前回、本を書いてから 2 年後に印税を受け取ったという友人に会いました。信じられないほどでした。
前払いのロイヤルティはありますか?もしそうなら、どうすればそれらを相殺できるでしょうか？
電子書籍の印税の計算方法と紙の本とは別に計算されるかどうか。
派生ライセンスの範囲。 簡体字中国語版、外国語版、オーディオブック、コースまたはビデオ化、これらの権利は誰が所有し、どのように分割されますか?これは、教育を行っている著者にとって特に重要です。 本の内容を使って教えることで契約違反にならないように注意する必要があります。
改訂と再発行。 特に専門書の場合は、2年後に改訂が必要になった場合、原稿料は誰がどのように決定するのでしょうか？
絶版および著作権のリサイクル。 本の印刷が中止されてからどのくらいの期間で著作権を取り戻すことができますか?
著者が寄贈した本の数と、著者自身が購入した場合の割引。 これらの書籍は、今後イベントを企画したり、学生に送ったり、推薦者に送ったりするときに使用できます。
これらの質問をすると、この契約についての基本的な理解が得られるでしょう。 契約書にまったく理解できない箇所がある場合は、まず AI に理解してもらうこともできますし、編集者に現地語で説明してもらうこともできます。 これは通常のリクエストです。
執筆段階: 本を製品開発として扱う
実際に書き始めてからは、記事を書くのではなく、プロダクトを開発して本を書くことをおすすめします。
違いは何ですか?記事を書く場合は、書いたら1つとしてカウントします。 一方、製品を作るときは、まずユーザーが完了したいタスクを定義してから、設計プロセスに戻ります。
新しい本「Zero Basics of Vibecoding（新しいタブで開く）」を例として、いくつかのことを行いました。
まず、各章は読者が達成できる結果に対応しています。 章の定義方法は次のとおりです。この章を読んだ後、読者はさらに何かを手に入れることになります。 この制約があるため、各章が知識のリストに肥大化することはありません。
次に、ステップを書くたびにその文を一度尋ねてください。 手順に触れたことのない人がそれを読んでいる場合、その人はこのステップで行き詰まるでしょうか?この本を執筆する過程で、私はこの質問を何百回も繰り返しました。 そのため、ウィンドウの外観、ボタンの位置、エラー メッセージが表示された場合の対処法など、当たり前だと思っていた多くのアクションを書き留める必要がありました。
第三に、本当に知識がゼロの人を見つけてテストしてもらいます。 親戚や友人、同僚を探さないでください。親戚や友人はあなたの欠点を文章で許容してくれるでしょうし、同僚はあなたが見逃した手順を自動的に補ってくれるでしょう。 これまで会ったことのない友人を見つけて、手伝わずに横から見ながら、あなたが書いた章をフォローするように頼んでください。 彼が行き詰まった場所はすべて、埋める必要のある本の穴でした。 このステップは当然ながら苦痛ですが、このステップによって保存されるものの価値は、どのような洗練された原稿よりも高くなります。
第四に、資料は執筆時点で管理されなければなりません。 スクリーンショットにはソフトウェアのバージョンと撮影日をマークする必要があり、説明書はコピー可能である必要があり、個人情報が画面に表示されるべきではありません。 これらのプロセスを 1 つのステップで完了するのが最善です。インターフェースはすでに改訂されているため、後から行うのは非常に困難です。
第 5 に、進捗状況は文字数ではなく、成果物の章によって計算されます。 Word の文字数を見ると、進歩しているように錯覚します。実際、80% まで書き終えて、章の最後の 20% で止まっている原稿の価値はゼロに近いです。 経験から言えば、むしろ章ごとに終わらせたいと思っています。
さて、あまり話題になっていないヒントをもう 1 つ紹介します。 それは、第 1 章ではなく、第 3 章を先に書くことです。
最初の章と序文は、雰囲気を決めるため、通常、本の中で書くのが最も難しい部分です。 本全体を書いていないときは、通常、どのようなトーンを設定すればよいのかわかりませんか?そのため、途中の自分がよく知っている内容から始めて、本の構成ができてきたら最初に戻るとスムーズです。
技術書の著者にとって特別なジレンマ: あなたの本は必ず期限切れになります
参考書や専門書を書く場合は、この段落をよく読んでください。
本の寿命は短いため、すぐに期限切れになる可能性があります。 ソフトウェアは改訂され、インターフェイスは再配置され、コマンドの名前は変更され、大規模な言語モデルさえも世代ごとに変更されます。 通常、本を投稿してから店頭に並ぶまでに 2 ～ 4 か月かかりますが、この期間は多くのことを変更するには十分な時間です。
私の処理原理は非常にシンプルで、コンテンツを 2 つのレイヤーに分割することです。
▲ コンテンツの鮮度：入れ替え速度と長期価値の二軸で位置付け 概念、プロセス、判断基準、要件の記述方法、エラーメッセージの理解方法、問題が発生した場合の前の手順への戻り方など、最初のレベルは変わりません。 この層は当然うまく書く必要があります。
2 番目のレイヤーは、スクリーン ショット、メニューの位置、ボタン名、バージョン番号を含めて変更されます。 このレイヤーは置き換え可能になるように記述し、閲覧する写真が本の中の写真と異なるのが普通であることを読者に知らせるために、バージョンと日付を明確にマークする必要があります。
さらに、書籍内に オンライン更新ページ の URL を残し、QR コードを添付することをお勧めします。 まず、読者は改訂版に遭遇したときに確認する場所ができます。次に、このページは読者をあなたのサイトに戻し、その後のビジネス リストへの入り口となります。 URL を書籍に印刷する必要があるため、書籍を印刷する前に計画する必要があります。
コンテンツをどの程度詳細にするかを決定するのに役立つ簡単な基準があります。ボタンの場所を教えた場合、この段落は 1 年後には役に立たなくなります。この状況に遭遇したときの判断方法をあなたが教えれば、5年後も誰かがこの段落から恩恵を受けるでしょう。 したがって、ボタンやインターフェイスだけを教えるのではなく、できるだけ多くのメソッドを教えるようにしてください。
納品して終わりではありません: 編集者との協力期間が重要です
多くの著者は、原稿を提出したら終わりだと考えています。実際、旅の残りの半分は、原稿が提出されて初めて始まります。
編集チームは、部外者が想像する以上にあなたの本のために尽力します。 今回の私の経験に基づくと、アーキテクチャの議論からチャートの修正、表紙のデザインに至るまで、あらゆるレベルで教材が棚に並べられる製品に変わっています。 あなたの専門はコンテンツですが、編集チームの専門はコンテンツを本にすることです。この2つは本当に違います。
初めて著者になる人に、具体的なアドバイスを 3 つ挙げます。
まずは編集者のコメントをプレゼントとしてお考えください。 彼はこの本が出版される前にこの本を真剣に読んだ最後の読者であり、本を読みながら書店で見知らぬ読者に常に質問をしていました。 彼がここで何かを理解できないと言うとき、それは通常、彼がそれを理解していないのではなく、他の誰かがそれを理解していないことを知っているのです。 編集者をトラブルメーカーだと考えないでください。彼はあなたの最高のパートナーとなるでしょう。
第二に、校正は散在的なギャップに依存せず、継続的な期間内に配置される必要があります。 これは私がつい最近学んだ教訓です。 年末に出版予定の本がもう一冊あるのですが、その校正作業が1週間近くやるべきことリストに入っていて、毎日他のことで中断されていました。その日の最優先事項にランクするまでは、すべて校正して1日で発送しました。 確かに校正は、意志の力ではなく完全な集中力を必要とする肉体的な仕事です。
第三に、校正はラウンドで行われ、各ラウンドで実行される作業は 1 つだけです。 1 ラウンド目はファクトとコードが正しいかどうかのみを確認し、2 ラウンド目は文章と言葉遣いの一貫性のみを確認し、3 ラウンド目はレイアウト、イラスト、数字のみを確認します。 一度にすべてを処理しようとすると、すべての項目を取り逃すことになります。 すべてをやろうとするのではなく、一度に一つのことをやることに集中してください。
さて、事前に準備しておきたいことがもう 1 つあります。それは、推奨される序文と腰のコピーです。 これらには誰かの助けが必要であり、誰かを見つけるには時間がかかります。 可能であれば、編集者からの促されるのを待つのではなく、原稿が投稿されたらすぐに招待状を送り始めてください。 招待する場合は、完全な原稿または少なくとも 2 章の校正刷りを添付し、期限と文字数の範囲を明確に相手に伝えます。これは基本的な礼儀であり、配慮です。
発売の 4 週間前: 著者ができること、すべきこと
出版社はそれぞれ得意分野があり、マーケティングもやってくれますが、著者ができることは誰も代わりにやってくれません。
以下は、この本の出版のために私が実際に行ったことのリストです。
この本に属するページを作成します。 これは投稿ではなく、試用版コンテンツ、さまざまなチャネルからの購入リンク、書籍で説明されている拡張リソース、および前述のオンライン更新ページを含む永続的な Web ページです。 このページはすべてのプロモーションの到達点となり、その後のすべての記事、スピーチ、手紙がこのページを指します。
すべてのパス接続を一度に準備します。 Blog Lai、Jinshitang、Eslite、Reading Life、Shopee、momo など。読者の購買習慣は大きく異なります。チャンネルを 1 つ減らすと、捕まえられる人々のグループが 1 つ減ります。
ただ広告を掲載するのではなく、コンテンツを適切に計画しましょう。 発売の前後数週間に必要なのは、本の概念の拡張、特定の章の実践的なデモンストレーション、執筆（新しいタブで開く） プロセスでの選択など、本に関連するがそれ自体が価値のある一連のコンテンツです。 読者が積極的にフォローするのは、本を売っているからではなく、内容が役立つからです。
コミュニティのスケジュールはバッチで送信する必要があります。 私のように複数のファン ページやコミュニティを運営している場合、実際には視聴者がかなり重複しています。同じ投稿がどこでも同時に投稿され、同じ人が何度も連続して見ることになり、悪い印象を与えてしまいます。 観客の重なり具合に応じて何回かに分け、間隔をあけて配信し、バッチごとに入場角度を変えるという方法だ。
リストを棚卸しします。 ニュースレターの購読者は最も直接的なつながりですが、それを放送局ではなくネットワークとして考えてください。 上場レターには単なる売り込みではなく、内容的価値がなければなりません。
レッスンをプレゼンテーションに合わせて調整します。 教える場合、発売の前後のすべてのセッションが自然なタッチポイントになります。 押し売りする必要はありません。この本を授業後の拡張リソースとして使用し、生徒に提供するのは自然なことです。
IPO 後: ランキングは成績表ではなくシグナルです
本が棚に置かれた後、あなたは非常に奇妙な心理的プロセスを経ることになります：常に注意を払い、ランキングを更新します。
私自身の経験では、リストに載ることはうれしいことですが、それはその本の長期的な価値ではなく、短期的な集中力を測るものです。 本の本当のパフォーマンスは、2 か月後 (あるいは 2 年後) に誰かがその本を買うかどうか、誰かがその本を友人に勧めるかどうか、誰かがその本に基づいて何かを作るかどうかによって決まります。
そこで、3つのことに注目してみました。
▲ 本を長期資産として扱う：本による循環
まず、実際の使用状況のフィードバックを収集します。 特に本を読んで完成品を作る読者はそうでしょう。彼らのプロセスは、どの章が十分であり、どの章が不十分であるかを教えてくれます。 このフィードバックは非常に貴重であり、次の書籍や改訂版の最も貴重な資料となります。
次に、どのコンテンツが最も頻繁に質問されるかを記録します。 同じ質問が 3 回以上行われる場合は、その本の段落が明確に書かれていないことを意味します。まずそれを補う記事を書いてから、改訂版で修正することができます。
第三に、本を一度限りの活動ではなく、長期的な資産として扱うことです。 この本では今後も講演への招待、社内トレーニングや協力の提案が提供され、これらのフォローアップの価値は印税そのものをはるかに超えることがよくあります。
最初の本を考えるためのチェックリスト
最後に、出版ガイド全体を直接比較できるチェックリストにまとめました。
公開前:
- 既存の本を読み飛ばした読者のグループの名前を挙げて、どこで行き詰まったかを知ることができます
- 読者がこの本を読んだ後にどうなるか、一言で言えます。
- 3 ～ 5 冊の本のリストを作成して比較すると、違いがわかります
- 章構成をサブセクションレベルまで書き終えました
- 章の完全な校正刷りを 1 つまたは 2 つ用意しました。
- 議論の余地があるチャネルとリソースを正直に棚卸しました
約束を交渉するとき:
- ロイヤリティーの計算、決済サイクル、電子書籍、派生ライセンス、改訂再版、絶版リサイクル、無料書籍、自己購入割引などの基本について聞きました。
- 契約書に理解できない箇所はありませんでしたが、とにかく署名しました。
執筆時点では:
- 各章は、読者が完了できる結果に対応しています。
- 少なくとも 1 章を実際にテストした、ゼロベースの真の読者を見つけました。
- スクリーンショットと手順にはバージョンと日付がマークされています
- 進行状況は単語数ではなく、完了した章によって計算されます
提出後:
- 校正は継続的な期間内に配置され、ラウンドで実行されます。
- 原稿が投稿され次第、推奨の序文と本の腰を募集します。
- オンライン更新ページの URL は印刷前に決定されます。
リストする前に:
- この書籍の常設ページがオンラインになり、試し読み、アクセス リンク、および拡張リソースが利用可能になりました。
- いくつかのプロモーション投稿ではなく、コンテンツがスケジュールされています
- コミュニティは重複する視聴者に基づいてバッチで公開します
- メールマガジンの文字には実際の内容価値があります
本を書くということは、結局のところ、自分がすでに知っていることや、他の人がつまずく箇所を知っていることを、彼らが理解できる順序で説明することです。 難しいのは文章を書くこと自体ではなく、何も知らない状態に戻って再び道を見つめる意欲です。
初めての本を準備している場合、このプロセスが不必要な間違いを避けるのに役立つことを願っています。 さらに詳細を知りたい場合は、私と話し合ってください（新しいタブで開く） ことを歓迎します。
最後にもう一度言わせてください。出版は決して一人の仕事ではありません。 あなたの原稿を本にするために喜んで協力してくれる人々のグループを見つけることが何よりも重要です。
