felo-mindmap

Felo マインドマップスキル

使用するタイミング

マインドマップファイルの作成に関するリクエストでは、このスキルを使用します。

• トピックや質問からマインドマップを作成／生成する
• アイデアを構造化されたマインドマップにまとめる
• さまざまなレイアウトタイプ（タイムライン、フィッシュボーンなど）でマインドマップを作成する
• マインドマップの内容を共有可能なリンクとしてエクスポートする

トリガーとなるキーワード：

• マインドマップの作成に関する中国語のプロンプト（思维导图, 脑图）
• 英語：mindmap, mind map, thinking map, generate mindmap
• 明示的なコマンド：/felo-mindmap、「use felo mindmap」

以下の場合は、このスキルを使用しないでください。

• リアルタイム情報の検索（felo-search を使用）
• ローカルのコードベースファイルに関する質問
• マインドマップの生成を必要としない、純粋なテキストタスク

セットアップ

1. API キーを取得する

1. felo.ai にアクセスします
2. Settings -> API Keys を開きます
3. API キーを作成してコピーします

2. 環境変数を設定する

Linux/macOS：

export FELO_API_KEY="your-api-key-here"

Windows PowerShell：

$env:FELO_API_KEY="your-api-key-here"

実行方法

Bash ツールのコマンドを使用し、次のワークフローに正確に従ってください。

ステップ 1：API キーを事前確認する

if [ -z "$FELO_API_KEY" ]; then
  echo "ERROR: FELO_API_KEY not set"
  exit 1
fi

キーが設定されていない場合は、停止してセットアップ手順を返します。

ステップ 2：Node スクリプトを実行する

バンドルされたスクリプトを使用します。

node felo-mindmap/scripts/run_mindmap_task.mjs \
  --query "USER_PROMPT_HERE" \
  --timeout 60

レイアウトタイプを指定する場合：

node felo-mindmap/scripts/run_mindmap_task.mjs \
  --query "USER_PROMPT_HERE" \
  --layout "TIMELINE" \
  --timeout 60

利用可能なレイアウトタイプ：

• MIND_MAP（デフォルト）- 標準的なマインドマップ
• LOGICAL_STRUCTURE - 論理構造図
• ORGANIZATION_STRUCTURE - 組織図
• CATALOG_ORGANIZATION - カタログ組織図
• TIMELINE - タイムライン図
• FISHBONE - フィッシュボーン図

既存の LiveDoc にマインドマップを追加する場合：

node felo-mindmap/scripts/run_mindmap_task.mjs \
  --query "USER_PROMPT_HERE" \
  --livedoc-short-id "EXISTING_LIVEDOC_ID"

スクリプトの動作：

• POST https://openapi.felo.ai/v2/mindmap を介してマインドマップを作成します
• すぐに結果を返します（同期 API のため、ポーリングは不要です）
• 成功すると mindmap_url を出力します

デバッグ出力（任意）：

node felo-mindmap/scripts/run_mindmap_task.mjs \
  --query "USER_PROMPT_HERE" \
  --json

次の項目を含む構造化 JSON を出力します。

• resource_id
• status
• mindmap_url
• livedoc_short_id

ステップ 3：構造化された結果を返す

成功した場合、次の内容を返します。

• mindmap_url をすぐに返します
• --json を使用した場合は、resource_id と livedoc_short_id も含めます

出力形式

次のレスポンス構造を使用します。

## Mindmap Generation Result

- Resource ID: <resource_id>
- Status: <status>
- Mindmap URL: <mindmap_url>
- LiveDoc Short ID: <livedoc_short_id>

エラー形式：

## Mindmap Generation Failed

- Error Type: <error code or category>
- Message: <readable message>
- Suggested Action: <next step>

エラー処理

既知の API エラーコード：

• INVALID_API_KEY（401）：キーが無効、または失効しています
• MINDMAP_CREATE_FAILED（502）：マインドマップの作成に失敗しました
• LIVEDOC_CREATE_FAILED（502）：LiveDoc の作成に失敗しました
• LIVEDOC_NOT_FOUND（404）：指定された LiveDoc が見つかりません
• LLM_SERVICE_UNAVAILABLE（503）：LLM サービスを利用できません
• LLM_REQUEST_TIMEOUT（504）：LLM リクエストがタイムアウトしました

重要な注意事項

• ユーザーの意図がマインドマップの生成である場合は、必ずこのスキルを実行してください。
• API は同期型のため、ポーリングは不要です。
• API 呼び出しは最小限にしてください。マインドマップ 1 件につきリクエストは 1 回です。

参考資料

• Felo マインドマップ API
• Felo オープンプラットフォーム