十分に有能は、Fabio Akitaによる人工知能についてのオープンな本です。2026年を舞台に、ベテランプログラマーがAIエージェントを使って実際のソフトウェアを構築し、個人ベンチマークで数十のモデルを評価し、失敗と修正を記録し、業界の発表と証拠を比較していく過程を追います。
このリポジトリには、本そのものと、その維持に使われるツールが収録されています。ポルトガル語版または英語版のプレビュー版を読んだり、完成済みの形式をダウンロードしたり、プロジェクトのRubyおよびドキュメント処理ワークフローを使ってソースからビルドしたりできます。
プロジェクトの内容
この本は、AIに不安や不確かさを感じている読者に向けて書かれています。そこには、置き換えを懸念する専門家、汎用人工知能（AGI）に関する予測を追う親、「AIトランスフォーメーション」の提案を耳にする管理職などが含まれます。そのアプローチは宣伝的ではなく、実践的かつ証拠に基づいています。
内容は5つの主要パートに分かれています。
- パートI：そもそも、これは何なのか？ AIは知的なのか、AGIは近づいているのかを検討します。
- パートII：マラソン。 印象的なデモンストレーションを超えて、AIが機能するのかを問いかけます。
- パートIII：数字とプロパガンダ。 モデルの比較と、発表を評価する方法を掘り下げます。
- パートIV：鍵を握るのは誰か？ AIシステムに個人または業務上のリソースへのアクセスを許可するリスクを考察します。
- パートV：私の仕事はどうなる？ 雇用への懸念と、考えられる次のステップを扱います。
リポジトリにはさらに、2つの幕間章、機械の内部動作を数式なしで説明する任意の付録、タイムライン、実践的なチェックリスト、144語を収録した用語集、292件の参考資料も含まれています。
本をダウンロードして読む
このプロジェクトを利用する最も簡単な方法は、リリースをダウンロードすることです。リリースページを開き、最新の版を選択してください。
- ポルトガル語版または英語版を選びます。
- 使用する端末に適した形式を選択します。
- リリースのアセットからファイルをダウンロードします。
- 電子書籍リーダー、PDFビューアー、またはお好みの読書アプリで開きます。
利用できる形式には、電子書籍リーダー向けのCompetente-o-Suficiente.epub、画面で読むためのCompetente-o-Suficiente-ebook.pdf、印刷用のCompetente-o-Suficiente.pdfがあります。英語版では、Competent-Enough.epub、Competent-Enough-ebook.pdf、Competent-Enough.pdfなど、対応する名前が使われています。
これらはプレビュー版です。本は引き続き改訂される予定で、著者が完成を宣言するまで新しいバージョンが公開される見込みです。
ビルド環境をセットアップする
ソースから本をビルドしたい場合は、リポジトリをクローンし、docs/DESIGN.mdやLICENSE.mdなどのプロジェクトファイルを確認してください。READMEでは、必要なシステム依存関係としてRuby、Java、poppler-utilsが挙げられています。
Rubyはプロジェクトのタスクを実行します。EPUB出力を検証するepubcheckにはJavaが必要です。Popplerユーティリティは、ビルド中のドキュメント関連処理を支援します。
これらの依存関係をインストールしたら、リポジトリのタスクランナーを使って、固定されたツールチェーンを取得します。
rake toolsこのタスクは、PandocとTypstを含むQuartoやepubcheckなど、文書化されたツールチェーンを準備します。
出版形式をビルドする
ツールとシステム依存関係が利用できる状態で、次を実行します。
rake buildビルドによって、EPUB、PDF、ウェブ、DOCX版がbuild/pt/以下に生成されます。また、EPUBの検証とページ監査も実行され、生成された出力の問題を検出しやすくなります。
一般的なワークフローは次のとおりです。
- Ruby、Java、
poppler-utilsをインストールします。 rake toolsを実行して、固定されたプロジェクトのツールチェーンを取得します。- ソースコンテンツを更新または確認します。
rake buildを実行します。build/pt/に生成されたファイルを確認し、検証またはページ監査で見つかった問題に対処します。
READMEには英語版用の別の出力ディレクトリについての説明がないため、英語ソースを扱う場合は、リポジトリの現在のドキュメントとタスク設定に従ってください。
ブログからの変更を追跡する
このリポジトリは、著者がakitaonrails.comに掲載する記事と同期し続けられるよう設計されています。各段落には、元になった記事が記録されています。これにより、記事が変更された際に、確認が必要になる可能性のある本の内容を特定できます。
差分チェックは次のコマンドで実行します。
rake drift
このコマンドは、ブログの変更によって影響を受ける章と、関連する差分を表示します。リリース前やソース記事の更新後に実行すると、修正が必要な箇所を把握できます。
プロジェクトの制作方針を理解する
このリポジトリでは、本を静的な文書ではなく、継続的に維持される出版物として扱っています。図はコードとして描画され、AIが生成したイラストは画像クレジットで明示され、実際の写真にはライセンス情報が付されています。このプロセスの詳細は、docs/DESIGN.mdで確認できます。
このアプローチは、テキストの出典、生成されたアセット、ライセンス情報を分離できるため、プロジェクトをレビューしたり貢献したりする際に役立ちます。ビルド成果物を再配布する前に、LICENSE.mdを注意深く読んでください。
リポジトリを扱うための高度なヒント
閲覧にはリリースを、保守にはソースを使う
読者は通常、一般的な形式向けにパッケージ化済みのリリースアセットを使用してください。書籍の構成を調べたり、ビルドを再現したり、ブログと書籍の変更点を確認したりする必要がある場合は、ソースリポジトリを使用します。
公開前に差分チェックを実行する
記事の内容を変更した場合は、rake buildの前にrake driftを実行してください。これにより、古くなっている可能性のある章を絞り込んだ一覧が得られ、生成された各版を元の記事と整合させやすくなります。
検証をビルドの工程に組み込む
ビルドタスクにはepubcheckとページ監査が含まれています。特にテンプレート、図、文書構造を変更する場合は、これらのチェックを任意の追加作業ではなく、公開プロセスの一部として扱ってください。
再利用する前にライセンスを確認する
書籍の本文、表紙、イラストの著作権はFabio Akitaが保有しています。一方、ビルドスクリプトとテンプレートにはMITライセンスが適用されます。フォント、引用スタイル、写真には、LICENSE.mdに記載された個別のライセンスが適用される場合があります。リポジトリ内のすべてのファイルに同じ再利用条件が適用されるとは限りません。
まとめ
Competent Enoughは、AIに関する批評的な書籍と、再現可能な出版ワークフローを組み合わせています。Releasesからプレビュー版をダウンロードし、rake buildで利用可能な形式をビルドできます。また、rake driftを使えば、元の記事の変更によって影響を受ける内容を特定できます。これにより、AIに関する主張を学びながら、長編の技術出版物がどのように保守されているかも探究できる実践的な方法が得られます。