ai产品经理拿到新项目代码的第一件事情——分享一个将项目文档和代码转化为一本可视化的books的skills

本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：

• 我的帖子已经打上 开源推广 标签： 是


• 我的开源项目完整开源，无未开源部分： 是


• 我的开源项目已链接认可 LINUX DO 社区： 是


• 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是


• 以上选择我承诺是永久有效的，接受社区和佬友监督： 是

以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出

skills的具体链接如下：

事情是这样的，本人作为ai产品经理初步接手公司项目的时候，发现项目的文档混乱，没有序号顺承，结构混乱，并且文档和实际的项目开放严重错位。而且文档写的十分晦涩，在vscode里面没有渲染的markdown文档看着也费劲。这十分影响我了解项目的业务逻辑和思路。

于是考虑在fable和deepseek的帮助下制作了一个skills——doc-to-books，简单来说，这个skills的作用就是让agent先详细阅读项目的全部doc文档，然后再仔细读取项目的实际代码运行情况，然后优先将doc转化为可视化的有顺序的有逻辑的html的文档书籍。然后再适当结合代码进行修正。

考虑到公司的代码不能轻易泄露，故借助hermes项目进行辅助讲解（注：以下截图的books由deepseek-v4-pro完成）

Skills的使用效果 如 下

1.给doc文档增加了目录，并且尽量按照有逻辑性的顺序安排目录顺序，并且支持快捷跳转查看特 定章节

2.大模型会安排它认为合适的阅读路线，或者基于不同的项目接手角色 去进 行 推荐查 阅

3.本书全文支持关键词检索，方便进行 快速 定 位查阅 某 些片 段

4.book支持可视化的分层架构图、时序 图等 ，并且支 持 放大查 阅

5.agent会进行审阅doc文档和我们实际项目代码有所差异的地方，一般放在 最 后作为 “漂 移 清单存在 ”

6 . bo ok 支 持 亮色和暗色 模 式切换

推荐使用模型fable＞opus>deepseek v4 pro=glm 5.2>minimax m3=kimi 2.7

其实主要就是要一百万上下文，有足够的上下文窗口详细查看项目代码和全部文档、

使用方法如下，将全部内容发给claude code就行：

1.安装skills

https://github.com/lili-luo/aicoding-cookbook/tree/main/skills/claude%20code/docs-to-book 安装此skills

2.使用goal模式启动制作books

/goal 使用docs-to-books这个skills，先深入查阅项目的文档，再浏览具体的全部项目代码，最后，请你梳理理顺整个项目的代码逻辑和流程逻辑，最后形成一本人易读的、有逻辑性的、全面的、有阅读顺序的books。

下面这里有一个结果，可以下载查阅一下看看实际效果

文档可视化.zip (1.3 MB)