足够胜任是 Fabio Akita 撰写的一本关于人工智能的开放式书籍。它记录了一位资深程序员在 2026 年期间使用 AI 代理构建真实软件、在个人基准测试中评估数十个模型、记录错误与修正过程，并将行业公告与证据进行比较。
该仓库同时包含书籍内容以及维护书籍所使用的工具。你可以阅读葡萄牙语或英语预览版，下载已完成的格式，或使用项目的 Ruby 和文档处理工作流自行构建源文件。
项目包含的内容
本书面向对 AI 感到焦虑或不确定的读者，包括担心被取代的专业人士、关注通用人工智能预测的家长，以及不断听到“AI 转型”提案的管理者。它采用务实、基于证据的方法，而非宣传式的立场。
内容分为五个主要部分：
- 第一部分：这东西到底是什么？ 探讨 AI 是否具备智能，以及 AGI 是否正在逼近。
- 第二部分：马拉松。 追问 AI 是否能超越令人印象深刻的演示真正发挥作用。
- 第三部分：数字与宣传。 探索模型比较，以及如何评估各种公告。
- 第四部分：谁掌握钥匙？ 思考允许 AI 系统访问个人或运营资源所带来的风险。
- 第五部分：那我的工作怎么办？ 讨论就业方面的担忧和可能的下一步。
仓库还包含两个插章、一个可选的无数学附录（解释机器内部的工作方式）、时间线、实用检查清单、包含 144 个术语的词汇表，以及 292 条参考资料。
下载并阅读本书
使用该项目最简单的方式是下载发行版本。打开 Releases 页面，选择最新版本。
- 选择葡萄牙语或英语版本。
- 选择适合你设备的格式。
- 从发行版本的资源中下载文件。
- 使用电子阅读器、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 用于运行项目任务。epubcheck 需要 Java 来验证 EPUB 输出。Poppler 工具则用于支持构建过程中的文档处理。
安装这些依赖后，使用仓库的任务运行器获取其锁定版本的工具链：
rake tools该任务会准备文档中所述的工具链，包括带有 Pandoc 和 Typst 的 Quarto，以及 epubcheck。
构建出版格式
工具和系统依赖就绪后，运行：
rake build构建过程会在 build/pt/ 下生成 EPUB、PDF、网页和 DOCX 版本。同时还会执行 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 相关论断，也能了解一份长篇技术出版物是如何维护的。