mcpField
T
tasks-explain-diff

tasks-explain-diff

github.com/makenotion開発3939 回インストール38 週間前に更新
リポジトリ

tasks-explain-diff について

コード変更を、背景、着想、コード解説、検証、代替案を含むNotionページにまとめるスキルです。変更の理解が必要な開発者や読者向けで、クイズも作成し、Notion MCPでページを作成します。

主な機能

  1. 01変更の背景と着想を解説
  2. 02ファイルと行番号ごとに変更を説明
  3. 03テストと手動検証手順を記録
  4. 04代替案と長所・短所を提示
  5. 05クイズを作成してNotionページを生成

活用シーン

  1. 01最近のコード変更を文書化
  2. 02新しいメンバーによるシステム変更の理解
  3. 03コード変更の検証手順を記録
  4. 04クイズで読者の理解度を確認

MCP 対応

Notion MCPを使って解説ページを作成し、URLを返します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/makenotion/cursor-notion-plugin --skill tasks-explain-diff

インストール後、Claude Code で/tasks-explain-diffを入力して読み込まれたか確認します。

詳細

コード変更の解説

コード変更を詳しく解説する新しい Notion ページを作成します。

入力

ユーザーが解説するコード変更を指定します。明示的な指定がない場合は、会話内で直近に行われた一連の変更を解説します。

ドキュメントのセクション

背景

この変更に関係する既存システムについて説明します。

  • 周辺のコードを幅広く調べ、背景を把握します
  • 初心者向けに詳しい背景を記載します（詳しい読者は読み飛ばせます）
  • 変更に直接関係する背景を簡潔に記載します
直感的な理解

コード変更の中核となる考え方を説明します。

  • 詳細のすべてではなく、本質に焦点を当てます
  • おもちゃのデータを使って、具体例を示します
  • 図や mermaid の図を積極的に使用します
コード

変更内容を大まかに解説します。

  • 変更を理解しやすいように分類し、順序立てて説明します
  • 重要な変更ごとに、その目的を説明します
  • 該当するファイルと行番号へのリンクを記載します
検証

コード変更をどのように検証したかを説明します。

  • ユニットテスト、統合テストなど
  • 手動 QA の手順を段階的に説明します
代替案

代替アプローチを 1～2 個説明します（特定できる場合）。

  • 各代替案について、メリットとデメリットを記載します
  • メリットとデメリットは 2 列で配置します
  • 独立したアプローチに該当する場合のみ記載します
  • 有意義な代替案がない場合は、このセクションを省略します
クイズ

読者の理解度を確かめる 5 つの質問：

  • 中程度の難易度とし、内容の理解が必要な問題にします
  • 解説付きの選択式にします
  • 回答にはトグルブロックを使用します。
1. Question
   > Option 1
     - Explanation for why incorrect
   > Option 2
     - Explanation for why correct

書式ガイドライン

  • Notion MCP を使用してページを作成し、その URL を返します
  • 明快で流れがよく、読者を引き込む古典的な文体で書きます
  • セクション間を自然につなげます
  • 図の形式に一貫性を持たせます
  • 重要な概念、定義、エッジケースにはコールアウトを使用します

コメント

Markdown 対応