文档破破烂烂，opus缝缝补补
- 内容介绍
- 文章标签
- 相关推荐
最近在造轮子的过程中经常需要参考和调用一些第三方库。然而一些库的文档经常不够完善，要么是只讲了一些基本的用法，一些功能更丰富的 API 藏在几层链接后的某个角落里，要么是直接没有文档，甚至没有代码注释。
于是被迫让agent自己去读整个库的源码，捋清楚每个函数的功能和用法，最后再生成一份给人读的文档和 API Reference。
最开始用的是各位大佬的公益站，猛猛蹬 opus 4.6（其实是读代码是 haiku）。虽然扫描源码花了大量的 token，但是相应的产出质量是非常高的。文档内容完善、结构清晰，还会恰如其分地包含一些使用示例，极大地提升了开发效率。
然而最近公益站的服务不太稳定，时不时就访问不了。于是我又尝试了一下 codex，结果发现质量参差不齐，有些工具生成的文档内容非常简略，语言表达也不够流畅。和 opus 4.6 生成的文档相比，落差大到有些不适应。
这里放一个例子，这是 5.3 codex 生成的文档片段：
图片1249×10625 855 KB
其实效果也还可以了，列出了很多文档没有讲过的接口，也能节省我很多时间。
但是在细读的过程中，codex 没有按照从简单到复杂的逻辑顺序组织，经常会给出当前还没有定义过的内容，硬着头皮读到后面才发现 codex 没有漏说明。但也因此读起来磕磕绊绊的。
一怒之下，还是回到 opus 4.6，用同样的 prompt 再生成一个文档：
图片1260×18787 1.82 MB
突然一下那种把饭喂到嘴里的感觉又回来了。所有概念都是先定义后使用，并且是循序渐进揭露 API 的进阶参数的。不存在看 API 文档那种瞬间被大量概念和参数轰炸的感觉，读起来非常顺畅。
总之，opus 在我心理绝对是无可替代独一档的存在。
opus 和 codex 都用的是目前最新版本的 cc 和 codex，没装任何 Skills（目前看下来没看到什么好用的 Skills，网上大多是web前后端相关的，还占用上下文空间，各位佬们对类似的场景有好用的 Skills 也可以推荐一下）
网友解答：--【壹】--：
sonnet4.6 呢？
--【贰】--：
是的，我也和楼主有同样的感觉。前段时间让gpt 5.2和opus4.6分别针对本地项目编写文档，能明显看出opus4.6的质量更高，gpt就和许多佬友提到的一样适合吭哧吭哧默默干活，找bug修bug（属于是人狠话不多）。opus写文档很不错，但是费用高也是缺点。
--【叁】--：
我直接搜增强版 codex 出来的是这个
GitHub - stellarlinkco/codex: The open source coding agent. openai anthropic...
The open source coding agent. openai anthropic gemini
看起来是多加了 agent 编排并行之类的？
--【肆】--：
codex编码能力强，但相应的语言逻辑和表达能力差到可怕。它能清晰说明它的改动目的和思考方向，适合写注释。但它绝对不适合写长文档，读起来难受。
--【伍】--：
对 是这个，佬友做的，我用这个加golutra好用极了
image1306×811 70.2 KB
--【陆】--：
用增强版的codex试试
--【柒】--：
确实，但是没找到好办法同时让 opus 统领和总结，codex 探索代码。之前在站内好像看到过有佬友尝试，但过程非常麻烦。最近没刷到不清楚怎么样了。
--【捌】--：
个人感觉sonnet的中文文字能力和deepseek差不多
--【玖】--：
占内存吗
--【拾】--：
用来用去还是原版好用
--【拾壹】--：
codex 写代码的能力暂时还没明显的感觉，但是 codex 写注释的时候那种点到为止的感觉又出来了，戳一下动一下。不知道是不是之前 GPT-4 修复一行一句注释的时候矫枉过正了。
--【拾贰】--：
gpt写代码我觉得不带codex后缀的比带codex后缀的思考的更久，但是写出来的质量和找bug的能力更强（xhigh模式）
--【拾叁】--：
我现在已经换codex桌面版了
最近在造轮子的过程中经常需要参考和调用一些第三方库。然而一些库的文档经常不够完善，要么是只讲了一些基本的用法，一些功能更丰富的 API 藏在几层链接后的某个角落里，要么是直接没有文档，甚至没有代码注释。
于是被迫让agent自己去读整个库的源码，捋清楚每个函数的功能和用法，最后再生成一份给人读的文档和 API Reference。
最开始用的是各位大佬的公益站，猛猛蹬 opus 4.6（其实是读代码是 haiku）。虽然扫描源码花了大量的 token，但是相应的产出质量是非常高的。文档内容完善、结构清晰，还会恰如其分地包含一些使用示例，极大地提升了开发效率。
然而最近公益站的服务不太稳定，时不时就访问不了。于是我又尝试了一下 codex，结果发现质量参差不齐，有些工具生成的文档内容非常简略，语言表达也不够流畅。和 opus 4.6 生成的文档相比，落差大到有些不适应。
这里放一个例子，这是 5.3 codex 生成的文档片段：
图片1249×10625 855 KB
其实效果也还可以了，列出了很多文档没有讲过的接口，也能节省我很多时间。
但是在细读的过程中，codex 没有按照从简单到复杂的逻辑顺序组织，经常会给出当前还没有定义过的内容，硬着头皮读到后面才发现 codex 没有漏说明。但也因此读起来磕磕绊绊的。
一怒之下，还是回到 opus 4.6，用同样的 prompt 再生成一个文档：
图片1260×18787 1.82 MB
突然一下那种把饭喂到嘴里的感觉又回来了。所有概念都是先定义后使用，并且是循序渐进揭露 API 的进阶参数的。不存在看 API 文档那种瞬间被大量概念和参数轰炸的感觉，读起来非常顺畅。
总之，opus 在我心理绝对是无可替代独一档的存在。
opus 和 codex 都用的是目前最新版本的 cc 和 codex，没装任何 Skills（目前看下来没看到什么好用的 Skills，网上大多是web前后端相关的，还占用上下文空间，各位佬们对类似的场景有好用的 Skills 也可以推荐一下）
网友解答：--【壹】--：
sonnet4.6 呢？
--【贰】--：
是的，我也和楼主有同样的感觉。前段时间让gpt 5.2和opus4.6分别针对本地项目编写文档，能明显看出opus4.6的质量更高，gpt就和许多佬友提到的一样适合吭哧吭哧默默干活，找bug修bug（属于是人狠话不多）。opus写文档很不错，但是费用高也是缺点。
--【叁】--：
我直接搜增强版 codex 出来的是这个
GitHub - stellarlinkco/codex: The open source coding agent. openai anthropic...
The open source coding agent. openai anthropic gemini
看起来是多加了 agent 编排并行之类的？
--【肆】--：
codex编码能力强，但相应的语言逻辑和表达能力差到可怕。它能清晰说明它的改动目的和思考方向，适合写注释。但它绝对不适合写长文档，读起来难受。
--【伍】--：
对 是这个，佬友做的，我用这个加golutra好用极了
image1306×811 70.2 KB
--【陆】--：
用增强版的codex试试
--【柒】--：
确实，但是没找到好办法同时让 opus 统领和总结，codex 探索代码。之前在站内好像看到过有佬友尝试，但过程非常麻烦。最近没刷到不清楚怎么样了。
--【捌】--：
个人感觉sonnet的中文文字能力和deepseek差不多
--【玖】--：
占内存吗
--【拾】--：
用来用去还是原版好用
--【拾壹】--：
codex 写代码的能力暂时还没明显的感觉，但是 codex 写注释的时候那种点到为止的感觉又出来了，戳一下动一下。不知道是不是之前 GPT-4 修复一行一句注释的时候矫枉过正了。
--【拾贰】--：
gpt写代码我觉得不带codex后缀的比带codex后缀的思考的更久，但是写出来的质量和找bug的能力更强（xhigh模式）
--【拾叁】--：
我现在已经换codex桌面版了