Grasshopper ワークフロー Skill

概要

この Skill は、コンポーネント管理、接続管理、パラメータ設定、グループ管理、ワークフロー実行を含む、完全な Grasshopper パラメトリックモデリングワークフローを提供します。要求分析から最終実行までの完全なプロセスを統合しています。

コア機能

1. コンポーネント管理

• コンポーネントの作成、クエリ、削除
• 複数のコンポーネントの並列作成
• コンポーネント ID マッピング管理
• コンポーネント GUID クエリ

2. 接続管理

• コンポーネント間の接続の確立
• 複数のコンポーネントの並列接続
• 接続エラーのチェックと修正
• ドキュメントのエラー診断

3. パラメータ設定

• Number Slider 属性の設定
• Vector XYZ コンポーネントの設定
• バッチパラメータ設定
• 自動範囲決定

4. グループ管理

• コンポーネントグループの作成
• グループの一括作成
• カスタムグループの色と名前

5. ワークフロー実行

• MMD ファイル（component_info.mmd, part_info.mmd）の解析
• placement_info.json の生成
• 完全なモデリングプロセスの実行
• 自動化されたスクリプト実行

クイックスタート

基本的な使用法

from scripts.client import GrasshopperClient
from scripts.component_manager import ComponentManager
from scripts.connection_manager import ConnectionManager
from scripts.parameter_setter import ParameterSetter
from scripts.group_manager import GroupManager

# クライアントの作成
client = GrasshopperClient(host="localhost", port=8080)

# コンポーネントマネージャーの作成
comp_mgr = ComponentManager(client)

# コンポーネントの作成
component_id = comp_mgr.add_component(
    guid="e2bb9b8d-0d80-44e7-aa2d-2e446f5c61da",
    x=100,
    y=200,
    component_id="SLIDER_WIDTH"
)

完全なワークフロー

from scripts.parser_utils import MMDParser, JSONGenerator
from scripts.placement_executor import PlacementExecutor

# 1. MMD ファイルの解析
parser = MMDParser()
components, connections = parser.parse_component_info_mmd("component_info.mmd")

# 2. placement_info.json の生成
generator = JSONGenerator()
placement_info = generator.generate_placement_info(components, connections)
generator.save_placement_info(placement_info, "placement_info.json")

# 3. 実行
executor = PlacementExecutor()
result = executor.execute_placement_info("placement_info.json")

ワークフローステップ

Grasshopper モデリングワークフローには、6 つの主要なステップが含まれています。

1. 設計要件と仕様の明確化 - references/workflow_steps.md を参照してください。
2. 幾何オブジェクトの分割 part_info.mmd の作成 - references/workflow_steps.md を参照してください。
3. バッテリーの実際の接続図 component_info.mmd の計画 - references/workflow_steps.md を参照してください。
4. 必要なコンポーネント GUID の特定と位置の計画 - references/workflow_steps.md を参照してください。
5. 実行シーケンスファイル placement_info.json の生成 - references/workflow_steps.md を参照してください。
6. GH_WIP ファイルのクリーンアップ - references/workflow_steps.md を参照してください。

詳細ドキュメント

• ワークフローステップ: references/workflow_steps.md を参照してください - 完全な 6 ステップのワークフローガイド
• API リファレンス: references/api_reference.md を参照してください - すべてのモジュールとメソッドの詳細な説明
• CLI 使用説明: references/cli_usage.md を参照してください - コマンドラインツールの使用ガイド
• ツール使用ガイド: references/tool_guide.md を参照してください - すべてのツールの入出力の説明

スクリプトツール

すべての Python スクリプトは scripts/ ディレクトリにあります。

• client.py - MCP 通信クライアント
• component_manager.py - コンポーネント管理
• connection_manager.py - 接続管理
• parameter_setter.py - パラメータ設定
• group_manager.py - グループ管理
• parser_utils.py - MMD/JSON 解析
• placement_executor.py - 実行ツール
• utils.py - ユーティリティ関数
• cli.py - コマンドラインインターフェース

スクリプトの使用

特定の操作を実行する必要がある場合は、対応するスクリプトを呼び出すことができます。

# placement_info.json の実行
from scripts.placement_executor import PlacementExecutor
executor = PlacementExecutor()
result = executor.execute_placement_info("placement_info.json", max_workers=10)

コマンドラインツール

CLI ツールを使用して、一般的なタスクを実行します。

# placement_info.json の実行
python scripts/cli.py execute-placement placement_info.json

# すべての slider の設定
python scripts/cli.py set-sliders component_info.mmd

# コンポーネントのグループ化
python scripts/cli.py group-components component_info.mmd

詳細な CLI 使用説明については、references/cli_usage.md を参照してください。

注意事項

1. MCP サーバー: Grasshopper MCP サーバーが実行されていることを確認してください（localhost:8080）。
2. コンポーネント ID マッピング: コンポーネントの作成後、ID マッピングは自動的に component_id_map.json に保存されます。
3. 並列実行: 効率を向上させるために並列実行がサポートされています。max_workers=10 から 20 を使用することをお勧めします。
4. スレッドセーフ: すべての操作はスレッドセーフであり、マルチスレッド環境で使用できます。
5. ファイルパス: スクリプト内の相対パスは、実際の使用状況に応じて調整する必要があります。

一般的なワークフロー

MMD から完全な定義まで

1. component_info.mmd を解析して、コンポーネントと接続の情報を取得します。
2. placement_info.json 実行シーケンスを生成します。
3. placement_info.json を実行して、コンポーネントと接続を作成します。
4. すべての slider パラメータ値を設定します。
5. コンポーネントグループを作成します。

詳細な手順については、references/workflow_steps.md を参照してください。