goromal/agent-skills

Notionの指定ページからITNS(「これらのメモをどこかに統合」)ノートを適切なサブページに分類、整理、転送します。ユーザーがITNSについて言及したり、Notionノートリポジトリの処理を依頼したり、整理が必要なページを指定した際に使用します。

agent-skills とは?

このスキルは、AIエージェントがNotion上のバラバラなノートを自動的に整理するためのルールセットです。ユーザーが「ITNS(これらのメモをどこかに統合)」のようなキーワードや特定のNotionページ名を指定すると、スキルはまず `~/configs/goromail-categories.csv` を参照してソースページを解決します。その後、Notion MCPサーバーを使用してソースページ内のノートブロックを分析し、既存のサブページのタイトルと内容に基づいて最適な転送先を自動的に判断します。自動移動は、転送先が一意に決定でき、ノートの境界が明確で、内容の編集(分割、結合、要約など)が不要な場合にのみ実行されます。判断が曖昧な場合や新しいカテゴリの作成が必要な場合は、ユーザーに相談し、承認を得てから処理を進めます。すべての操作後には、ブロックの完全性を検証し、移動結果をレポートします。主にClaude CodeやCodexなどのコーディングエージェントとNotion MCPサーバーの組み合わせで使用されることを想定しています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/goromal/agent-skills/tree/HEAD/skills/itns-notes

Installed? Explore more 生産性&コラボレーション skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ITNSノートの処理

インストール済みのNotion MCPサーバーを使用します。各ノートの表現、書式、リンク、日付、優先度マーカー、ブロックタイプ、順序、ネストされた子要素を保持してください。ユーザーが明示的に要求しない限り、内容の要約、書き換え、分割、結合、重複排除、削除は行わないでください。

ソースページの解決

  1. ユーザーが指定したページ名を、~/configs/goromail-categories.csv の最初の列に対して大文字小文字を区別せずに完全一致で照合します。
  2. 対応する2列目のNotionページIDを使用します。
  3. 完全一致がない場合、または複数の完全一致がある場合は、処理を停止してユーザーに質問します。似た名前からIDを推測しないでください。

ノートと転送先の発見

  1. ソースページに対して notion_list_subpages を呼び出し、候補となる転送先を収集します。
  2. ソースページに対して recursive: true を指定して notion_list_blocks を呼び出します。親ブロックとそのすべての子孫を1つの分割不可能なノートツリーとして扱います。
  3. 隣接するトップレベルの段落、リストアイテム、コードブロック、その他の散文は、その内容が明らかに連続した思考を形成している場合、1つの複合ノートとして扱います。境界が不明確な場合は、その境界を曖昧として分類し、ユーザーに質問します。
  4. 見出し、子ページブロック、ページメンションリンク、その他のナビゲーションや構造ブロックは除外します。Repository 見出しが存在する場合、その後のルーズなコンテンツをソースノート領域として使用します。信頼できるソースノートの境界が存在しない場合は、移動する前に質問します。
  5. 関連する転送先の内容を再帰的なブロック一覧で調査します。転送先のタイトルだけでなく、その既存の主題から分類します。
  6. 不明瞭なリンクや曖昧なラベルの場合は、アクセス可能であればリンク先の内容を調査します。主題が不明確な場合は、推測せずに質問します。

自動判断または質問

以下のすべてが真の場合にのみ、ノートを自動的に移動します:

  • 既存のサブページが1つだけ、意味的に強い適合性を持つ場合
  • 完全なノートとその境界が理解されている場合
  • 移動に書き換え、分割、結合、カテゴリの新規作成が必要ない場合

それ以外のすべてのケースは曖昧として扱います。完全なノートまたは忠実でコンパクトなプレビュー、可能性のある転送先、1つの推奨事項とその簡単な理由を提示します。そのノートを書き込む前に、ユーザーの判断を待ちます。新しいサブページを作成または命名する前に、必ず質問します。

曖昧なノートが判断を待っている間も、明らかなノートの処理は続行します。明らかな配置が、関連する曖昧な配置を黙って決定してしまわないようにしてください。

移動の実行と検証

  • 1つのトップレベルノートツリーは notion_move_block で移動します。その子孫も一緒に移動します。
  • 隣接するトップレベルブロックで構成される複合ノートは notion_move_blocks で移動します。ブロックIDを元の順序で1回、1つの転送先に渡します。
  • ユーザーが承認したカテゴリは notion_create_subpage で作成し、その後、そのカテゴリに承認されたノートのみを移動します。
  • テキスト追加と削除によるロスが発生する移動方法は決してエミュレートしないでください。
  • 各バッチの後、転送元と転送先を再度リストします。転送元のすべてのブロックがなくなり、転送先のすべてのブロックが順序どおりに存在し、子カウントが一致し、ブロックタイプとテキストが保持されていることを確認します。
  • 操作が部分的に失敗した場合は、それ以上の書き込みを停止し、両方のページを調査し、正確にコピー、アーカイブ、残存、または重複したブロックを報告してから修復を試みます。
  • 再帰的なリストや順序付きバッチ移動が利用できない場合は、処理を停止し、複合ノートを安全に処理する前にNotion MCPサーバーをデプロイまたはアップグレードする必要があることを報告します。

自動移動、ユーザー承認による移動、作成されたページ、延期された曖昧なケース、および検証結果の簡潔な記録を最後に出力します。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

関連スキル