flomo-web-crud

Flomo Web CRUD

概要

Chrome MCP ツールを使って、https://v.flomoapp.com/mine にある flomo のメモを操作します。

このスキルは Web UI の自動化専用です。flomo の公式 API には依存しません。

mac 以外のユーザー向けのデフォルトの推奨方法であり、flomo-local-api を実行できない場合の代替手段です。

デフォルトの動作（v1）：

• CRUD 全般（query/search、create/insert、edit、delete）
• query は、最近の状況、現在の関心事、価値観の兆候を把握することをデフォルトとします
• まずテキスト検索を行いますが、書き込み操作の前に memo_id で対象を特定します
• edit は、メモの内容全体を置き換える（replace）ことをデフォルトとします
• delete では、必ず明示的な2回目の確認を求めます
• 検索時に自動で詳細スキャンを行い、メモ数のデフォルト上限は 50 件です
• ログは最小限に抑えます（メモ本文は保存しません）

前提条件

• ユーザーが Chrome で flomo Web にログイン済みであること
• この Codex セッションで Chrome MCP が利用可能で、正常に動作していること
• デスクトップレイアウトを推奨します（幅の広いビューポート）。モバイルレイアウトはベストエフォートでのみ対応します。

このスキルを使う場面

• ユーザーが flomo のメモを検索または探すよう依頼した場合
• ユーザーが flomo の内容から最近の状態や考えていること、価値観を把握するよう依頼した場合
• ユーザーが実際のアカウントに flomo のメモを挿入または作成するよう依頼した場合
• ユーザーが既存のメモを編集または更新するよう依頼した場合
• ユーザーがメモの削除を依頼し、確認手順に同意した場合

このスキルを使わない場面

• ユーザーが flomo のエクスポート済み HTML／アーカイブの処理のみを希望している場合
• ユーザーが多数のメモを対象とする一括操作を依頼した場合
• ユーザーが添付ファイルのアップロード／編集への対応を依頼した場合
• ユーザーが mac を使用していて、flomo-local-api で既に対応できる高速なローカル検索／作成／編集のみを必要としている場合

デフォルトのワークフロー（概要）

1. Chrome MCP への接続を確認し、flomo のタブに切り替えます（または flomo に移動します）。
2. query/edit/delete の場合、検索ワークフローを実行し、表示されているメモカード／リンクから候補を作成します。
3. 必要に応じて、スキャン上限までスクロールと読み取りを繰り返し、詳細スキャンを行います。
4. クエリの意図が内省に関するものであれば、最近のメモを優先し、繰り返し現れるテーマを抽出します。
5. 書き込み操作では、memo_id で対象を特定し、確認手順を提示します。
6. まず chrome_read_page の参照情報を使って UI 操作を実行します。参照情報が期限切れの場合は更新します。
7. ページを再読み込みして結果を検証し、処理結果を要約します。

安全ルール（必ず遵守）

• delete：実際に削除する前に、必ず明示的な2回目の確認を求めます。
• テキスト検索による edit：書き込み前に候補の確認を求めます。
• メモ本文をローカルファイルに保存しないでください。
• 内省を促す要約では、医学的／法的／診断的な断定を避けてください。
• 対象の UI コントロールを確実に特定できない場合は、推測で操作せず、復旧可能な失敗として報告して停止します。

ツールの優先順位

mcp-chrome-global Chrome MCP ツールを、次の優先順位で使用します。

1. chrome_switch_tab / chrome_navigate
2. chrome_read_page
3. chrome_get_web_content
4. chrome_click_element、chrome_fill_or_select、chrome_keyboard
5. chrome_screenshot
6. chrome_computer
7. chrome_request_element_selection

意図のマッピング

query/search

ユーザーの意図が「最近の状態／考えていること／価値観を知りたい」の場合、次を返します。

• recent_state
• active_topics
• value_signals
• supporting_memos
• confidence_notes

候補のメモには次の情報を含めます。

• memo_id
• 画面に表示されたタイムスタンプのテキスト
• 短い抜粋
• 該当する理由

create/insert

上部のエディターから新しいメモを挿入し、可能な範囲で新しい memo_id を特定して成功を報告します。

edit

デフォルトのモードは replace（メモ本文全体を置き換え）です。append／prepend は将来のオプションモードです。

delete

選択した候補についてユーザーが確認した後に限り、対象メモを1件削除します。

追加質問（必要な場合のみ）

操作に重大な影響がある場合に限り質問します。

• 複数の候補が一致し、書き込み操作が要求されている
• create または edit で新しいコンテンツが提供されていない
• ユーザーがデフォルトの 50 を超えるスキャン上限を希望している
• 振り返りのクエリに時間範囲がなく、「最近」の範囲が曖昧である
• ページのレイアウトがモバイル向けである、またはコントロールを確実に見つけられない
• 破壊的な操作が最終確認の段階に達している

振り返りクエリのヒューリスティクス

• デフォルトの時間範囲：過去30日間
• エビデンスを優先して要約する
• 一度限りの発言より、繰り返し現れるシグナルを優先する
• 行動と価値観を区別する
• 簡潔で実行可能な出力にする

参考資料

• ワークフローの詳細：references/workflows.md
• UI ロケーターの戦略とフォールバックポリシー：references/ui-locators.md
• 安全性とロギングのポリシー：references/safety.md
• 検証チェックリスト：references/test-checklist.md