akaghef/m3e-scratch

m3e-scratch

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

場所

ROOT / SYSTEM / DEV / scratch

scratch ノードID: n_new_scratch_1775637602039

---

機能1: ノード追加

1. ユーザー入力を解析

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

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

2. マップに書き込む

マップAPIを使う:

1. GET http://localhost:38482/api/docs/rapid-main で現在のマップ状態を取得
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件): ライセンス検討
   

---

注意点

• scratch は気軽な場所。ユーザーの言葉を過度に整形しない — 雰囲気が伝わることが大事
• 種別（kind）の判断に迷ったら memo にしておく
• 同じ内容が既にあるか軽くチェックし、明らかな重複は避ける（ただし厳密な重複排除は不要）
• マップAPIが応答しない場合はユーザーに「ビューワーが起動していないようです」と伝える
• 整理時に葉ノードを削除することは禁止 — フォルダの作成と移動のみ