AgentSkillsCN

gongzhonghao-notes

公众号学习笔记写作助手。用于撰写学习笔记类公众号文章,特点是协作式写作(AI提问配合用户思考)、分章节逐步完善、保持定义与个人思考的平衡。触发场景:(1) 用户说"帮我写一篇学习笔记" (2) 用户说"帮我整理一下某个知识点的笔记" (3) 用户讨论某个概念想要写成文章

中文原作
SKILL.md
--- frontmatter
name: gongzhonghao-notes
description: 公众号学习笔记写作助手。用于撰写学习笔记类公众号文章,特点是协作式写作(AI提问配合用户思考)、分章节逐步完善、保持定义与个人思考的平衡。触发场景:(1) 用户说"帮我写一篇学习笔记" (2) 用户说"帮我整理一下某个知识点的笔记" (3) 用户讨论某个概念想要写成文章

公众号学习笔记写作

Overview

这是一个协作式公众号写作skill,专注于帮助用户撰写学习笔记类文章。不同于直接生成文章,这个skill强调与用户一起思考的过程——AI通过提问帮助你厘清想法,你主导内容,AI负责整理成结构化的文字。

核心原则:

  • 你(用户)是内容的主导者,核心观点、例子、感悟都来自你
  • AI负责通过提问帮你梳理思路,并整理成结构化的文字
  • 每个章节保持"定义/定理 → 图解/直觉 → 个人思考"的节奏

工作流程概览

code
第一步:确定核心观点
↓
第二步:设计大纲(用户确认)
↓
第三步:逐章撰写(循环)
↓
第四步:整体润色

第一步:确定核心观点

这是最重要的一步。

在开始写之前,你需要明确:

  1. 本文最核心的观点是什么?(一句话概括)
  2. 写这篇文章的动机是什么?(为什么想写这个主题?)
  3. 读者能从中获得什么?

AI的引导方式:

AI会问你类似以下问题:

  • "关于这个主题,你最想分享的一个观点是什么?"
  • "你觉得读者最容易困惑的点是什么?"
  • "有没有一个例子/比喻能帮助你解释这个概念?"

产出: 一段核心观点描述,作为整篇文章的锚点。


第二步:设计大纲

基于核心观点,AI帮助你设计文章结构。

标准大纲模板:

code
## 00 引言
- 写作动机/背景介绍
- 本文目标/结论预告

## 01 [核心概念1]
### 1.1 定义/定理(标准数学/理论表达)
### 1.2 图解/直觉(用自己的话解释)
### 1.3 小结

## 02 [核心概念2]
...

## 03 实际应用/例子
...

## 04 总结与思考
- 本文总结
- 个人感悟/延伸

## 参考文献

用户确认后开始撰写。 如果需要调整章节结构,随时可以修改。


第三步:逐章撰写(核心循环)

这是skill的核心部分。每一章的撰写都遵循这个流程:

3.1 选择起点

AI会问: "你想从哪一章开始?"

3.2 提问引导

AI通过提问帮助你思考,而不是直接给你内容。

示例问题:

  • "关于这个概念,你能用自己的话说一下吗?"
  • "有没有一个图或者比喻可以帮助解释?"
  • "你觉得这里最关键的一点是什么?"
  • "你有没有遇到过什么例子可以印证这个观点?"
  • "关于这个结论,你有什么不同的看法或者补充吗?"

3.3 记录你的回答

用户口述/打字回答,AI记录关键点。

3.4 整理成文

AI把你的想法整理成结构化的文字,格式:

code
### X.X 概念名称

**定义/定理:**
> [标准数学/理论表达]

**直觉/图解:**
[用你自己的话解释,可以包含:
- 比喻
- 图解描述
- 直观理解]

**小结:**
[一句话概括]

3.5 你的反馈

你阅读后告诉AI:

  • 哪里需要修改
  • 哪里需要补充
  • 或者"ok,继续下一章"

3.6 循环

重复步骤3.1-3.5,直到所有章节完成。


第四步:整体润色

当所有章节完成后,AI会检查:

  1. 逻辑连贯性:章节之间是否衔接自然?
  2. 风格统一:定义与思考的比例是否平衡?
  3. 结尾质量:总结与思考部分是否有力?
  4. 参考文献:是否需要补充引用?
  5. 去AI味检查:应用去AI味指南进行风格优化

去AI味检查(按 references/anti-ai-style.md):

  • 删除过度使用的衔接词(首先、其次、因此...)
  • 打破过于工整的句式,长短句交错
  • 删除"综上所述"、"总之"等总结性语句
  • 用具体例子/故事代替抽象描述
  • 增加口语化表达和互动感
  • 结尾留白而非展望未来

你确认后,文章完成。


风格指南

定义部分

  • 使用标准的数学/理论语言
  • 保持严谨性
  • 引用权威来源

思考部分(你主导)

  • 用自己的话解释(不是复述教科书)
  • 加入图解/比喻/直觉理解
  • 记录个人感悟("笔者认为"、"直观上...")
  • 可以有个人风格的小吐槽

比例建议

  • 定义:约40%
  • 图解/直觉:约30%
  • 个人思考/感悟:约30%

References

详细的大纲模板和写作模式参考:


附加功能

GitHub查询

你可以让我帮你查询GitHub上的项目信息。

使用方式:

  • "帮我查一下GitHub上的xxx项目"
  • "看看xxx项目的README"
  • "搜一下GitHub上关于xxx的仓库"

我会使用WebFetch工具读取GitHub公开页面,帮你获取:

  • 项目基本信息(star数、描述)
  • README内容
  • 关键文档

示例:

  • "帮我查一下spring-boot这个项目"
  • "看看react的官方文档"

从PDF提取知识

你可以让我从PDF文件中提取知识内容作为写作素材。

使用方式:

  1. 告诉我PDF文件的路径(如 D:\文档\课本.pdf
  2. 告诉我你想提取的内容:
    • "帮我提取第10-20页的内容"
    • "找出关于xxx章节的内容"
    • "提取所有关于xxx概念的定义"

流程:

  1. 我会读取PDF指定页面或搜索相关内容
  2. 提取关键段落和知识点
  3. 将提取的内容整理成结构化笔记
  4. 你可以基于这些素材进行公众号写作

参考: references/writing_patterns.md 中的"PDF知识提取"部分。


导入AI对话内容

你可以把AI对话(如Gemini、ChatGPT等)的内容导入作为写作素材。

使用方式:

  1. 直接复制粘贴

    • 把对话内容复制给我
    • 告诉我"以下是和AI的对话,帮我整理成笔记"
  2. JSON格式(可选)

    • 如果你有对话的JSON格式数据,可以提供给我
    • 我会解析其中的核心观点和问题解答

处理流程:

  1. 我会分析对话内容
  2. 提取关键概念、定义、例子
  3. 整理成结构化的笔记格式
  4. 你可以基于这些素材撰写公众号文章

示例:

  • "以下是我和Gemini讨论xxx的对话,帮我提取核心观点"
  • "这是我学习xxx时和AI的问答,帮我整理成笔记"

预览功能

写完的文章可以一键预览排版效果。

使用方式:

  1. 首先保存当前内容到公众号临时文件:

    • 告诉用户当前内容
    • 用户确认后,将内容保存到 D:\公众号\temp_preview.md
  2. 运行预览脚本:

    • 在PowerShell中执行:powershell -File "C:\Users\scott\.claude\skills\gongzhonghao-notes\scripts\preview.ps1"
    • 脚本会自动打开markdownnice网站并将内容复制到剪贴板
    • 用户按 Ctrl+V 粘贴即可预览

提示: markdownnice支持微信公众号排版导出,可以在预览后直接复制到公众号后台。


去AI味

文章完成后,我会按照去AI味指南进行检查和优化:

  1. 检查常见AI特征

    • 过度使用的衔接词(首先、其次、因此...)
    • 过于工整的句式
    • 正确的废话
    • 过度总结
  2. 应用风格技巧

    • 疑问开头增加互动感
    • 长短句交错制造节奏
    • 用具体例子代替抽象描述
    • 适当加入口语化表达
  3. 检查清单

    • 删除不必要的过渡词
    • 用故事/例子代替总结
    • 增加个人风格(吐槽、自嘲)
    • 结尾留白而非展望未来

参考: references/anti-ai-style.md 包含详细的去AI味方法和示例。