tasks-explain-diff
Generate a rich Notion document explaining code changes. Creates comprehensive documentation with background, intuition, code walkthrough, and verification steps.
- License 许可
- MIT
- 最近更新
- 2026-11-13
- Stars
- ★ 29
- Forks
- 156
01 前言 Front Matter
- name
- tasks-explain-diff
- description
- Generate a rich Notion document explaining code changes. Creates comprehensive documentation with background, intuition, code walkthrough, and verification steps.
03 SKILL.md 正文
Explain Code Changes
Create a rich explanation of code changes as a new Notion page.
Input
The user will point to code changes to explain. If not explicitly specified, explain the most recent batch of changes made in the conversation.
Document Sections
Background
Explain the existing system relevant to this change:
- Broadly explore surrounding code for context
- Include deep background for beginners (can be skipped by familiar readers)
- Provide narrow background directly relevant to the change
Intuition
Explain the core intuition for the code change:
- Focus on the essence, not full details
- Use concrete examples with toy data
- Use figures and mermaid diagrams liberally
Code
High-level walkthrough of the changes:
- Group and order changes in an understandable way
- Explain the purpose of each significant change
- Link to specific files and line numbers
Verification
Explain how the code change was verified:
- Unit tests, integration tests, etc.
- Step-by-step guide for manual QA
Alternatives
Describe 1-2 alternative approaches (if identifiable):
- Each alternative includes pros and cons
- Layout pros/cons in 2 columns
- Only include if it represents an orthogonal approach
- Omit this section if no meaningful alternatives exist
Quiz
5 questions testing reader's knowledge:
- Medium difficulty - requires understanding the substance
- Multiple choice with explanations
- Use toggle blocks for answers:
1. Question
> Option 1
- Explanation for why incorrect
> Option 2
- Explanation for why correct
Formatting Guidelines
- Use the Notion MCP to create the page and return its URL
- Write with clarity and flow - engaging, classic style
- Smooth transitions between sections
- Use consistent diagram families throughout
- Include callouts for key concepts, definitions, and edge cases
04 同仓库更多 Skills
business-data
暂无简介
workflow
Creates durable, resumable workflows using Vercel's Workflow SDK. Use when building workflows that need to survive restarts, pause for external events, retry on failure, or coordinate multi-step operations over time. Triggers on mentions of "workflow", "durable functions", "resumable", "workflow sdk", "queue", "event", "push", "subscribe", or step-based orchestration.
workflow
Vercel Workflow SDK expert guidance. Use when building durable workflows, long-running tasks, API routes or agents that need pause/resume, retries, step-based execution, or crash-safe orchestration with Vercel Workflow.
verification
Full-story verification — infers what the user is building, then verifies the complete flow end-to-end: browser → API → data → response. Triggers on dev server start and 'why isn't this working' signals.
vercel-storage
Vercel storage expert guidance — Blob, Global Config (formerly Edge Config), and Marketplace storage (Neon Postgres, Upstash Redis). Use when choosing, configuring, or using data storage with Vercel applications.
vercel-services
Configure and troubleshoot Vercel Services for multiple frontends and backends in one project. Use when composing a polyglot or multi-service application on one Vercel deployment; defining the `services` key, service-targeted rewrites, or service bindings in `vercel.json`; or running all services with `vercel dev`.