| name | takenote |
| description | 当用户想记录一条笔记、输入一段原始想法、整理会议内容、保存学习摘要、处理 PDF 或图片等附件,或明确提到 "/takenote"、"记一下"、"帮我整理成笔记" 时使用。 |
| version | 0.3.0 |
takenote
这个 skill 用来把用户当前输入的内容整理成一条正式笔记,并写入这个笔记库。
默认假设用户提供的是“原始素材”,不是已经整理好的笔记。不要要求用户先想好标题、标签、分类或文件夹,先接住内容,再按规则归档。
先读什么
- 先读取仓库根目录的
CLAUDE.md。
- 如果任务需要个性化判断,再读取
1_关于我/个人背景.md。
- 确定目标目录后,先读对应目录下的
_index.md,再读可能相关的已有笔记。
输入类型判断
先判断用户输入属于哪一类,再决定处理方式:
- 原始文本:想法、随手记、摘要、问题、项目进展
- 会议内容:会议纪要、讨论记录、决策项、待办
- 学习材料:课程笔记、读书摘录、文章摘要
- 研究材料:调研问题、分析框架、文献摘要
- 行政材料:汇报提纲、流程记录、制度说明
- 代码材料:代码片段、技术备注、实现思路
- 附件输入:PDF、图片、截图、邮件导出、录音转写、网页链接
- 已有笔记修改:用户明确要求合并、续写、更新某篇现有笔记
通用处理流程
- 判断内容类型和最合理的落点。
- 搜索相关
_index.md 和已有笔记,判断应该新建还是更新。
- 生成一个清晰、自然的中文标题。
- 按
CLAUDE.md 里的格式写成正式笔记。
- 在
## Related 中补充真实存在的相关笔记。
- 在
## Source 中写明原始来源,比如用户输入、附件路径、网页链接。
- 同步更新对应目录下的
_index.md。
- 最后简要告诉用户创建或更新了什么文件。
各类输入怎么处理
1. 原始文本
- 直接把内容整理成一条正式笔记。
- 不照抄原话,先消化再写成结构化内容。
- 如果内容更像一个短灵感,优先放进
2_想法/。
- 如果内容明显对应当前项目、执行记录或任务推进,优先放进
3_工作/。
2. 会议内容
- 提炼出会议信息、讨论要点、决策和待办。
- 默认放进
5_会议/。
- 如果会议本质是在推进某个项目,可以在
## Related 里链接相关工作笔记。
3. 学习材料
- 先提炼核心观点,再补“这对我有什么用”。
- 默认放进
4_学习/。
- 如果已经明显演化成专题分析,也可以放进
6_研究/。
4. 研究材料
- 重点保留研究问题、当前判断、待补材料和下一步。
- 默认放进
6_研究/。
5. 行政材料
- 重点整理成提纲、事项、流程或汇报结构。
- 默认放进
7_行政/。
6. 代码材料
- 重点保留场景、做法、限制和提醒。
- 默认放进
9_代码/。
7. 附件输入
如果用户输入里包含文件路径、附件名或链接,先判断附件类型。
PDF 文档
- 先读取 PDF 内容或用户给出的摘要。
- 判断它是学习材料、研究材料、会议附件还是工作资料。
- 如果 PDF 只是原始材料,附件本体应保留在
8_附件/,再另外生成一条摘要或整理笔记。
- 在
## Source 中写明 PDF 路径。
- 不要把 PDF 文件本身移动到别的知识目录里。
图片或截图
- 先判断图片是在传达会议白板、PPT 页面、聊天记录、图表还是随手拍的资料。
- 如果能提炼文字信息,就整理成正式笔记。
- 如果只是原始证据或素材,保留图片在
8_附件/,并在笔记里引用路径。
邮件导出、聊天记录、录音转写
- 先去噪,再提炼出事实、决策、待办和关键上下文。
- 根据内容落到
3_工作/、5_会议/ 或 7_行政/。
- 原文件作为附件保留在
8_附件/。
网页链接
- 先读取网页内容,再判断是学习、研究还是资料收藏。
- 如果只是收藏链接而没有进一步整理价值,可以记成简短笔记并注明链接来源。
- 如果内容需要长期使用,应整理成正式摘要笔记,而不是只贴 URL。
8. 已有笔记修改
- 如果用户明确说“合并到某篇笔记”“更新某篇笔记”“续写这篇笔记”,先读目标笔记。
- 按
CLAUDE.md 的安全规则处理;涉及修改已有内容时先确认。
- 更新后同步刷新该目录的
_index.md。
附件处理原则
8_附件/ 只放原始附件,不放最终整理后的正式笔记。
- 正式笔记应放在
2_想法/ 到 9_代码/ 的对应目录。
- 附件本体和整理结果通常是两份东西:一个保留原文,一个保留理解和提炼。
处理要求
- 默认把用户输入视为原始素材,先帮用户整理,再决定标题和落点。
- 如果落点不明确,可以先给出一个最合理的放置方案;只有在风险明显时才追问。
- 如果需要修改已有笔记,先按
CLAUDE.md 的安全规则确认。
- 输出用自然中文,不要写成命令说明书。
- 只链接真实存在的笔记,不要凭空创建空链接。
- 不要依赖任何个人专属 agent、绝对路径或私有工作流。
最终汇报格式
完成后,用很短的话告诉用户:
- 新建还是更新了哪一条笔记
- 文件放在哪个目录
- 如果用了附件,附件路径记在了哪里