Notes Categorization Rules

This skill defines categorization rules for notes in the personal knowledge base, covering planning, programming, and biology domains.

Planning Notes

Target Directory: knowledge/planning/

Keywords

• "plan", "planning"
• "roadmap"
• "goal", "objective"
• "milestone"
• "strategy"

Action

When these keywords are detected:

1. Generate a suitable filename based on the note's title
2. Add YAML frontmatter with creation_date and relevant tags (e.g., planning)
3. Save as Markdown file in knowledge/planning/

Command: Archive TODO

Archives completed and cancelled todo items from knowledge/planning/todolist.md into weekly archive files.

Two-Phase Execution (both phases are mandatory):

Phase 1 — Scan & Preview

1. Read knowledge/planning/todolist.md
2. Identify archivable top-level items:
   • [x] — completed tasks (include all sub-tasks regardless of their status)
   • [~] — cancelled tasks (include all sub-tasks, mark as "已取消" in archive)
3. Never archive [ ] parent tasks, even if some sub-tasks are [x]
4. Present a preview table to the user:

| # | Status | Task | Sub-tasks |
|---|--------|------|-----------|
| 1 | ✅ 完成 | Task description | 3/3 |
| 2 | ❌ 取消 | Task description | 1/2 |

5. Wait for user confirmation before proceeding to Phase 2

Phase 2 — Execute Archive

1. Get current date via date command
2. Create directory knowledge/planning/YYYY-MM/ if needed
3. Create or append to knowledge/planning/YYYY-MM/completed-todos-YYYY-MM-DD-weekly.md:

---
creation_date: YYYY-MM-DD
tags: [planning, archive, completed-todos]
---

4. Write archived items preserving original markdown structure
5. For [~] items, prepend "[已取消]" to the task line
6. Remove archived items from source todolist.md
7. Append to knowledge/logs/_changelog.md
8. Present summary: N completed, M cancelled, archive file path

Programming Notes

Target Directory: knowledge/programming/

Keywords

• "code", "coding", "programming"
• "algorithm", "data structure"
• "Python", "JavaScript", "R", "SQL", "Java", "C++"
• "bug", "debug", "error"
• "API", "library", "framework"

Action

When these keywords are detected:

1. Generate a suitable filename based on the note's title
2. Add YAML frontmatter with creation_date and relevant tags (e.g., programming, python)
3. Save as Markdown file in knowledge/programming/

Code Formatting Rules

All code must use code blocks:

• Wrap all code in Markdown code blocks
• Always specify language type after opening backticks

Correct:

def example_function(data):
    # This is an example function
    return len(data)

Incorrect (missing language specifier):

def example_function(data):
    return len(data)

Biology Notes

Target Directory: knowledge/biology/

Keywords

• "biology", "bioinformatics"
• "gene", "genome", "DNA", "RNA", "protein"
• "sequencing", "NGS"
• "analysis", "pipeline", "workflow"
• "research", "study", "experiment", "paper"

Action

When these keywords are detected:

1. Generate a suitable filename based on the note's title
2. Add YAML frontmatter with creation_date and relevant tags (e.g., biology, bioinformatics)
3. Save as Markdown file in knowledge/biology/