Windmillワークフロー開発環境の構築結果まとめ。サーバー接続確認、REST APIヘルパースクリプト作成、ワークフロー定義ファイル作成、wmill CLI制限の発見と代替策の実装を記録。

.agent/workflows/windmill-new-script.md

@@ -0,0 +1,53 @@
+---
+description: 新しいWindmillスクリプトを作成する
+---
+
+# 新しいWindmillスクリプトの作成
+
+Windmillに新しいスクリプトを追加する手順。
+
+## 手順
+
+1. **スクリプトファイルの作成**: スクリプトは以下のディレクトリ構造に従って作成する
+   - ユーザースクリプト: `u/<username>/<script_name>/`
+   - フォルダスクリプト: `f/<folder_name>/<script_name>/`
+   
+2. **ファイル構成**: 各スクリプトフォルダには以下のファイルが必要
+   - `script.yaml` — メタデータ（言語、概要、スキーマなど）
+   - スクリプト本体（例: `script.py`, `script.ts`, `script.sh`）
+
+3. **script.yaml のテンプレート**
+```yaml
+summary: '<スクリプトの説明>'
+description: '<詳細な説明>'
+lock: []
+schema:
+  $schema: 'https://json-schema.org/draft/2020-12/schema'
+  type: object
+  properties:
+    param1:
+      type: string
+      description: '<パラメータの説明>'
+  required:
+    - param1
+kind: script
+tag: ''
+```
+
+4. **Pythonスクリプト (`script.py`) のテンプレート**
+```python
+def main(param1: str):
+    """
+    スクリプトの説明
+    """
+    return {"result": f"Hello, {param1}!"}
+```
+
+5. **TypeScriptスクリプト (`script.ts`) のテンプレート**
+```typescript
+export async function main(param1: string): Promise<any> {
+  return { result: `Hello, ${param1}!` };
+}
+```
+
+6. **サーバーに反映**: `/windmill-push` ワークフローを実行してpush

.agent/workflows/windmill-pull.md

@@ -0,0 +1,39 @@
+---
+description: Windmillサーバーからワークフロー情報を取得する
+---
+
+# Windmill Pull ワークフロー
+
+Windmillサーバーから最新のスクリプトやフローの情報を取得する手順。
+wm-api.sh を使用してREST API経由で取得する。
+
+// turbo-all
+
+1. サーバーバージョンを確認
+```bash
+cd /home/akira/develop/windmill_workflow && ./wm-api.sh version
+```
+
+2. スクリプト一覧を取得
+```bash
+cd /home/akira/develop/windmill_workflow && ./wm-api.sh scripts
+```
+
+3. フロー一覧を取得
+```bash
+cd /home/akira/develop/windmill_workflow && ./wm-api.sh flows
+```
+
+4. 特定のスクリプトの詳細を取得
+```bash
+cd /home/akira/develop/windmill_workflow && ./wm-api.sh get-script <path>
+```
+
+5. 特定のフローの詳細を取得
+```bash
+cd /home/akira/develop/windmill_workflow && ./wm-api.sh get-flow <path>
+```
+
+## 注意
+- wmill CLIはCE版ではグローバルAPI認証の制限があるため使用できない
+- 代わりに `wm-api.sh` を使用してREST APIで直接操作する

.agent/workflows/windmill-push.md

@@ -0,0 +1,35 @@
+---
+description: ローカルのワークフローをWindmillサーバーにpushする
+---
+
+# Windmill Push ワークフロー
+
+ローカルで作成・編集したスクリプトやフローをWindmillサーバーに反映する手順。
+wm-api.sh を使用してREST API経由でpushする。
+
+// turbo-all
+
+1. 現在のサーバー接続を確認
+```bash
+cd /home/akira/develop/windmill_workflow && ./wm-api.sh version
+```
+
+2. 既存のスクリプト一覧を確認
+```bash
+cd /home/akira/develop/windmill_workflow && ./wm-api.sh scripts
+```
+
+3. 既存のフロー一覧を確認
+```bash
+cd /home/akira/develop/windmill_workflow && ./wm-api.sh flows
+```
+
+4. スクリプトを作成する場合 (JSONファイルを用意して実行)
+```bash
+cd /home/akira/develop/windmill_workflow && ./wm-api.sh create-script <script.json>
+```
+
+## 注意
+- wmill CLIはCE版ではグローバルAPI認証の制限があるため使用できない
+- 代わりに `wm-api.sh` を使用してREST APIで直接操作する
+- Windmill MCP経由でも操作可能