AgentSkillsCN

Notion Sync

Notion 同步

SKILL.md

Skill: Notion Second Brain Sync

Description

Syncs project data with user's Notion Second Brain (PARA framework).

When to Use

  • User asks to "sync to Notion" or "update Second Brain"
  • After project retrospective (/retro)
  • When creating or completing major milestones

Prerequisites

  • notion_sync.enabled: true in .ai/config.yaml
  • Notion API key configured
  • Database IDs set in config

Instructions

Create Project Entry

  1. Create page in Projects database (project_db_id)
  2. Set properties: Name, Status (Active), Tech Stack, Start Date
  3. Add page content from .ai/pdd.md overview

Update Tech Stack Entries

  1. For each technology in config.yaml stack section:
    • Search Tech Stack database for existing entry
    • If exists: update "Used In" relation
    • If not: create new entry with category + tags

Post-Retrospective Sync

  1. Create Note entry linked to Project
  2. Title: "[Project Name] Retrospective — [date]"
  3. Content: retrospective report from /retro
  4. Type: "Reflection"
  5. Notebook: "AI & LLMs"

Constraints

  • Never delete existing Notion entries
  • Always check for duplicates before creating
  • Use bidirectional relations where available
  • Handle API rate limits gracefully