[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AKKDKC75RQSYQJ5RC7B9EH":3,"skill-same:01M7AKKDKC75RQSYQJ5RC7B9EH":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7AKKDKC75RQSYQJ5RC7B9EH","windows-desktop-e2e",null,"E2E testing for Windows native desktop apps (WPF, WinForms, Win32\u002FMFC, Qt) using pywinauto and Windows UI Automation.","Cyrilthetecchieee\u002Fcyril-code-","Cyrilthetecchieee","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F219787998?v=4","01M7AF0MMMKRAA0H61XMJPV92H","Julian Cyril D ","01M7AF0MQ10AVG6QJQ1C2BC0F5",2,"MIT","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Fja-JP\u002Fskills\u002Fwindows-desktop-e2e\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: windows-desktop-e2e\ndescription: E2E testing for Windows native desktop apps (WPF, WinForms, Win32\u002FMFC, Qt) using pywinauto and Windows UI Automation.\norigin: ECC\n---\n\n# Windows デスクトップ E2E テスト\n\n**pywinauto** と Windows UI Automation（UIA）を使用したWindowsネイティブデスクトップアプリケーションのエンドツーエンドテスト。WPF、WinForms、Win32\u002FMFC、Qt（5.x \u002F 6.x）をカバーし、Qt固有のガイダンスは専用セクションとして提供します。\n\n## アクティベートするタイミング\n\n- Windowsネイティブデスクトップアプリケーションのエンドツーエンドテストを書くまたは実行するとき\n- デスクトップGUIテストスイートをゼロから設定するとき\n- 不安定または失敗するデスクトップオートメーションテストを診断するとき\n- 既存のアプリにテスタビリティ（AutomationId、アクセシブルな名前）を追加するとき\n- デスクトップエンドツーエンドをCI\u002FCDパイプライン（GitHub Actions `windows-latest`）に統合するとき\n\n### 使用しないタイミング\n\n- Webアプリケーション → `e2e-testing` スキル（Playwright）を使用する\n- Electron \u002F CEF \u002F WebView2 アプリ → HTMLレイヤーにはUIAではなくブラウザオートメーションが必要\n- モバイルアプリ → プラットフォーム固有のツールを使用する（UIAutomator、XCUITest）\n- 実行中のGUIを必要としない純粋なユニットまたは統合テスト\n\n## コアコンセプト\n\nすべてのWindowsデスクトップオートメーションは**UI Automation（UIA）**に依存します。これはWindowsに組み込まれたアクセシビリティAPIです。サポートされているすべてのフレームワークは、読み取りおよび操作可能なプロパティを持つUIA要素のツリーを公開します：\n\n```\nテスト（Python）\n    └── pywinauto（UIAバックエンド）\n        └── Windows UI Automation API   ← Windowsに組み込み、フレームワーク非依存\n            └── アプリのUIAプロバイダー      ← 各フレームワークが独自に実装\n                └── 実行中の .exe\n```\n\n**フレームワーク別UIA品質：**\n\n| フレームワーク | AutomationId | 信頼性 | 注記 |\n|-----------|-------------|-------------|-------|\n| WPF | 5\u002F5 | 優秀 | `x:Name` が直接AutomationIdにマッピング |\n| WinForms | 4\u002F5 | 良好 | `AccessibleName` = AutomationId |\n| UWP \u002F WinUI 3 | 5\u002F5 | 優秀 | Microsoftの完全サポート |\n| Qt 6.x | 5\u002F5 | 優秀 | アクセシビリティがデフォルトで有効；クラス名が `Qt6*` に変更 |\n| Qt 5.15+ | 4\u002F5 | 良好 | Accessibilityモジュールが改善 |\n| Qt 5.7–5.14 | 3\u002F5 | 普通 | `QT_ACCESSIBILITY=1` が必要；objectNameは手動設定 |\n| Win32 \u002F MFC | 3\u002F5 | 普通 | コントロールIDにアクセス可能；テキストマッチングが一般的 |\n\n## セットアップと前提条件\n\n```bash\n# Python 3.8+、Windowsのみ\npip install pywinauto pytest pytest-html Pillow pytest-timeout\n# オプション：画面録画\n# ffmpegをインストールしてPATHに追加：https:\u002F\u002Fffmpeg.org\u002Fdownload.html\n```\n\nUIAが到達可能か確認：\n\n```python\nfrom pywinauto import Desktop\nDesktop(backend=\"uia\").windows()  # すべてのトップレベルウィンドウを一覧表示\n```\n\n**Accessibility Insights for Windows**をインストールしてください（Microsoft提供、無料）— テストを書く前にUIA要素ツリーを検査するためのDevTools相当のツールです。\n\n## テスタビリティのセットアップ（フレームワーク別）\n\nテストを書く前に**全てのインタラクティブなコントロールに安定したAutomationIdを設定すること**が最も効果的です。\n\n### WPF\n\n```xml\n\u003C!-- XAML: x:Name が自動的にAutomationIdになる -->\n\u003CTextBox x:Name=\"usernameInput\" \u002F>\n\u003CPasswordBox x:Name=\"passwordInput\" \u002F>\n\u003CButton x:Name=\"btnLogin\" Content=\"Login\" \u002F>\n\u003CTextBlock x:Name=\"lblError\" \u002F>\n```\n\n### WinForms\n\n```csharp\n\u002F\u002F デザイナーまたはコードで設定\nusernameInput.AccessibleName = \"usernameInput\";\npasswordInput.AccessibleName = \"passwordInput\";\nbtnLogin.AccessibleName = \"btnLogin\";\nlblError.AccessibleName = \"lblError\";\n```\n\n### Win32 \u002F MFC\n\n```cpp\n\u002F\u002F .rcファイルのコントロールリソースIDがAutomationId文字列として公開される\n\u002F\u002F IDC_EDIT_USERNAME -> AutomationId \"1001\"\n\u002F\u002F 名前にはSetWindowTextを優先；より豊かなサポートにはIAccessibleを追加する\n```\n\n### Qt — 以下の専用セクションを参照\n\n---\n\n## ページオブジェクトモデル\n\n```\ntests\u002F\n├── conftest.py          # アプリ起動フィクスチャ、失敗時スクリーンショット\n├── pytest.ini\n├── config.py\n├── pages\u002F\n│   ├── __init__.py      # インポートに必須\n│   ├── base_page.py     # ロケーター、ウェイト、スクリーンショットヘルパー\n│   ├── login_page.py\n│   └── main_page.py\n├── tests\u002F\n│   ├── __init__.py\n│   ├── test_login.py\n│   └── test_main_flow.py\n└── artifacts\u002F           # スクリーンショット、動画、ログ\n```\n\n### base_page.py\n\n```python\nimport os, time\nfrom pywinauto import Desktop\nfrom config import ACTION_TIMEOUT, ARTIFACT_DIR\n\nclass BasePage:\n    def __init__(self, window):\n        self.window = window\n\n    # --- ロケーター（優先順位順）---\n\n    def by_id(self, auto_id, **kw):\n        \"\"\"AutomationId — 最も安定。第一選択として使用する。\"\"\"\n        return self.window.child_window(auto_id=auto_id, **kw)\n\n    def by_name(self, name, **kw):\n        \"\"\"表示テキスト \u002F アクセシブルな名前。\"\"\"\n        return self.window.child_window(title=name, **kw)\n\n    def by_class(self, cls, index=0, **kw):\n        \"\"\"コントロールクラス + インデックス — 脆弱、可能なら避ける。\"\"\"\n        return self.window.child_window(class_name=cls, found_index=index, **kw)\n\n    # --- ウェイト ---\n\n    def wait_visible(self, spec, timeout=ACTION_TIMEOUT):\n        spec.wait(\"visible\", timeout=timeout)\n        return spec\n\n    def wait_gone(self, spec, timeout=ACTION_TIMEOUT):\n        spec.wait_not(\"visible\", timeout=timeout)\n        return spec\n\n    def wait_window(self, title, timeout=ACTION_TIMEOUT):\n        \"\"\"新しいトップレベルウィンドウ（ダイアログ、子ウィンドウ）を待つ。\"\"\"\n        dlg = Desktop(backend=\"uia\").window(title=title)\n        dlg.wait(\"visible\", timeout=timeout)\n        return dlg\n\n    def wait_until(self, fn, timeout=ACTION_TIMEOUT, interval=0.3):\n        \"\"\"任意の条件をポーリング — UIAイベントが信頼できない場合に使用する。\"\"\"\n        deadline = time.time() + timeout\n        while time.time() \u003C deadline:\n            try:\n                if fn():\n                    return True\n            except Exception:\n                pass\n            time.sleep(interval)\n        raise TimeoutError(f\"条件が{timeout}秒以内に満たされなかった\")\n\n    # --- アクション ---\n\n    def click(self, spec):\n        self.wait_visible(spec)\n        spec.click_input()\n\n    def type_text(self, spec, text):\n        self.wait_visible(spec)\n        ctrl = spec.wrapper_object()\n        try:\n            ctrl.set_edit_text(text)\n        except Exception as e:\n            # Qt 5.x フォールバック：UIA Value Pattern が不完全な場合がある\n            import sys, pywinauto.keyboard as kb\n            print(f\"[windows-desktop-e2e] set_edit_text 失敗 ({e})、キーボードフォールバックを使用\", file=sys.stderr)\n            ctrl.click_input()\n            kb.send_keys(\"^a\")\n            kb.send_keys(text, with_spaces=True)\n\n    def get_text(self, spec):\n        ctrl = spec.wrapper_object()\n        for attr in (\"window_text\", \"get_value\"):\n            try:\n                v = getattr(ctrl, attr)()\n                if v:\n                    return v\n            except Exception:\n                pass\n        return \"\"\n\n    # --- アーティファクト ---\n\n    def screenshot(self, name):\n        os.makedirs(ARTIFACT_DIR, exist_ok=True)\n        path = os.path.join(ARTIFACT_DIR, f\"{name}.png\")\n        self.window.capture_as_image().save(path)\n        return path\n```\n\n### login_page.py\n\n```python\nfrom pages.base_page import BasePage\n\nclass LoginPage(BasePage):\n    @property\n    def username(self): return self.by_id(\"usernameInput\")\n\n    @property\n    def password(self): return self.by_id(\"passwordInput\")\n\n    @property\n    def btn_login(self): return self.by_id(\"btnLogin\")\n\n    @property\n    def error_label(self): return self.by_id(\"lblError\")\n\n    def login(self, user, pwd):\n        self.type_text(self.username, user)\n        self.type_text(self.password, pwd)\n        self.click(self.btn_login)\n\n    def login_ok(self, user, pwd, main_title=\"Main Window\"):\n        self.login(user, pwd)\n        return self.wait_window(main_title)\n\n    def login_fail(self, user, pwd):\n        self.login(user, pwd)\n        self.wait_visible(self.error_label)\n        return self.get_text(self.error_label)\n```\n\n### conftest.py\n\n> 新しいプロジェクトでは**Tier 1サンドボックスフィクスチャ**（以下参照）を優先してください — 追加コストゼロでファイルシステムの分離が追加されます。この基本フィクスチャは最小限\u002Fレガシーセットアップ専用です。\n\n```python\nimport os, pytest\nos.environ[\"QT_ACCESSIBILITY\"] = \"1\"  # Qt 5.x UIAサポートに必要\n\nfrom pywinauto import Application\nfrom config import APP_PATH, MAIN_WINDOW_TITLE, LAUNCH_TIMEOUT, ARTIFACT_DIR\n\n@pytest.fixture\ndef app(request):\n    if not APP_PATH:\n        pytest.exit(\"APP_PATH 環境変数が設定されていない\", returncode=1)\n    proc = Application(backend=\"uia\").start(APP_PATH, timeout=LAUNCH_TIMEOUT)\n    win  = proc.window(title=MAIN_WINDOW_TITLE)\n    win.wait(\"visible\", timeout=LAUNCH_TIMEOUT)\n    yield win\n    # 失敗時のスクリーンショット\n    if getattr(getattr(request.node, \"rep_call\", None), \"failed\", False):\n        os.makedirs(ARTIFACT_DIR, exist_ok=True)\n        try:\n            win.capture_as_image().save(\n                os.path.join(ARTIFACT_DIR, f\"FAIL_{request.node.name}.png\")\n            )\n        except Exception:\n            pass\n    # グレースフルな終了を試み、フォールバックとして強制終了\n    # proc は pywinauto Application — wait_for_process() ではなく wait_for_process_exit() を使用\n    try:\n        win.close()\n        proc.wait_for_process_exit(timeout=5)\n    except Exception:\n        proc.kill()\n\n@pytest.hookimpl(tryfirst=True, hookwrapper=True)\ndef pytest_runtest_makereport(item, call):\n    outcome = yield\n    setattr(item, f\"rep_{outcome.get_result().when}\", outcome.get_result())\n```\n\n### config.py\n\n```python\nimport os\nAPP_PATH          = os.environ.get(\"APP_PATH\", \"\")           # 環境変数で設定 — デフォルトパスなし\nMAIN_WINDOW_TITLE = os.environ.get(\"APP_TITLE\", \"\")\nLAUNCH_TIMEOUT    = int(os.environ.get(\"LAUNCH_TIMEOUT\", \"15\"))\nACTION_TIMEOUT    = int(os.environ.get(\"ACTION_TIMEOUT\", \"10\"))\nARTIFACT_DIR      = os.path.join(os.path.dirname(__file__), \"artifacts\")\n```\n\n### pytest.ini\n\n```ini\n[pytest]\ntestpaths = tests\nmarkers =\n    smoke: 重要なパスの高速スモークテスト\n    flaky: 既知の不安定なテスト\naddopts = -v --tb=short --html=artifacts\u002Freport.html --self-contained-html\n```\n\n## ロケーター戦略\n\n```\nAutomationId  >  Name（テキスト）  >  ClassName + インデックス  >  XPath\n  （安定）         （可読）            （脆弱）                   （最後の手段）\n```\n\nAccessibility Insights → **Properties** ペインで検査 → まず `AutomationId` を確認。\n\n```python\n# 実行時の検査 — REPLに貼り付けてツリーを探索\nwin.print_control_identifiers()\n# またはスコープを絞る：\nwin.child_window(auto_id=\"groupBox1\").print_control_identifiers()\n```\n\n## ウェイトパターン\n\n```python\n# コントロールが表示されるのを待つ\npage.wait_visible(page.by_id(\"statusLabel\"))\n\n# コントロールが消えるのを待つ（ローディングスピナーなど）\npage.wait_gone(page.by_id(\"spinnerOverlay\"))\n\n# ダイアログが表示されるのを待つ\ndlg = page.wait_window(\"Confirm Delete\")\n\n# カスタム条件（テキストの変化など）\npage.wait_until(lambda: page.get_text(page.by_id(\"lblStatus\")) == \"Ready\")\n```\n\n**`time.sleep()` を主要な同期手段として使用しないこと** — `wait()` または `wait_until()` を使用してください。\n\n## アーティファクト管理\n\n```python\n# オンデマンドスクリーンショット\npage.screenshot(\"after_login\")\n\n# フルスクリーンキャプチャ（ウィンドウが画面外または最小化されている場合）\nimport pyautogui\npyautogui.screenshot(\"artifacts\u002Ffullscreen.png\")\n\n# ffmpegによる画面録画（テスト前に開始し、テスト後に停止）\nimport subprocess\n\ndef start_recording(name):\n    return subprocess.Popen([\n        \"ffmpeg\", \"-f\", \"gdigrab\", \"-framerate\", \"10\",\n        \"-i\", \"desktop\", \"-y\", f\"artifacts\u002Fvideos\u002F{name}.mp4\"\n    ], stdin=subprocess.PIPE, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)\n\ndef stop_recording(proc):\n    proc.stdin.write(b\"q\"); proc.stdin.flush(); proc.wait(timeout=10)\n```\n\n## 不安定なテストの対処\n\n```python\n# 隔離 — PlaywrightのtestのFixmeと同等\n@pytest.mark.skip(reason=\"不安定：遅いCIでのアニメーションレース。Issue #42\")\ndef test_animated_transition(self, app): ...\n\n# CIのみでスキップ\n@pytest.mark.skipif(os.environ.get(\"CI\") == \"true\", reason=\"CIで不安定 #43\")\ndef test_heavy_load(self, app): ...\n```\n\n一般的な原因と修正：\n\n| 原因 | 修正 |\n|-------|-----|\n| コントロールが準備できていない | `time.sleep` を `wait_visible` に置き換える |\n| ウィンドウがフォーカスされていない | インタラクション前に `win.set_focus()` を追加する |\n| アニメーション進行中 | `wait_until(lambda: not loading_indicator.exists())` |\n| ダイアログのタイミング | `wait_window(title, timeout=15)` |\n| CI環境のディスプレイが準備できていない | `DISPLAY` を設定するかCIで仮想デスクトップを使用する |\n\n## テスト分離とサンドボックス\n\n分離の3つの階層 — ニーズを満たす最も軽い階層を使用してください。\n\n### Tier 1 — ファイルシステム分離（デフォルト、常に使用）\n\n各テストは `subprocess.Popen` と `Application.connect()` を通じて独自の `APPDATA` \u002F `LOCALAPPDATA` \u002F `TEMP` を取得します。pytestの `tmp_path` フィクスチャがクリーンアップを自動的に処理します。\n\n```python\n# conftest.py — 基本的な `app` フィクスチャをこれに置き換える\nimport os, subprocess, pytest\nfrom pywinauto import Application\nfrom config import APP_PATH, APP_ARGS, APP_TITLE, LAUNCH_TIMEOUT, ACTION_TIMEOUT, ARTIFACT_DIR\n\n@pytest.fixture(scope=\"function\")\ndef app(request, tmp_path):\n    \"\"\"テストごとに新しいプロセス + 分離されたユーザーデータディレクトリ。\"\"\"\n    if not APP_PATH:\n        pytest.exit(\"APP_PATH が設定されていない\", returncode=1)\n\n    # 全てのユーザーストレージを分離されたtmpディレクトリにリダイレクト\n    sandbox_env = os.environ.copy()\n    sandbox_env[\"QT_ACCESSIBILITY\"]  = \"1\"\n    sandbox_env[\"APPDATA\"]           = str(tmp_path \u002F \"AppData\" \u002F \"Roaming\")\n    sandbox_env[\"LOCALAPPDATA\"]      = str(tmp_path \u002F \"AppData\" \u002F \"Local\")\n    sandbox_env[\"TEMP\"] = sandbox_env[\"TMP\"] = str(tmp_path \u002F \"Temp\")\n    for p in (sandbox_env[\"APPDATA\"], sandbox_env[\"LOCALAPPDATA\"], sandbox_env[\"TEMP\"]):\n        os.makedirs(p, exist_ok=True)\n\n    if not APP_TITLE:\n        pytest.exit(\"APP_TITLE 環境変数が設定されていない\", returncode=1)\n\n    # shlex.splitはスペースを含む引用符付き引数を処理；plain split()は壊れる\n    import shlex\n    # subprocessで起動して環境変数を渡し；PIDでpywinautoを接続\n    proc = subprocess.Popen(\n        [APP_PATH] + shlex.split(APP_ARGS),\n        env=sandbox_env,\n    )\n    pw_app = Application(backend=\"uia\").connect(process=proc.pid, timeout=LAUNCH_TIMEOUT)\n    win    = pw_app.window(title=APP_TITLE)\n    win.wait(\"visible\", timeout=LAUNCH_TIMEOUT)\n    yield win\n\n    if getattr(getattr(request.node, \"rep_call\", None), \"failed\", False):\n        os.makedirs(ARTIFACT_DIR, exist_ok=True)\n        try:\n            win.capture_as_image().save(\n                os.path.join(ARTIFACT_DIR, f\"FAIL_{request.node.name}.png\")\n            )\n        except Exception:\n            pass\n    try:\n        win.close()\n        proc.wait(timeout=5)\n    except Exception:\n        proc.kill()\n    # tmp_pathはpytestによって自動的にクリーンアップされる\n\n@pytest.hookimpl(tryfirst=True, hookwrapper=True)\ndef pytest_runtest_makereport(item, call):\n    outcome = yield\n    setattr(item, f\"rep_{outcome.get_result().when}\", outcome.get_result())\n```\n\n### Tier 2 — Windowsジョブオブジェクト（オプション：プロセスライフタイムの封じ込め）\n\nプロセスをジョブオブジェクトにアタッチして、テストフィクスチャのジョブハンドルがGCされたときに**自動的に終了**させます。また、フィクスチャのクリーンアップから逃れる子プロセスのスポーンも防止します。\n\n> **分離のスコープ：** ジョブオブジェクトはファイルシステムアクセスの仮想化や\n> ネットワークトラフィックのブロックを行いません。ファイル書き込みとネットワーク分離には\n> AppContainer、Windowsファイアウォールルール、またはTier 3（Windowsサンドボックス）が必要です。\n> Tier 2はプロセスライフタイムと子プロセスの封じ込めにのみ使用してください。\n\n追加の依存関係は不要です。\n\n```python\nimport ctypes, ctypes.wintypes as wt\n\ndef restrict_process(pid: int):\n    \"\"\"\n    プロセスをジョブオブジェクトにアタッチして以下を防止：\n    - ジョブ外でのプロセスのスポーン（LIMIT_KILL_ON_JOB_CLOSE）\n    ネットワークはブロックしません — Windowsファイアウォールルールを使用してください。\n    \"\"\"\n    JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE = 0x00002000\n    # 最小限の権限：SET_QUOTA (0x0100) | TERMINATE (0x0001)\n    PROCESS_SET_QUOTA_AND_TERMINATE    = 0x0101\n\n    kernel32 = ctypes.windll.kernel32\n    job   = kernel32.CreateJobObjectW(None, None)\n    hproc = kernel32.OpenProcess(PROCESS_SET_QUOTA_AND_TERMINATE, False, pid)\n\n    # 正しい構造体レイアウト — LimitFlagsはオフセット+16（+44ではない）\n    class JOBOBJECT_BASIC_LIMIT_INFORMATION(ctypes.Structure):\n        _fields_ = [\n            (\"PerProcessUserTimeLimit\", wt.LARGE_INTEGER),\n            (\"PerJobUserTimeLimit\",     wt.LARGE_INTEGER),\n            (\"LimitFlags\",             wt.DWORD),\n            (\"MinimumWorkingSetSize\",   ctypes.c_size_t),\n            (\"MaximumWorkingSetSize\",   ctypes.c_size_t),\n            (\"ActiveProcessLimit\",      wt.DWORD),\n            (\"Affinity\",               ctypes.c_size_t),\n            (\"PriorityClass\",          wt.DWORD),\n            (\"SchedulingClass\",        wt.DWORD),\n        ]\n\n    info = JOBOBJECT_BASIC_LIMIT_INFORMATION()\n    info.LimitFlags = JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE\n    ok = kernel32.SetInformationJobObject(job, 2, ctypes.byref(info), ctypes.sizeof(info))\n    if not ok:\n        raise ctypes.WinError()\n    kernel32.AssignProcessToJobObject(job, hproc)\n    kernel32.CloseHandle(hproc)\n    return job  # 生存を維持 — ジョブが閉じると（GC時）プロセスが終了する\n\n# proc = subprocess.Popen(...) の後：  job = restrict_process(proc.pid)\n```\n\n### Tier 3 — Windowsサンドボックス（CI完全OS分離）\n\n実行ごとにクリーンなWindowsイメージが必要な場合（残留レジストリキーなし、共有GPUステートなし、真の分離）、[Windowsサンドボックス](https:\u002F\u002Flearn.microsoft.com\u002Fwindows\u002Fsecurity\u002Fapplication-security\u002Fapplication-isolation\u002Fwindows-sandbox\u002Fwindows-sandbox-overview)内で**テストスイート全体**を実行します。\n\n**要件：** Windows 10\u002F11 Pro またはエンタープライズ、仮想化が有効。\n\nプロジェクトルートに `e2e-sandbox.wsb` を作成：\n\n```xml\n\u003CConfiguration>\n  \u003CMappedFolders>\n    \u003C!-- アプリバイナリ（読み取り専用） -->\n    \u003CMappedFolder>\n      \u003CHostFolder>C:\\path\\to\\your\\build\\Release\u003C\u002FHostFolder>\n      \u003CSandboxFolder>C:\\app\u003C\u002FSandboxFolder>\n      \u003CReadOnly>true\u003C\u002FReadOnly>\n    \u003C\u002FMappedFolder>\n    \u003C!-- テストスイート（アーティファクト用に読み書き可能） -->\n    \u003CMappedFolder>\n      \u003CHostFolder>C:\\path\\to\\your\\e2e_test\u003C\u002FHostFolder>\n      \u003CSandboxFolder>C:\\e2e_test\u003C\u002FSandboxFolder>\n      \u003CReadOnly>false\u003C\u002FReadOnly>\n    \u003C\u002FMappedFolder>\n  \u003C\u002FMappedFolders>\n  \u003CLogonCommand>\n    \u003C!--\n      WindowsサンドボックスはデフォルトでPythonがない。まずサイレントインストール、\n      次に依存関係をインストールしてテストを実行する。アーティファクトは\n      上記のMappedFolderを通じてホストに書き戻される。\n    -->\n    \u003CCommand>powershell -Command \"\n      winget install --id Python.Python.3.11 --silent --accept-package-agreements;\n      $env:PATH += ';' + $env:LOCALAPPDATA + '\\Programs\\Python\\Python311\\Scripts';\n      cd C:\\e2e_test;\n      pip install -r requirements.txt;\n      pytest tests\\ -v\n    \"\u003C\u002FCommand>\n  \u003C\u002FLogonCommand>\n\u003C\u002FConfiguration>\n```\n\n起動：`WindowsSandbox.exe e2e-sandbox.wsb`\n\n> pywinautoとアプリは両方ともサンドボックス**内**で実行されます（同じセッションが必要）。\n> アーティファクトはマップされたフォルダーを通じてホストに書き戻されます。\n\n### 階層の比較\n\n| 階層 | 分離 | セットアップコスト | CIで動作 | 使用タイミング |\n|------|-----------|-----------|-------------|----------|\n| 1 — `tmp_path` 環境リダイレクト | ファイルシステム | ゼロ | 常に | 全テストのデフォルト |\n| 2 — ジョブオブジェクト | プロセスツリー | 低 | 常に | 子プロセスの逃走を防止 |\n| 3 — Windowsサンドボックス | 完全OS | 中 | Pro\u002FEnterpriseイメージが必要 | 定期的なクリーンルーム実行 |\n\n### テストのハングを防止する\n\n`pytest-timeout` を追加して単一テストに上限を設けます。`pytest.ini` で `timeout = 60` と `timeout_method = thread` を設定します。注意：`thread` メソッドはWindows上でQtアプリのサブプロセスを終了できません — `conftest.py` に `atexit.register(lambda: [p.kill() for p in psutil.Process().children(recursive=True)])` を追加してオーファンを刈り取ってください。\n\n## CI\u002FCDインテグレーション\n\n```yaml\n# .github\u002Fworkflows\u002Fe2e-desktop.yml\nname: Desktop E2E\non: [push, pull_request]\n\njobs:\n  e2e:\n    runs-on: windows-latest   # 実際のGUI環境、Xvfb不要\n    steps:\n      - uses: actions\u002Fcheckout@v4\n\n      - uses: actions\u002Fsetup-python@v5\n        with: { python-version: \"3.11\" }\n\n      - name: 依存関係をインストール\n        run: pip install pywinauto pytest pytest-html Pillow\n\n      - name: アプリをビルド\n        run: cmake --build build --config Release  # ビルドシステムに合わせて調整\n\n      - name: E2Eを実行\n        env:\n          APP_PATH: ${{ github.workspace }}\\build\\Release\\MyApp.exe\n          APP_TITLE: \"My Application\"\n          CI: \"true\"\n        run: pytest tests\u002F --html=artifacts\u002Freport.html --self-contained-html --junitxml=artifacts\u002Fresults.xml -v\n\n      - uses: actions\u002Fupload-artifact@v4\n        if: always()\n        with:\n          name: e2e-artifacts\n          path: artifacts\u002F\n          retention-days: 14\n```\n\n## Qt固有\n\n### Qt 5.xでのUIA有効化\n\nQt 5.xのアクセシビリティは一部のビルド（特に5.7〜5.14）でデフォルトが無効です。起動前に環境変数を設定してください。Qt 6.xはデフォルトでアクセシビリティが有効です — Qt 6ではこのステップをスキップしてください。\n\n```python\n# conftest.py — モジュールの先頭に追加\nimport os\nos.environ[\"QT_ACCESSIBILITY\"] = \"1\"\n```\n\nまたはCIでエクスポート：\n\n```yaml\nenv:\n  QT_ACCESSIBILITY: \"1\"\n```\n\n### Qtウィジェットへの安定した識別子の追加\n\n```cpp\n\u002F\u002F 優先：objectNameとaccessibleNameの両方\nvoid setTestId(QWidget* w, const char* id) {\n    w->setObjectName(id);\n    w->setAccessibleName(id);  \u002F\u002F UIA Nameプロパティになる\n}\n\n\u002F\u002F ダイアログコンストラクタ内：\nsetTestId(ui->usernameEdit, \"usernameInput\");\nsetTestId(ui->passwordEdit, \"passwordInput\");\nsetTestId(ui->loginButton,  \"btnLogin\");\nsetTestId(ui->errorLabel,   \"lblError\");\n```\n\nタイポを避けるためにすべてのIDをヘッダーに集約：\n\n```cpp\n\u002F\u002F test_ids.h\n#define TID_USERNAME   \"usernameInput\"\n#define TID_PASSWORD   \"passwordInput\"\n#define TID_BTN_LOGIN  \"btnLogin\"\n#define TID_LBL_ERROR  \"lblError\"\n```\n\n### Qt固有の注意点\n\n**QComboBox** — ドロップダウンは別のトップレベルウィンドウです：\n\n```python\nfrom pywinauto import Desktop\n\ndef select_combo_item(page, combo_spec, item_text):\n    page.click(combo_spec)\n    # ドロップダウンは新しいルートレベルウィンドウとして表示される\n    # class_nameはQtバージョンによって異なる — Accessibility Insightsで確認\n    # Qt 5.x: \"Qt5QWindowIcon\"  |  Qt 6.x: \"Qt6QWindowIcon\" — Accessibility Insightsで確認\n    popup = Desktop(backend=\"uia\").window(class_name_re=\"Qt[56]QWindowIcon\")\n    popup.wait(\"visible\", timeout=5)\n    popup.child_window(title=item_text).click_input()\n```\n\n**QMessageBox \u002F QDialog** — これも別のトップレベルウィンドウです：\n\n```python\ndlg = page.wait_window(\"Confirm\")          # ダイアログタイトルを待つ\ndlg.child_window(title=\"OK\").click_input() # 内部のボタンをクリック\n```\n\n**QTableWidget \u002F QTableView** — 行\u002Fセルアクセス：\n\n```python\ntable = page.by_id(\"tblUsers\").wrapper_object()\ncell  = table.cell(row=0, column=1)\nprint(cell.window_text())\n```\n\n**自己描画コントロール**（`paintEvent`のみ、`QGraphicsView`、`QOpenGLWidget`）— UIAは内部を見ることができません。以下のフォールバックセクションを使用してください。\n\n## フォールバック：スクリーンショットモード\n\nコントロールがUIAで到達できない場合（自己描画、サードパーティ、ゲームエンジン）：\n\n```bash\npip install pyautogui Pillow opencv-python\n```\n\n```python\nimport pyautogui, cv2, numpy as np\nfrom PIL import Image\n\ndef find_image_on_screen(template_path, confidence=0.85):\n    \"\"\"画面上のテンプレート画像を探す。(x, y) の中心またはNoneを返す。\"\"\"\n    screen   = np.array(pyautogui.screenshot())\n    template = np.array(Image.open(template_path))\n    result   = cv2.matchTemplate(\n        cv2.cvtColor(screen, cv2.COLOR_RGB2BGR),\n        cv2.cvtColor(template, cv2.COLOR_RGB2BGR),\n        cv2.TM_CCOEFF_NORMED,\n    )\n    _, max_val, _, max_loc = cv2.minMaxLoc(result)\n    if max_val >= confidence:\n        h, w = template.shape[:2]\n        return max_loc[0] + w \u002F\u002F 2, max_loc[1] + h \u002F\u002F 2\n    return None\n\ndef click_image(template_path, confidence=0.85):\n    pos = find_image_on_screen(template_path, confidence)\n    if pos is None:\n        raise RuntimeError(f\"画面上で画像が見つからない：{template_path}\")\n    pyautogui.click(*pos)\n```\n\n**控えめに使用すること** — 画像マッチングはDPI変更、テーマ切り替え、部分的な遮蔽で壊れます。\n常にUIAを最初に試し、本当に到達できないコントロールにのみスクリーンショットにフォールバックしてください。\n\n## アンチパターン\n\n```python\n# BAD: 固定スリープ\ntime.sleep(3)\npage.click(page.by_id(\"btnSubmit\"))\n\n# GOOD: 条件ウェイト\npage.wait_visible(page.by_id(\"btnSubmit\"))\npage.click(page.by_id(\"btnSubmit\"))\n```\n\n```python\n# BAD: 主要戦略として脆弱なクラス+インデックスロケーター\npage.by_class(\"Edit\", index=2).type_keys(\"hello\")\n\n# GOOD: AutomationId\npage.by_id(\"usernameInput\").set_edit_text(\"hello\")\n```\n\n```python\n# BAD: ピクセル座標でのアサート\nassert btn.rectangle().left == 120\n\n# GOOD: コンテンツ\u002F状態でのアサート\nassert page.get_text(page.by_id(\"lblStatus\")) == \"Logged in\"\nassert page.by_id(\"btnLogout\").is_enabled()\n```\n\n```python\n# BAD: 全テストにわたってアプリインスタンスを共有（状態の漏洩）\n@pytest.fixture(scope=\"session\")\ndef app(): ...\n\n# GOOD: テストごとに新しいプロセス（または最大でもクラスごと）\n@pytest.fixture(scope=\"function\")\ndef app(): ...\n```\n\n## テストの実行\n\n```bash\n# 全テスト\npytest tests\u002F -v\n\n# スモークのみ\npytest tests\u002F -m smoke -v\n\n# 特定ファイル\npytest tests\u002Ftest_login.py -v\n\n# カスタムアプリパスで実行\nAPP_PATH=\"C:\\build\\Release\\MyApp.exe\" APP_TITLE=\"MyApp\" pytest tests\u002F -v\n\n# 不安定なテストを検出（各テストを5回繰り返す）\npip install pytest-repeat\npytest tests\u002Ftest_login.py --count=5 -v\n```\n\n## 関連スキル\n\n- `e2e-testing` — WebアプリケーションのPlaywright E2Eテスト\n- `cpp-testing` — GoogleTestを使用したC++ユニット\u002F統合テスト\n- `cpp-coding-standards` — C++コードスタイルとパターン\n","# Windows デスクトップ E2E テスト\n\n**pywinauto** と Windows UI Automation（UIA）を使用したWindowsネイティブデスクトップアプリケーションのエンドツーエンドテスト。WPF、WinForms、Win32\u002FMFC、Qt（5.x \u002F 6.x）をカバーし、Qt固有のガイダンスは専用セクションとして提供します。\n\n## アクティベートするタイミング\n\n- Windowsネイティブデスクトップアプリケーションのエンドツーエンドテストを書くまたは実行するとき\n- デスクトップGUIテストスイートをゼロから設定するとき\n- 不安定または失敗するデスクトップオートメーションテストを診断するとき\n- 既存のアプリにテスタビリティ（AutomationId、アクセシブルな名前）を追加するとき\n- デスクトップエンドツーエンドをCI\u002FCDパイプライン（GitHub Actions `windows-latest`）に統合するとき\n\n### 使用しないタイミング\n\n- Webアプリケーション → `e2e-testing` スキル（Playwright）を使用する\n- Electron \u002F CEF \u002F WebView2 アプリ → HTMLレイヤーにはUIAではなくブラウザオートメーションが必要\n- モバイルアプリ → プラットフォーム固有のツールを使用する（UIAutomator、XCUITest）\n- 実行中のGUIを必要としない純粋なユニットまたは統合テスト\n\n## コアコンセプト\n\nすべてのWindowsデスクトップオートメーションは**UI Automation（UIA）**に依存します。これはWindowsに組み込まれたアクセシビリティAPIです。サポートされているすべてのフレームワークは、読み取りおよび操作可能なプロパティを持つUIA要素のツリーを公開します：\n\n```\nテスト（Python）\n    └── pywinauto（UIAバックエンド）\n        └── Windows UI Automation API   ← Windowsに組み込み、フレームワーク非依存\n            └── アプリのUIAプロバイダー      ← 各フレームワークが独自に実装\n                └── 実行中の .exe\n```\n\n**フレームワーク別UIA品質：**\n\n| フレームワーク | AutomationId | 信頼性 | 注記 |\n|-----------|-------------|-------------|-------|\n| WPF | 5\u002F5 | 優秀 | `x:Name` が直接AutomationIdにマッピング |\n| WinForms | 4\u002F5 | 良好 | `AccessibleName` = AutomationId |\n| UWP \u002F WinUI 3 | 5\u002F5 | 優秀 | Microsoftの完全サポート |\n| Qt 6.x | 5\u002F5 | 優秀 | アクセシビリティがデフォルトで有効；クラス名が `Qt6*` に変更 |\n| Qt 5.15+ | 4\u002F5 | 良好 | Accessibilityモジュールが改善 |\n| Qt 5.7–5.14 | 3\u002F5 | 普通 | `QT_ACCESSIBILITY=1` が必要；objectNameは手動設定 |\n| Win32 \u002F MFC | 3\u002F5 | 普通 | コントロールIDにアクセス可能；テキストマッチングが一般的 |\n\n## セットアップと前提条件\n\n```bash\n# Python 3.8+、Windowsのみ\npip install pywinauto pytest pytest-html Pillow pytest-timeout\n# オプション：画面録画\n# ffmpegをインストールしてPATHに追加：https:\u002F\u002Fffmpeg.org\u002Fdownload.html\n```\n\nUIAが到達可能か確認：\n\n```python\nfrom pywinauto import Desktop\nDesktop(backend=\"uia\").windows()  # すべてのトップレベルウィンドウを一覧表示\n```\n\n**Accessibility Insights for Windows**をインストールしてください（Microsoft提供、無料）— テストを書く前にUIA要素ツリーを検査するためのDevTools相当のツールです。\n\n## テスタビリティのセットアップ（フレームワーク別）\n\nテストを書く前に**全てのインタラクティブなコントロールに安定したAutomationIdを設定すること**が最も効果的です。\n\n### WPF\n\n```xml\n\u003C!-- XAML: x:Name が自動的にAutomationIdになる -->\n\u003CTextBox x:Name=\"usernameInput\" \u002F>\n\u003CPasswordBox x:Name=\"passwordInput\" \u002F>\n\u003CButton x:Name=\"btnLogin\" Content=\"Login\" \u002F>\n\u003CTextBlock x:Name=\"lblError\" \u002F>\n```\n\n### WinForms\n\n```csharp\n\u002F\u002F デザイナーまたはコードで設定\nusernameInput.AccessibleName = \"usernameInput\";\npasswordInput.AccessibleName = \"passwordInput\";\nbtnLogin.AccessibleName = \"btnLogin\";\nlblError.AccessibleName = \"lblError\";\n```\n\n### Win32 \u002F MFC\n\n```cpp\n\u002F\u002F .rcファイルのコントロールリソースIDがAutomationId文字列として公開される\n\u002F\u002F IDC_EDIT_USERNAME -> AutomationId \"1001\"\n\u002F\u002F 名前にはSetWindowTextを優先；より豊かなサポートにはIAccessibleを追加する\n```\n\n### Qt — 以下の専用セクションを参照\n\n---\n\n## ページオブジェクトモデル\n\n```\ntests\u002F\n├── conftest.py          # アプリ起動フィクスチャ、失敗時スクリーンショット\n├── pytest.ini\n├── config.py\n├── pages\u002F\n│   ├── __init__.py      # インポートに必須\n│   ├── base_page.py     # ロケーター、ウェイト、スクリーンショットヘルパー\n│   ├── login_page.py\n│   └── main_page.py\n├── tests\u002F\n│   ├── __init__.py\n│   ├── test_login.py\n│   └── test_main_flow.py\n└── artifacts\u002F           # スクリーンショット、動画、ログ\n```\n\n### base_page.py\n\n```python\nimport os, time\nfrom pywinauto import Desktop\nfrom config import ACTION_TIMEOUT, ARTIFACT_DIR\n\nclass BasePage:\n    def __init__(self, window):\n        self.window = window\n\n    # --- ロケーター（優先順位順）---\n\n    def by_id(self, auto_id, **kw):\n        \"\"\"AutomationId — 最も安定。第一選択として使用する。\"\"\"\n        return self.window.child_window(auto_id=auto_id, **kw)\n\n    def by_name(self, name, **kw):\n        \"\"\"表示テキスト \u002F アクセシブルな名前。\"\"\"\n        return self.window.child_window(title=name, **kw)\n\n    def by_class(self, cls, index=0, **kw):\n        \"\"\"コントロールクラス + インデックス — 脆弱、可能なら避ける。\"\"\"\n        return self.window.child_window(class_name=cls, found_index=index, **kw)\n\n    # --- ウェイト ---\n\n    def wait_visible(self, spec, timeout=ACTION_TIMEOUT):\n        spec.wait(\"visible\", timeout=timeout)\n        return spec\n\n    def wait_gone(self, spec, timeout=ACTION_TIMEOUT):\n        spec.wait_not(\"visible\", timeout=timeout)\n        return spec\n\n    def wait_window(self, title, timeout=ACTION_TIMEOUT):\n        \"\"\"新しいトップレベルウィンドウ（ダイアログ、子ウィンドウ）を待つ。\"\"\"\n        dlg = Desktop(backend=\"uia\").window(title=title)\n        dlg.wait(\"visible\", timeout=timeout)\n        return dlg\n\n    def wait_until(self, fn, timeout=ACTION_TIMEOUT, interval=0.3):\n        \"\"\"任意の条件をポーリング — UIAイベントが信頼できない場合に使用する。\"\"\"\n        deadline = time.time() + timeout\n        while time.time() \u003C deadline:\n            try:\n                if fn():\n                    return True\n            except Exception:\n                pass\n            time.sleep(interval)\n        raise TimeoutError(f\"条件が{timeout}秒以内に満たされなかった\")\n\n    # --- アクション ---\n\n    def click(self, spec):\n        self.wait_visible(spec)\n        spec.click_input()\n\n    def type_text(self, spec, text):\n        self.wait_visible(spec)\n        ctrl = spec.wrapper_object()\n        try:\n            ctrl.set_edit_text(text)\n        except Exception as e:\n            # Qt 5.x フォールバック：UIA Value Pattern が不完全な場合がある\n            import sys, pywinauto.keyboard as kb\n            print(f\"[windows-desktop-e2e] set_edit_text 失敗 ({e})、キーボードフォールバックを使用\", file=sys.stderr)\n            ctrl.click_input()\n            kb.send_keys(\"^a\")\n            kb.send_keys(text, with_spaces=True)\n\n    def get_text(self, spec):\n        ctrl = spec.wrapper_object()\n        for attr in (\"window_text\", \"get_value\"):\n            try:\n                v = getattr(ctrl, attr)()\n                if v:\n                    return v\n            except Exception:\n                pass\n        return \"\"\n\n    # --- アーティファクト ---\n\n    def screenshot(self, name):\n        os.makedirs(ARTIFACT_DIR, exist_ok=True)\n        path = os.path.join(ARTIFACT_DIR, f\"{name}.png\")\n        self.window.capture_as_image().save(path)\n        return path\n```\n\n### login_page.py\n\n```python\nfrom pages.base_page import BasePage\n\nclass LoginPage(BasePage):\n    @property\n    def username(self): return self.by_id(\"usernameInput\")\n\n    @property\n    def password(self): return self.by_id(\"passwordInput\")\n\n    @property\n    def btn_login(self): return self.by_id(\"btnLogin\")\n\n    @property\n    def error_label(self): return self.by_id(\"lblError\")\n\n    def login(self, user, pwd):\n        self.type_text(self.username, user)\n        self.type_text(self.password, pwd)\n        self.click(self.btn_login)\n\n    def login_ok(self, user, pwd, main_title=\"Main Window\"):\n        self.login(user, pwd)\n        return self.wait_window(main_title)\n\n    def login_fail(self, user, pwd):\n        self.login(user, pwd)\n        self.wait_visible(self.error_label)\n        return self.get_text(self.error_label)\n```\n\n### conftest.py\n\n> 新しいプロジェクトでは**Tier 1サンドボックスフィクスチャ**（以下参照）を優先してください — 追加コストゼロでファイルシステムの分離が追加されます。この基本フィクスチャは最小限\u002Fレガシーセットアップ専用です。\n\n```python\nimport os, pytest\nos.environ[\"QT_ACCESSIBILITY\"] = \"1\"  # Qt 5.x UIAサポートに必要\n\nfrom pywinauto import Application\nfrom config import APP_PATH, MAIN_WINDOW_TITLE, LAUNCH_TIMEOUT, ARTIFACT_DIR\n\n@pytest.fixture\ndef app(request):\n    if not APP_PATH:\n        pytest.exit(\"APP_PATH 環境変数が設定されていない\", returncode=1)\n    proc = Application(backend=\"uia\").start(APP_PATH, timeout=LAUNCH_TIMEOUT)\n    win  = proc.window(title=MAIN_WINDOW_TITLE)\n    win.wait(\"visible\", timeout=LAUNCH_TIMEOUT)\n    yield win\n    # 失敗時のスクリーンショット\n    if getattr(getattr(request.node, \"rep_call\", None), \"failed\", False):\n        os.makedirs(ARTIFACT_DIR, exist_ok=True)\n        try:\n            win.capture_as_image().save(\n                os.path.join(ARTIFACT_DIR, f\"FAIL_{request.node.name}.png\")\n            )\n        except Exception:\n            pass\n    # グレースフルな終了を試み、フォールバックとして強制終了\n    # proc は pywinauto Application — wait_for_process() ではなく wait_for_process_exit() を使用\n    try:\n        win.close()\n        proc.wait_for_process_exit(timeout=5)\n    except Exception:\n        proc.kill()\n\n@pytest.hookimpl(tryfirst=True, hookwrapper=True)\ndef pytest_runtest_makereport(item, call):\n    outcome = yield\n    setattr(item, f\"rep_{outcome.get_result().when}\", outcome.get_result())\n```\n\n### config.py\n\n```python\nimport os\nAPP_PATH          = os.environ.get(\"APP_PATH\", \"\")           # 環境変数で設定 — デフォルトパスなし\nMAIN_WINDOW_TITLE = os.environ.get(\"APP_TITLE\", \"\")\nLAUNCH_TIMEOUT    = int(os.environ.get(\"LAUNCH_TIMEOUT\", \"15\"))\nACTION_TIMEOUT    = int(os.environ.get(\"ACTION_TIMEOUT\", \"10\"))\nARTIFACT_DIR      = os.path.join(os.path.dirname(__file__), \"artifacts\")\n```\n\n### pytest.ini\n\n```ini\n[pytest]\ntestpaths = tests\nmarkers =\n    smoke: 重要なパスの高速スモークテスト\n    flaky: 既知の不安定なテスト\naddopts = -v --tb=short --html=artifacts\u002Freport.html --self-contained-html\n```\n\n## ロケーター戦略\n\n```\nAutomationId  >  Name（テキスト）  >  ClassName + インデックス  >  XPath\n  （安定）         （可読）            （脆弱）                   （最後の手段）\n```\n\nAccessibility Insights → **Properties** ペインで検査 → まず `AutomationId` を確認。\n\n```python\n# 実行時の検査 — REPLに貼り付けてツリーを探索\nwin.print_control_identifiers()\n# またはスコープを絞る：\nwin.child_window(auto_id=\"groupBox1\").print_control_identifiers()\n```\n\n## ウェイトパターン\n\n```python\n# コントロールが表示されるのを待つ\npage.wait_visible(page.by_id(\"statusLabel\"))\n\n# コントロールが消えるのを待つ（ローディングスピナーなど）\npage.wait_gone(page.by_id(\"spinnerOverlay\"))\n\n# ダイアログが表示されるのを待つ\ndlg = page.wait_window(\"Confirm Delete\")\n\n# カスタム条件（テキストの変化など）\npage.wait_until(lambda: page.get_text(page.by_id(\"lblStatus\")) == \"Ready\")\n```\n\n**`time.sleep()` を主要な同期手段として使用しないこと** — `wait()` または `wait_until()` を使用してください。\n\n## アーティファクト管理\n\n```python\n# オンデマンドスクリーンショット\npage.screenshot(\"after_login\")\n\n# フルスクリーンキャプチャ（ウィンドウが画面外または最小化されている場合）\nimport pyautogui\npyautogui.screenshot(\"artifacts\u002Ffullscreen.png\")\n\n# ffmpegによる画面録画（テスト前に開始し、テスト後に停止）\nimport subprocess\n\ndef start_recording(name):\n    return subprocess.Popen([\n        \"ffmpeg\", \"-f\", \"gdigrab\", \"-framerate\", \"10\",\n        \"-i\", \"desktop\", \"-y\", f\"artifacts\u002Fvideos\u002F{name}.mp4\"\n    ], stdin=subprocess.PIPE, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)\n\ndef stop_recording(proc):\n    proc.stdin.write(b\"q\"); proc.stdin.flush(); proc.wait(timeout=10)\n```\n\n## 不安定なテストの対処\n\n```python\n# 隔離 — PlaywrightのtestのFixmeと同等\n@pytest.mark.skip(reason=\"不安定：遅いCIでのアニメーションレース。Issue #42\")\ndef test_animated_transition(self, app): ...\n\n# CIのみでスキップ\n@pytest.mark.skipif(os.environ.get(\"CI\") == \"true\", reason=\"CIで不安定 #43\")\ndef test_heavy_load(self, app): ...\n```\n\n一般的な原因と修正：\n\n| 原因 | 修正 |\n|-------|-----|\n| コントロールが準備できていない | `time.sleep` を `wait_visible` に置き換える |\n| ウィンドウがフォーカスされていない | インタラクション前に `win.set_focus()` を追加する |\n| アニメーション進行中 | `wait_until(lambda: not loading_indicator.exists())` |\n| ダイアログのタイミング | `wait_window(title, timeout=15)` |\n| CI環境のディスプレイが準備できていない | `DISPLAY` を設定するかCIで仮想デスクトップを使用する |\n\n## テスト分離とサンドボックス\n\n分離の3つの階層 — ニーズを満たす最も軽い階層を使用してください。\n\n### Tier 1 — ファイルシステム分離（デフォルト、常に使用）\n\n各テストは `subprocess.Popen` と `Application.connect()` を通じて独自の `APPDATA` \u002F `LOCALAPPDATA` \u002F `TEMP` を取得します。pytestの `tmp_path` フィクスチャがクリーンアップを自動的に処理します。\n\n```python\n# conftest.py — 基本的な `app` フィクスチャをこれに置き換える\nimport os, subprocess, pytest\nfrom pywinauto import Application\nfrom config import APP_PATH, APP_ARGS, APP_TITLE, LAUNCH_TIMEOUT, ACTION_TIMEOUT, ARTIFACT_DIR\n\n@pytest.fixture(scope=\"function\")\ndef app(request, tmp_path):\n    \"\"\"テストごとに新しいプロセス + 分離されたユーザーデータディレクトリ。\"\"\"\n    if not APP_PATH:\n        pytest.exit(\"APP_PATH が設定されていない\", returncode=1)\n\n    # 全てのユーザーストレージを分離されたtmpディレクトリにリダイレクト\n    sandbox_env = os.environ.copy()\n    sandbox_env[\"QT_ACCESSIBILITY\"]  = \"1\"\n    sandbox_env[\"APPDATA\"]           = str(tmp_path \u002F \"AppData\" \u002F \"Roaming\")\n    sandbox_env[\"LOCALAPPDATA\"]      = str(tmp_path \u002F \"AppData\" \u002F \"Local\")\n    sandbox_env[\"TEMP\"] = sandbox_env[\"TMP\"] = str(tmp_path \u002F \"Temp\")\n    for p in (sandbox_env[\"APPDATA\"], sandbox_env[\"LOCALAPPDATA\"], sandbox_env[\"TEMP\"]):\n        os.makedirs(p, exist_ok=True)\n\n    if not APP_TITLE:\n        pytest.exit(\"APP_TITLE 環境変数が設定されていない\", returncode=1)\n\n    # shlex.splitはスペースを含む引用符付き引数を処理；plain split()は壊れる\n    import shlex\n    # subprocessで起動して環境変数を渡し；PIDでpywinautoを接続\n    proc = subprocess.Popen(\n        [APP_PATH] + shlex.split(APP_ARGS),\n        env=sandbox_env,\n    )\n    pw_app = Application(backend=\"uia\").connect(process=proc.pid, timeout=LAUNCH_TIMEOUT)\n    win    = pw_app.window(title=APP_TITLE)\n    win.wait(\"visible\", timeout=LAUNCH_TIMEOUT)\n    yield win\n\n    if getattr(getattr(request.node, \"rep_call\", None), \"failed\", False):\n        os.makedirs(ARTIFACT_DIR, exist_ok=True)\n        try:\n            win.capture_as_image().save(\n                os.path.join(ARTIFACT_DIR, f\"FAIL_{request.node.name}.png\")\n            )\n        except Exception:\n            pass\n    try:\n        win.close()\n        proc.wait(timeout=5)\n    except Exception:\n        proc.kill()\n    # tmp_pathはpytestによって自動的にクリーンアップされる\n\n@pytest.hookimpl(tryfirst=True, hookwrapper=True)\ndef pytest_runtest_makereport(item, call):\n    outcome = yield\n    setattr(item, f\"rep_{outcome.get_result().when}\", outcome.get_result())\n```\n\n### Tier 2 — Windowsジョブオブジェクト（オプション：プロセスライフタイムの封じ込め）\n\nプロセスをジョブオブジェクトにアタッチして、テストフィクスチャのジョブハンドルがGCされたときに**自動的に終了**させます。また、フィクスチャのクリーンアップから逃れる子プロセスのスポーンも防止します。\n\n> **分離のスコープ：** ジョブオブジェクトはファイルシステムアクセスの仮想化や\n> ネットワークトラフィックのブロックを行いません。ファイル書き込みとネットワーク分離には\n> AppContainer、Windowsファイアウォールルール、またはTier 3（Windowsサンドボックス）が必要です。\n> Tier 2はプロセスライフタイムと子プロセスの封じ込めにのみ使用してください。\n\n追加の依存関係は不要です。\n\n```python\nimport ctypes, ctypes.wintypes as wt\n\ndef restrict_process(pid: int):\n    \"\"\"\n    プロセスをジョブオブジェクトにアタッチして以下を防止：\n    - ジョブ外でのプロセスのスポーン（LIMIT_KILL_ON_JOB_CLOSE）\n    ネットワークはブロックしません — Windowsファイアウォールルールを使用してください。\n    \"\"\"\n    JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE = 0x00002000\n    # 最小限の権限：SET_QUOTA (0x0100) | TERMINATE (0x0001)\n    PROCESS_SET_QUOTA_AND_TERMINATE    = 0x0101\n\n    kernel32 = ctypes.windll.kernel32\n    job   = kernel32.CreateJobObjectW(None, None)\n    hproc = kernel32.OpenProcess(PROCESS_SET_QUOTA_AND_TERMINATE, False, pid)\n\n    # 正しい構造体レイアウト — LimitFlagsはオフセット+16（+44ではない）\n    class JOBOBJECT_BASIC_LIMIT_INFORMATION(ctypes.Structure):\n        _fields_ = [\n            (\"PerProcessUserTimeLimit\", wt.LARGE_INTEGER),\n            (\"PerJobUserTimeLimit\",     wt.LARGE_INTEGER),\n            (\"LimitFlags\",             wt.DWORD),\n            (\"MinimumWorkingSetSize\",   ctypes.c_size_t),\n            (\"MaximumWorkingSetSize\",   ctypes.c_size_t),\n            (\"ActiveProcessLimit\",      wt.DWORD),\n            (\"Affinity\",               ctypes.c_size_t),\n            (\"PriorityClass\",          wt.DWORD),\n            (\"SchedulingClass\",        wt.DWORD),\n        ]\n\n    info = JOBOBJECT_BASIC_LIMIT_INFORMATION()\n    info.LimitFlags = JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE\n    ok = kernel32.SetInformationJobObject(job, 2, ctypes.byref(info), ctypes.sizeof(info))\n    if not ok:\n        raise ctypes.WinError()\n    kernel32.AssignProcessToJobObject(job, hproc)\n    kernel32.CloseHandle(hproc)\n    return job  # 生存を維持 — ジョブが閉じると（GC時）プロセスが終了する\n\n# proc = subprocess.Popen(...) の後：  job = restrict_process(proc.pid)\n```\n\n### Tier 3 — Windowsサンドボックス（CI完全OS分離）\n\n実行ごとにクリーンなWindowsイメージが必要な場合（残留レジストリキーなし、共有GPUステートなし、真の分離）、[Windowsサンドボックス](https:\u002F\u002Flearn.microsoft.com\u002Fwindows\u002Fsecurity\u002Fapplication-security\u002Fapplication-isolation\u002Fwindows-sandbox\u002Fwindows-sandbox-overview)内で**テストスイート全体**を実行します。\n\n**要件：** Windows 10\u002F11 Pro またはエンタープライズ、仮想化が有効。\n\nプロジェクトルートに `e2e-sandbox.wsb` を作成：\n\n```xml\n\u003CConfiguration>\n  \u003CMappedFolders>\n    \u003C!-- アプリバイナリ（読み取り専用） -->\n    \u003CMappedFolder>\n      \u003CHostFolder>C:\\path\\to\\your\\build\\Release\u003C\u002FHostFolder>\n      \u003CSandboxFolder>C:\\app\u003C\u002FSandboxFolder>\n      \u003CReadOnly>true\u003C\u002FReadOnly>\n    \u003C\u002FMappedFolder>\n    \u003C!-- テストスイート（アーティファクト用に読み書き可能） -->\n    \u003CMappedFolder>\n      \u003CHostFolder>C:\\path\\to\\your\\e2e_test\u003C\u002FHostFolder>\n      \u003CSandboxFolder>C:\\e2e_test\u003C\u002FSandboxFolder>\n      \u003CReadOnly>false\u003C\u002FReadOnly>\n    \u003C\u002FMappedFolder>\n  \u003C\u002FMappedFolders>\n  \u003CLogonCommand>\n    \u003C!--\n      WindowsサンドボックスはデフォルトでPythonがない。まずサイレントインストール、\n      次に依存関係をインストールしてテストを実行する。アーティファクトは\n      上記のMappedFolderを通じてホストに書き戻される。\n    -->\n    \u003CCommand>powershell -Command \"\n      winget install --id Python.Python.3.11 --silent --accept-package-agreements;\n      $env:PATH += ';' + $env:LOCALAPPDATA + '\\Programs\\Python\\Python311\\Scripts';\n      cd C:\\e2e_test;\n      pip install -r requirements.txt;\n      pytest tests\\ -v\n    \"\u003C\u002FCommand>\n  \u003C\u002FLogonCommand>\n\u003C\u002FConfiguration>\n```\n\n起動：`WindowsSandbox.exe e2e-sandbox.wsb`\n\n> pywinautoとアプリは両方ともサンドボックス**内**で実行されます（同じセッションが必要）。\n> アーティファクトはマップされたフォルダーを通じてホストに書き戻されます。\n\n### 階層の比較\n\n| 階層 | 分離 | セットアップコスト | CIで動作 | 使用タイミング |\n|------|-----------|-----------|-------------|----------|\n| 1 — `tmp_path` 環境リダイレクト | ファイルシステム | ゼロ | 常に | 全テストのデフォルト |\n| 2 — ジョブオブジェクト | プロセスツリー | 低 | 常に | 子プロセスの逃走を防止 |\n| 3 — Windowsサンドボックス | 完全OS | 中 | Pro\u002FEnterpriseイメージが必要 | 定期的なクリーンルーム実行 |\n\n### テストのハングを防止する\n\n`pytest-timeout` を追加して単一テストに上限を設けます。`pytest.ini` で `timeout = 60` と `timeout_method = thread` を設定します。注意：`thread` メソッドはWindows上でQtアプリのサブプロセスを終了できません — `conftest.py` に `atexit.register(lambda: [p.kill() for p in psutil.Process().children(recursive=True)])` を追加してオーファンを刈り取ってください。\n\n## CI\u002FCDインテグレーション\n\n```yaml\n# .github\u002Fworkflows\u002Fe2e-desktop.yml\nname: Desktop E2E\non: [push, pull_request]\n\njobs:\n  e2e:\n    runs-on: windows-latest   # 実際のGUI環境、Xvfb不要\n    steps:\n      - uses: actions\u002Fcheckout@v4\n\n      - uses: actions\u002Fsetup-python@v5\n        with: { python-version: \"3.11\" }\n\n      - name: 依存関係をインストール\n        run: pip install pywinauto pytest pytest-html Pillow\n\n      - name: アプリをビルド\n        run: cmake --build build --config Release  # ビルドシステムに合わせて調整\n\n      - name: E2Eを実行\n        env:\n          APP_PATH: ${{ github.workspace }}\\build\\Release\\MyApp.exe\n          APP_TITLE: \"My Application\"\n          CI: \"true\"\n        run: pytest tests\u002F --html=artifacts\u002Freport.html --self-contained-html --junitxml=artifacts\u002Fresults.xml -v\n\n      - uses: actions\u002Fupload-artifact@v4\n        if: always()\n        with:\n          name: e2e-artifacts\n          path: artifacts\u002F\n          retention-days: 14\n```\n\n## Qt固有\n\n### Qt 5.xでのUIA有効化\n\nQt 5.xのアクセシビリティは一部のビルド（特に5.7〜5.14）でデフォルトが無効です。起動前に環境変数を設定してください。Qt 6.xはデフォルトでアクセシビリティが有効です — Qt 6ではこのステップをスキップしてください。\n\n```python\n# conftest.py — モジュールの先頭に追加\nimport os\nos.environ[\"QT_ACCESSIBILITY\"] = \"1\"\n```\n\nまたはCIでエクスポート：\n\n```yaml\nenv:\n  QT_ACCESSIBILITY: \"1\"\n```\n\n### Qtウィジェットへの安定した識別子の追加\n\n```cpp\n\u002F\u002F 優先：objectNameとaccessibleNameの両方\nvoid setTestId(QWidget* w, const char* id) {\n    w->setObjectName(id);\n    w->setAccessibleName(id);  \u002F\u002F UIA Nameプロパティになる\n}\n\n\u002F\u002F ダイアログコンストラクタ内：\nsetTestId(ui->usernameEdit, \"usernameInput\");\nsetTestId(ui->passwordEdit, \"passwordInput\");\nsetTestId(ui->loginButton,  \"btnLogin\");\nsetTestId(ui->errorLabel,   \"lblError\");\n```\n\nタイポを避けるためにすべてのIDをヘッダーに集約：\n\n```cpp\n\u002F\u002F test_ids.h\n#define TID_USERNAME   \"usernameInput\"\n#define TID_PASSWORD   \"passwordInput\"\n#define TID_BTN_LOGIN  \"btnLogin\"\n#define TID_LBL_ERROR  \"lblError\"\n```\n\n### Qt固有の注意点\n\n**QComboBox** — ドロップダウンは別のトップレベルウィンドウです：\n\n```python\nfrom pywinauto import Desktop\n\ndef select_combo_item(page, combo_spec, item_text):\n    page.click(combo_spec)\n    # ドロップダウンは新しいルートレベルウィンドウとして表示される\n    # class_nameはQtバージョンによって異なる — Accessibility Insightsで確認\n    # Qt 5.x: \"Qt5QWindowIcon\"  |  Qt 6.x: \"Qt6QWindowIcon\" — Accessibility Insightsで確認\n    popup = Desktop(backend=\"uia\").window(class_name_re=\"Qt[56]QWindowIcon\")\n    popup.wait(\"visible\", timeout=5)\n    popup.child_window(title=item_text).click_input()\n```\n\n**QMessageBox \u002F QDialog** — これも別のトップレベルウィンドウです：\n\n```python\ndlg = page.wait_window(\"Confirm\")          # ダイアログタイトルを待つ\ndlg.child_window(title=\"OK\").click_input() # 内部のボタンをクリック\n```\n\n**QTableWidget \u002F QTableView** — 行\u002Fセルアクセス：\n\n```python\ntable = page.by_id(\"tblUsers\").wrapper_object()\ncell  = table.cell(row=0, column=1)\nprint(cell.window_text())\n```\n\n**自己描画コントロール**（`paintEvent`のみ、`QGraphicsView`、`QOpenGLWidget`）— UIAは内部を見ることができません。以下のフォールバックセクションを使用してください。\n\n## フォールバック：スクリーンショットモード\n\nコントロールがUIAで到達できない場合（自己描画、サードパーティ、ゲームエンジン）：\n\n```bash\npip install pyautogui Pillow opencv-python\n```\n\n```python\nimport pyautogui, cv2, numpy as np\nfrom PIL import Image\n\ndef find_image_on_screen(template_path, confidence=0.85):\n    \"\"\"画面上のテンプレート画像を探す。(x, y) の中心またはNoneを返す。\"\"\"\n    screen   = np.array(pyautogui.screenshot())\n    template = np.array(Image.open(template_path))\n    result   = cv2.matchTemplate(\n        cv2.cvtColor(screen, cv2.COLOR_RGB2BGR),\n        cv2.cvtColor(template, cv2.COLOR_RGB2BGR),\n        cv2.TM_CCOEFF_NORMED,\n    )\n    _, max_val, _, max_loc = cv2.minMaxLoc(result)\n    if max_val >= confidence:\n        h, w = template.shape[:2]\n        return max_loc[0] + w \u002F\u002F 2, max_loc[1] + h \u002F\u002F 2\n    return None\n\ndef click_image(template_path, confidence=0.85):\n    pos = find_image_on_screen(template_path, confidence)\n    if pos is None:\n        raise RuntimeError(f\"画面上で画像が見つからない：{template_path}\")\n    pyautogui.click(*pos)\n```\n\n**控えめに使用すること** — 画像マッチングはDPI変更、テーマ切り替え、部分的な遮蔽で壊れます。\n常にUIAを最初に試し、本当に到達できないコントロールにのみスクリーンショットにフォールバックしてください。\n\n## アンチパターン\n\n```python\n# BAD: 固定スリープ\ntime.sleep(3)\npage.click(page.by_id(\"btnSubmit\"))\n\n# GOOD: 条件ウェイト\npage.wait_visible(page.by_id(\"btnSubmit\"))\npage.click(page.by_id(\"btnSubmit\"))\n```\n\n```python\n# BAD: 主要戦略として脆弱なクラス+インデックスロケーター\npage.by_class(\"Edit\", index=2).type_keys(\"hello\")\n\n# GOOD: AutomationId\npage.by_id(\"usernameInput\").set_edit_text(\"hello\")\n```\n\n```python\n# BAD: ピクセル座標でのアサート\nassert btn.rectangle().left == 120\n\n# GOOD: コンテンツ\u002F状態でのアサート\nassert page.get_text(page.by_id(\"lblStatus\")) == \"Logged in\"\nassert page.by_id(\"btnLogout\").is_enabled()\n```\n\n```python\n# BAD: 全テストにわたってアプリインスタンスを共有（状態の漏洩）\n@pytest.fixture(scope=\"session\")\ndef app(): ...\n\n# GOOD: テストごとに新しいプロセス（または最大でもクラスごと）\n@pytest.fixture(scope=\"function\")\ndef app(): ...\n```\n\n## テストの実行\n\n```bash\n# 全テスト\npytest tests\u002F -v\n\n# スモークのみ\npytest tests\u002F -m smoke -v\n\n# 特定ファイル\npytest tests\u002Ftest_login.py -v\n\n# カスタムアプリパスで実行\nAPP_PATH=\"C:\\build\\Release\\MyApp.exe\" APP_TITLE=\"MyApp\" pytest tests\u002F -v\n\n# 不安定なテストを検出（各テストを5回繰り返す）\npip install pytest-repeat\npytest tests\u002Ftest_login.py --count=5 -v\n```\n\n## 関連スキル\n\n- `e2e-testing` — WebアプリケーションのPlaywright E2Eテスト\n- `cpp-testing` — GoogleTestを使用したC++ユニット\u002F統合テスト\n- `cpp-coding-standards` — C++コードスタイルとパターン\n",{"name":5,"origin":24,"description":7},"ECC","main","57e7aa6b6e03bce1a7d7862ba9c2ec312f7f19b5","src\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Fja-JP\u002Fskills\u002Fwindows-desktop-e2e",0,"https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee","https:\u002F\u002Fwithcyril.me\u002F","Hi, I’m Julian Cyril D, a Computer Science and Business Systems student at PSNACET.\r\nI’m passionate about full-stack development, UI\u002FUX design, and building sma","2026-11-04 23:28:50",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add Cyrilthetecchieee\u002Fcyril-code- --skill windows-desktop-e2e",{"tool":40,"command":41},"bunx","bunx skills add Cyrilthetecchieee\u002Fcyril-code- --skill windows-desktop-e2e",{"tool":43,"command":44},"pnpm","pnpm dlx skills add Cyrilthetecchieee\u002Fcyril-code- --skill windows-desktop-e2e","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Fja-JP\u002Fskills\u002Fwindows-desktop-e2e\u002FSKILL.md",true,[],[49,58,65,73,80,87],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":53,"licenseFileUrl":54,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":19},"01M7AQV6CYX8RMC78420V9WZ62","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fwebapp-testing\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M7AQV2895N3S1MEX6K76G6G2","youtube-downloader","Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fvideo-downloader\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":53,"licenseFileUrl":69,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M7AQTRNX62DNKVZ5GXEHRBKB","theme-factory","Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors\u002Ffonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftheme-factory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftheme-factory\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7AQTNNVHAAN9H6DA8T6ZVE0","template-skill","Replace with description of the skill and when Claude should use it.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftemplate-skill\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7AQTJ3MQ6AKX152MEX2MYCC","tailored-resume-generator","Analyzes job descriptions and generates tailored resumes that highlight relevant experience, skills, and achievements to maximize interview chances","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftailored-resume-generator\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":53,"licenseFileUrl":91,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M7AQTD7D5MYET2YWG7HG9WM3","slack-gif-creator","Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives. This skill applies when users request animated GIFs or emoji animations for Slack from descriptions like \"make me a GIF for Slack of X doing Y\".","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fslack-gif-creator\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fslack-gif-creator\u002FSKILL.md",[],[]]