Book-learning-skill|代码小白制作Skill攻略

大家好啊,本篇来分享五一假期期间摸宝自己制作的 skill-一款电子书拆书学习 skill,顺便分享下我的制作及调教 skill 的流程方式,欢迎大家多多指导交流

注:以下全文不少小问题,如果不懂的都随时问 AI,它会一步步教你如何装程序、装插件等等,这篇文章主要分享我的 skill 的制作流程

零、关于 Book-learning-skill

先放 github仓库地址:https://github.com/mollycall-zmy/book-learning-skill(以下简称 BLS)

PS:依旧还是没有代码经验的我,这个 skill 包括里面的 Readme 所有介绍内容,都是 AI 自己完成并推送到 github 的哦!

一、What&Why-它是什么

Book-learning-skill 是一款拆书 skill,它把“学习一本书”拆成一组明确步骤:转换文档、提取目录、拆分章节、逐章提炼、审计遗漏,再产出一份可读、可追溯的完整阅读笔记。阅读笔记完成后,还可以进入第二阶段,把书中的方法提炼为可调用的思维工具。

简单来说,它把我们的电子书转成 md 格式,可以纳入我的知识库(知识库搭建思路见上一篇文章→【Hermes Agent 知识库搭建思路】),并创建对应的知识卡和气味向量,可供 AI 学习。这样我除了可以把文章丢给 Agent,也可以让 AI 代替我快速阅读书籍并学习里面的框架知识,并且生成一个阅读笔记可以帮助我手动复习书籍内容。

市面上有非常多的拆书 skill,我稍微搜索了一下,发现都不满足我目前对拆书 skill 的需求:

1、可以把主流的 epub、pdf 等转成 md 格式

2、按照原知识库的结构,要在 raw 层保留图书原文,并且单独制作图书阅读笔记

3、阅读笔记有对全书的总结、分章节小结、全书脉络和金句等,方便快速浏览全书

4、添加气味向量,方便后续调用

如果你发现市面上的 skill 都无法满足需求,或者怎么用都不习惯,那么可以尝试自己做 skill 哦!

二、Skill 制作过程-你需要的工具

如果你和我一样没有代码经验,是代码小白,那么可以参考我的傻瓜式流程(欢迎程序员和产品大佬们多多指导)

以 Book-learning-skill 的开发为例(后续简称 BLS),它目前涉及到的工具或平台有:

①Gemini:用于初期想法的建设沟通,以及过程中结构方面的讨论和审核(在我看来 Gemini 感性层面处理的比较好,比如对一个工具的使用场景等等,比我想的要全面)

②ChatGPT+Codex:使用 codex 帮我写代码。如果 Gemini 和 ChatGPT 里只能选一个,那么选 ChatGPT(毕竟19.9刀一个月可以有 codex)

③VS Code:微软出的开发工具(请官网下载,免费:https://code.visualstudio.com/

④Hermes:或者 OpenClaw,或者 CC,总之是你用来测试的 Agent(也就是小虾或小马)

⑤Obsidian:时时查看它生成的 md 文档,以及在知识库的位置

⑥VS Code:微软出的开发工具(请官网下载,免费:https://code.visualstudio.com/

(你发现没有,咱们的知识点都串起来了,如果你觉得很难,那么前面每一个可能都需要单独学一学,有些知识可以在 MW Wiki 里搜索各自的关键词)

三、BLS 的制作流程

我们要知道,skill 不是一蹴而就的,需要不断测试和调整,逐渐长成自己想要的状态。(也正因为制作了 skill,我发现所谓的把同事的文档蒸馏成 skill 其实只是个概念,实用性上未必如此,虾都这么难养,何况人呢)

1、先有一个想法

我最初的想法,也只是把电子书变成 md 格式,有一个书籍 md 和笔记 md。目前电子书的主流格式有:EPUB、PDF、MOBI/AZW3、TXT 等等,最通用的是 EPUB,一些图片类的或者转印书籍以 pdf 为主,所以我先找到了两种(问 ChatGPT 就行):

(遇事不决请先问 AI)

我们拿到 ChatGPT 的结果,就拿到虾里再问,让虾选方案(包括用 epub 转成 md 格式的方法我也问了虾,在此处略过)

安装了初步的 pdf 和 epub 转 md 后,我开始第一次尝试把书转成 md 测试

对应你就会发现 agent 出现的问题,并逐渐明细我们的 skill 要满足的需求

多轮撮合之后,利用虾理解上下文的特性,让虾或者 ChatGPT 给出初步的skill brief(因为你的虾更清楚它的工作逻辑,因此初步 brief 让虾来给,当然,你也可以跟 ChatGPT 或 Gemini 多聊聊,然后把方案一股脑丢给它):

2、写代码前的准备工作

首先安装 VS Code,并且调整成中文版(不知道怎么调中文的问 AI):官网下载地址→https://code.visualstudio.com/

安装 VS Code 的 codex 插件(这样等于让 codex 可以在 VS Code 里直接给你操作写代码、推送到 github 仓库)

问:“如何在 VS Code 里安装 codex 插件”

(让 C 老师教你如何在 VS Code 里装插件)

注册一个 github 账户(需要科学上网),并且在 github 上建立一个仓库(你可以选择公开或者私有)。关联你的 VS Code 和 github,这样后续你不需要自己在 github 上传代码,codex都会自动给你操作完成

问:“如何关联 VS Code 和 github 账户?让 codex 后续可以自动推送代码到 github 上?”

(G 老师的回答对代码小白更友好,如果你不说你不懂,ChatGPT 会默认你很懂,然后他就会说你看不懂的)

这两步做完,你就可以准备让 AI 开始搓代码了!

3、使用 VS Code 里的 Codex 插件来写代码

因为我用 token 不太费,所以直接用 codex 来搓了,有的同学可以在 VS Code 里接大模型来写,让 codex 来审核也是可以的,这块我没有按这个操作,直接让 codex 写了

在你的本地电脑上找一个位置建立这个 skill 的代码仓库,用 VS Code 来打开

打开后,你会看到空空如也,没关系,打开右边 codex 的插件,记住右下角这个窗口,后面你主要在这个窗口里对话即可

在开干之前,我们要先理解 ChatGPT 和 codex 的区别:

ChatGPT = 军师 / 产品经理 / 架构师
负责帮你想清楚:要做什么、为什么这么做、怎么拆任务、怎么写需求、怎么审查方案。

Codex = 程序员 / 执行工程师
负责在 VS Code 里看你的项目文件、改代码、跑命令、修 bug、提交 commit,甚至 push 到 GitHub。官方说 Codex 是用于软件开发的 coding agent,可以读、改、运行代码,也能帮你写代码、review 和发布代码。

所以,我们的流程就是,把 skill 方案和虾、Gemini、ChatGPT 聊透,最后让 ChatGPT 给出 codex 的 brief,直接贴进去即可,咱们不懂代码,就不要直接跟 codex 对话(过程中虽然会出现有点啰嗦的情况,但保险起见,这么操作不会出现明显的错误)

(C 老师会直接给你 codex 的 brief,贴到刚才我们的那个窗口里即可)

然后你就会发现, codex 开始变魔法一样,自动写代码,左侧的文件夹和中间的代码区都会自己变出来了~

写完代码后,我们跟 codex 讲:“推送 github”,它就会自动推到 github 里,然后我们 github 的仓库就会从空白自动变成这样⬇️

这就是我们初步制作好的 skill~

4、不断的测试、调整

制作好 skill 后,我们就可以丢给虾来测一下实用性了

然后不断的根据具体情况,来让虾出修改方案→丢给 ChatGPT 出 codex brief→在 VS Code里 codex 插件改代码、推 github→再测试

不断循环,逐渐调整为我们想要的 skill

基本上到现在我的 skill 调整了五六版,从一开始只会出机械模板样式的阅读笔记,到现在它可以这样⬇️

(有一定的UI 设计的流程图、可以针对不同的电子书类型按照不同模板出笔记)

大致上就是这样的一个流程,现在 AI 可以让小白只要有一个想法,就可以生成一个网页、skill 等等,我们要做的就是给想法、测试、调整,直到它逐渐成为我们想要的样子,快来尝试看看吧!也欢迎你来跟 MW 分享喔

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注