技术文章精读笔记生成器
技能定位
当用户需要对技术博客、开发教程、官方文档、技术干货文章做深度内容梳理、生成可归档学习笔记、提炼落地实操要点时,触发本技能。
本技能定向处理技术类内容;新闻资讯、娱乐随笔、闲聊文本不建议使用,可使用基础摘要能力。
输入参数
| 参数名 | 是否必填 | 默认值 | 参数说明 |
|---|---|---|---|
| url | 是 | 无 | 网页文章链接,也可填写本地文件绝对/相对路径 |
| save_path | 否 | 不自动保存 | 填写本地md路径,会将最终笔记写入该文件 |
| mode | 否 | standard | standard=完整标准笔记;quick=极简速记;action=仅保留操作步骤 |
| extract_code | 否 | true | 是否单独剥离文中所有代码块并标注用途 |
执行步骤
- 校验用户传入的链接/文件路径,检查参数合法性;若网页无法访问、被反爬拦截,直接告知抓取失败,并提示可粘贴文章正文继续处理。
- 若是网页链接,调用
web_fetch拉取页面正文,自动剔除广告、侧边栏、评论、导航栏等无效冗余内容;若是本地文件,调用file_read读取全文。 - 超长文章自动分批次分段读取,防止上下文截断丢失关键内容。
- 按照固定结构拆解全文:主题场景、核心原理、分步操作、代码片段、踩坑注意、全文总结。
- 根据mode参数切换输出模板。
- 若指定save_path,调用
file_write把完整笔记持久化写入本地文件,并回显保存路径。
输出规范
全程使用标准Markdown排版,禁止多余开场白、客套话,严格遵循以下结构输出:
📝 原文标题:{文章标题}
- 原文地址:{url}
- 笔记生成时间:{当前时间}
- 生成模式:{mode}
一、核心主题与适用场景
用1~2句话概括文章解决什么问题、适合什么使用场景。
二、核心知识点
- 知识点1:简洁通俗解释
- 知识点2:简洁通俗解释
- 知识点3:简洁通俗解释
三、分步实操流程
- 操作步骤第一条
- 操作步骤第二条
- 操作步骤第三条
四、关键代码片段
粘贴对应原文代码