permanent-note-generator

Permanent Note Generator

Core Task

Identify and extract valuable knowledge points from the articles provided by the user, and transform them into permanent notes that conform to the Zettelkasten methodology. Each note must follow the principle of atomicity (one note contains only one idea), and ensure contextual independence and independent understandability.

Workflow

1. Check Processing History (Check History)

Before starting processing, you must check the .claude/skills/permanent-note-generator/data/processed_history.md file:

• Read the contents of this file.
• Check whether the target article's filename or title already exists in the list.
• If yes: Inform the user when this article was previously processed, and ask whether to "skip" or "reprocess".
  • If the user chooses to skip, end the task.
  • If the user chooses to reprocess, continue to the next step.
• If no: Proceed directly to the next step.

2. Read and Understand the Article

• Carefully read the full text of the article provided by the user
• Identify the core arguments, key concepts, important evidence, practical methods, and mental models in the article
• Understand the context and meaning of each knowledge point

2. Identify Note Types and Extract Content

You must first read references/永久笔记内容类型.md, to understand the requirements for note types: For each identified knowledge point, determine which type it belongs to, and label content_type。

3. Apply Writing Standards

You must first read references/永久笔记写作规范.md, to ensure each note meets the writing requirements:

4. Generate Permanent Note Files

You must first read assets/永久笔记模板.md Create an independent Markdown file for each note: The file must use Chinese

6. Batch Output and Recording

• Generate all identified permanent notes at once
• Each note must be saved as an independent .md file
• Update History Record: Append the processed article information to the .claude/skills/permanent-note-generator/data/processed_history.md file.
  • Suggested format:- [YYYY-MM-DD] [[文章标题]] (路径: 文章文件路径)
• At the end, provide a generation summary listing all generated notes and their types, and confirm that the history record has been updated.

Quality Checklist

Before generating each note, confirm:

• Does the note contain only one core idea?
• Can it still be understood when separated from the original text?
• Are complete sentences used instead of keywords?
• Is it rewritten in your own words rather than copied from the original text?
• Is the title specific and descriptive?
• Is content_type correctly labeled?
• Have all necessary frontmatter fields been filled in?

User Interaction

Input:

• The user provides article content (which can be text, a file path, or a URL)

Output:

• Multiple independent permanent note .md files
• Generate a summary (including the number of notes, type distribution, and file list)

Example dialogue:

用户：请帮我从这篇文章中生成永久笔记 [提供文章]
助手：[阅读文章并分析] 我从这篇文章中识别出了 8 条永久笔记：
- 3 条观点/论点笔记
- 2 条概念/定义笔记
- 2 条事实/证据笔记
- 1 条思维模型/原则笔记

现在为您生成这些笔记...
[生成所有笔记文件]

Notes

1. Maintain neutrality: When generating conceptual and factual notes, ensure objective statements and do not add personal opinions
2. Avoid over-splitting: Do not forcibly split naturally related content, but also ensure atomicity
3. Value composability: The generated notes should be able to link and combine with notes on other topics