AGENT SKILL

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

CognitionAI
CognitionAI/devin-marketplace

business-data

暂无简介

★ 29
CognitionAI
CognitionAI/devin-marketplace

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.

★ 29
CognitionAI
CognitionAI/devin-marketplace

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.

★ 29
CognitionAI
CognitionAI/devin-marketplace

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.

★ 29
CognitionAI
CognitionAI/devin-marketplace

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.

★ 29
CognitionAI
CognitionAI/devin-marketplace

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`.

★ 29