技能介绍

解决长文阅读的留存问题

日常开发中，我们经常遇到几十页的技术博客、框架迁移文档或底层原理解析。这类长文读完后很容易遗忘，如果只是放进收藏夹，后续很难再检索。手动复制到笔记软件并提炼要点，既费时间又容易漏掉关键配置。

这个技能面向工程实践场景，专门处理技术类长文。它会先抓取原始网页或读取本地文件，然后自动剔除广告、侧边栏、评论等冗余内容，直接提取正文核心。

结构化笔记的生成逻辑

技能的核心在于将碎片化的技术文章转换成高度规范化的 Markdown 笔记。生成过程遵循固定的技术拆解逻辑：

场景定位与原理解析：先用 1-2 句话概括文章解决的具体工程问题，并提炼出底层的核心知识点。
分步实操流程：将文章中的实现步骤还原为有序列表，剥离多余的背景铺垫。
关键代码剥离：通过 extract_code 参数，自动提取文章中的所有代码块。
坑点提示与总结：专门提取作者提到的踩坑记录和注意事项，方便避雷。

根据 mode 参数的不同，笔记的颗粒度会有所调整。standard 模式适合系统性学习和归档，生成包含六大板块的完整笔记；quick 模式则更轻量，适合在快速查阅时只保留核心原理；action 模式专门针对工具类文章，过滤掉所有背景介绍，只保留可直接复制的操作步骤。

归档与工程化边界

对于需要沉淀为团队文档的内容，可以通过 save_path 参数将生成的笔记直接写入本地。这避免了手动保存带来的目录混乱，方便配合 git 进行版本管理。

需要注意的是，该技能具有明确的领域边界。它依赖 web_fetch 或 file_read 获取输入，如果在抓取时遇到反爬机制，会直接提示失败并引导用户粘贴正文，此时需使用本地文件路径作为输入的替代方案。此外，技能的结构化逻辑是为技术干货设计的，不建议用于新闻资讯、娱乐随笔或非结构化的闲聊文本，这类场景请使用基础摘要能力，以获得更好的效果。