M3E: Skill for Claude Code

m3e-scratch

ユーザーの思いつき、アイデア、バグ報告をM3Eマップの scratch ノード配下にプールするスキル。 scratch はタスクの種（seed）置き場 — 後で整理・昇格・削除する前提の気軽な場所。

場所

M:(開発)> SYSTEM > DEV >> scratch

scratch ノードID: n_new_scratch_1775637602039

---

機能1: ノード追加

1. ユーザー入力を解析

ユーザーの発言から以下を抽出する:

• テキスト: ノードの本文（簡潔に。ユーザーの言葉をなるべくそのまま使う）
• 種別: idea / bug / memo / task のいずれか（文脈から判断）
• 詳細: 補足があれば details フィールドに入れる
• 複数項目: 箇条書きや列挙なら、それぞれ別ノードとして追加

2. マップに書き込む

マップAPIを使う:

1. GET http://localhost:4173/api/maps で label="開発" の mapId を discovery し、対象 map を取得
2. 新しいノードを作成:

   {
     "id": "n_{timestamp}_{random6}",
     "parentId": "n_new_scratch_1775637602039",
     "children": [],
     "nodeType": "text",
     "text": "ユーザーの入力テキスト",
     "collapsed": false,
     "details": "補足情報があれば",
     "note": "",
     "attributes": {
       "kind": "idea|bug|memo|task"
     },
     "link": ""
   }
   

   • カテゴリフォルダが既にあり、そこに入るべき内容なら parentId をそのフォルダにする
3. 親ノードの children 配列の末尾に新ノードIDを追加
4. POST で全体を書き戻す
5. レスポンスの "ok": true を確認

3. ID生成

n_{Date.now()}_{Math.random().toString(36).slice(2, 8)}

Bashで生成する場合:

echo "n_$(date +%s%3N)_$(cat /dev/urandom | tr -dc 'a-z0-9' | head -c 6)"

4. ユーザーへの応答

追加したら簡潔に報告:

scratch に追加:
- [idea] レイアウトエンジンにgrid表示モード
- [bug] ノード削除後にalias参照が残る

---

機能2: scratch 整理

scratch 配下のノードが増えてきたら、カテゴリごとにグルーピングして見通しを良くする。

整理ルール

1. 葉ノードは絶対に削除しない — 葉はユーザーのアイデアそのもの。消すのはユーザーだけ
2. 整理はフォルダノード（中間ノード）の追加・移動のみで行う
3. カテゴリフォルダの例:
   • UI/UX — 見た目・操作感に関するもの
   • データモデル — ノード構造・属性・型に関するもの
   • バグ — 不具合報告
   • インフラ — ビルド・デプロイ・CI/CD
   • アイデア — 大きな構想・将来のビジョン
   • カテゴリは固定ではない。内容に応じて柔軟に作る
4. 1〜2個しかないカテゴリは無理にフォルダを作らない（scratch直下のままでOK）
5. 既存のフォルダ構造があればそれを尊重し、追加・調整する

整理の手順

1. GET でマップ取得
2. scratch 配下の全ノードを走査し、内容を把握
3. カテゴリ分けの計画を立てる
4. 必要なフォルダノードを作成（nodeType: "text", attributes: { "role": "category" }）
5. 葉ノードの parentId を適切なフォルダに変更
6. 旧親の children から削除、新親の children に追加
7. POST で書き戻す
8. ユーザーに整理結果を報告:

   scratch を整理しました:
   - UI/UX (3件): grid表示, ダークモード, ツールチップ改善
   - バグ (2件): alias参照残り, 折りたたみ状態リセット
   - 未分類 (1件): ライセンス検討