[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AKJNNPTE35EW5KTFPVGPDZ":3,"skill-same:01M7AKJNNPTE35EW5KTFPVGPDZ":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},"01M7AKJNNPTE35EW5KTFPVGPDZ","ui-demo",null,"Playwrightを使用して美しいUIデモ動画を録画する。ユーザーがWebアプリのデモ、ウォークスルー、スクリーン録画、またはチュートリアル動画の作成を求める場合に使用する。可視カーソル、自然なリズム、プロフェッショナルな仕上がりのWebM動画を生成する。","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\u002Fui-demo\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: ui-demo\ndescription: Playwrightを使用して美しいUIデモ動画を録画する。ユーザーがWebアプリのデモ、ウォークスルー、スクリーン録画、またはチュートリアル動画の作成を求める場合に使用する。可視カーソル、自然なリズム、プロフェッショナルな仕上がりのWebM動画を生成する。\norigin: ECC\n---\n\n# UI デモ動画レコーダー\n\nPlaywrightの動画録画機能を使用して、注入されたカーソルオーバーレイ、自然なリズム、ナラティブフローを備えた美しいWebアプリのデモ動画を録画する。\n\n## 使用場面\n\n* ユーザーが「デモ動画」「スクリーン録画」「操作デモ」または「チュートリアル」を求める場合\n* ユーザーが機能またはワークフローを視覚的に見せたい場合\n* ユーザーがドキュメント、オンボーディング、ステークホルダーへのデモのために動画が必要な場合\n\n## 3フェーズのプロセス\n\nすべてのデモは **探索 -> リハーサル -> 録画** の3つのフェーズを経る。録画フェーズに直接ジャンプしない。\n\n***\n\n## フェーズ 1：探索\n\nスクリプトを書く前に、ターゲットページを探索して実際の内容を把握する。\n\n### なぜか\n\n見たことのない内容のスクリプトは書けない。フィールドが `\u003Ctextarea>` ではなく `\u003Cinput>` の場合、ドロップダウンが `\u003Cselect>` ではなくカスタムコンポーネントの場合、コメントボックスが `@mentions` や `#tags` をサポートしている場合があある。仮定は録画を静かに壊す。\n\n### 方法\n\nフローの各ページに移動し、インタラクティブな要素をダンプする：\n\n```javascript\n\u002F\u002F Run this for each page in the flow BEFORE writing the demo script\nconst fields = await page.evaluate(() => {\n  const els = [];\n  document.querySelectorAll('input, select, textarea, button, [contenteditable]').forEach(el => {\n    if (el.offsetParent !== null) {\n      els.push({\n        tag: el.tagName,\n        type: el.type || '',\n        name: el.name || '',\n        placeholder: el.placeholder || '',\n        text: el.textContent?.trim().substring(0, 40) || '',\n        contentEditable: el.contentEditable === 'true',\n        role: el.getAttribute('role') || '',\n      });\n    }\n  });\n  return els;\n});\nconsole.log(JSON.stringify(fields, null, 2));\n```\n\n### 確認すべき内容\n\n* **フォームフィールド**：`\u003Cselect>`、`\u003Cinput>`、カスタムドロップダウン、コンボボックスのどれか？\n* **選択オプション**：オプションの値とテキストをダンプする。プレースホルダーには `value=\"0\"` または `value=\"\"` が含まれることがあり、非空に見える。`Array.from(el.options).map(o => ({ value: o.value, text: o.text }))` を使用する。テキストに「選択」が含まれるオプションや値が `\"0\"` のオプションをスキップする。\n* **リッチテキスト**：コメントボックスは `@mentions`、`#tags`、Markdown、絵文字をサポートしているか？プレースホルダーテキストを確認する。\n* **必須フィールド**：どのフィールドがフォームの送信をブロックするか？ラベルの `required`、`*` を確認し、空のフォームを送信してバリデーションエラーを確認する。\n* **動的コンテンツ**：他のフィールドを入力した後にフィールドが表示されるか？\n* **ボタンラベル**：正確なテキスト（`\"Submit\"`、`\"Submit Request\"`、`\"Send\"` など）。\n* **テーブル列ヘッダー**：テーブル駆動のモーダルには、各 `input[type=\"number\"]` をその列ヘッダーにマッピングする。すべての数値入力が同じ意味を持つと仮定しない。\n\n### 出力\n\nスクリプトに正しいセレクターを書くために使用する、ページごとのフィールドマッピング。例：\n\n```text\n\u002Fpurchase-requests\u002Fnew:\n  - 予算コード: \u003Cselect>（ページの最初のドロップダウン、4オプション）\n  - 希望納期: \u003Cinput type=\"date\">\n  - 背景説明: \u003Ctextarea>（inputではない）\n  - BOMテーブル: インライン編集可能なセル、span.cursor-pointer -> inputパターン\n  - 送信: \u003Cbutton> テキスト=\"送信\"\n\n\u002Fpurchase-requests\u002FN（詳細）:\n  - コメント: \u003Cinput placeholder=\"メッセージを入力...\">、@ユーザーと#PRタグに対応\n  - 送信: \u003Cbutton> テキスト=\"送信\"（入力前は無効）\n```\n\n***\n\n## フェーズ 2：リハーサル\n\n録画せずにすべてのステップを実行する。各セレクターが解決されることを確認する。\n\n### なぜか\n\nセレクターの失敗は、デモ録画が壊れる最大の原因。リハーサルは録画を無駄にする前に問題を発見する。\n\n### 方法\n\n`ensureVisible` を使用する——ログを記録して大きくエラーを報告するラッパー：\n\n```javascript\nasync function ensureVisible(page, locator, label) {\n  const el = typeof locator === 'string' ? page.locator(locator).first() : locator;\n  const visible = await el.isVisible().catch(() => false);\n  if (!visible) {\n    const msg = `REHEARSAL FAIL: \"${label}\" not found - selector: ${typeof locator === 'string' ? locator : '(locator object)'}`;\n    console.error(msg);\n    const found = await page.evaluate(() => {\n      return Array.from(document.querySelectorAll('button, input, select, textarea, a'))\n        .filter(el => el.offsetParent !== null)\n        .map(el => `${el.tagName}[${el.type || ''}] \"${el.textContent?.trim().substring(0, 30)}\"`)\n        .join('\\n  ');\n    });\n    console.error('  Visible elements:\\n  ' + found);\n    return false;\n  }\n  console.log(`REHEARSAL OK: \"${label}\"`);\n  return true;\n}\n```\n\n### リハーサルスクリプトの構造\n\n```javascript\nconst steps = [\n  { label: 'Login email field', selector: '#email' },\n  { label: 'Login submit', selector: 'button[type=\"submit\"]' },\n  { label: 'New Request button', selector: 'button:has-text(\"New Request\")' },\n  { label: 'Budget Code select', selector: 'select' },\n  { label: 'Delivery date', selector: 'input[type=\"date\"]:visible' },\n  { label: 'Description field', selector: 'textarea:visible' },\n  { label: 'Add Item button', selector: 'button:has-text(\"Add Item\")' },\n  { label: 'Submit button', selector: 'button:has-text(\"Submit\")' },\n];\n\nlet allOk = true;\nfor (const step of steps) {\n  if (!await ensureVisible(page, step.selector, step.label)) {\n    allOk = false;\n  }\n}\nif (!allOk) {\n  console.error('REHEARSAL FAILED - fix selectors before recording');\n  process.exit(1);\n}\nconsole.log('REHEARSAL PASSED - all selectors verified');\n```\n\n### リハーサルが失敗した場合\n\n1. 可視要素のダンプを読む。\n2. 正しいセレクターを見つける。\n3. スクリプトを更新する。\n4. リハーサルを再実行する。\n5. すべてのセレクターが通過した後のみ続行する。\n\n***\n\n## フェーズ 3：録画\n\n探索とリハーサルが通過した後にのみ、録画を作成する。\n\n### 録画の原則\n\n#### 1. ナラティブフロー\n\n動画をストーリーとして計画する。ユーザーが指定した順序に従うか、このデフォルト順序を使用する：\n\n* **エントリー**：ログインまたは開始点へのナビゲーション\n* **コンテキスト**：周囲を確認して、視聴者がどこにいるか理解できるようにする\n* **アクション**：主要なワークフローステップを実行する\n* **バリアント**：設定、テーマ、ローカライゼーションなどの補助機能を表示する\n* **結果**：結果、確認、または新しい状態を表示する\n\n#### 2. リズム\n\n* ログイン後：`4秒`\n* ナビゲーション後：`3秒`\n* ボタンクリック後：`2秒`\n* 主要なステップ間：`1.5〜2秒`\n* 最終アクション後：`3秒`\n* 入力の遅延：文字ごとに `25〜40ms`\n\n#### 3. カーソルオーバーレイ\n\nマウスの動きを追うSVGの矢印カーソルを注入する：\n\n```javascript\nasync function injectCursor(page) {\n  await page.evaluate(() => {\n    if (document.getElementById('demo-cursor')) return;\n    const cursor = document.createElement('div');\n    cursor.id = 'demo-cursor';\n    cursor.innerHTML = `\u003Csvg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\">\n      \u003Cpath d=\"M5 3L19 12L12 13L9 20L5 3Z\" fill=\"white\" stroke=\"black\" stroke-width=\"1.5\" stroke-linejoin=\"round\"\u002F>\n    \u003C\u002Fsvg>`;\n    cursor.style.cssText = `\n      position: fixed; z-index: 999999; pointer-events: none;\n      width: 24px; height: 24px;\n      transition: left 0.1s, top 0.1s;\n      filter: drop-shadow(1px 1px 2px rgba(0,0,0,0.3));\n    `;\n    cursor.style.left = '0px';\n    cursor.style.top = '0px';\n    document.body.appendChild(cursor);\n    document.addEventListener('mousemove', (e) => {\n      cursor.style.left = e.clientX + 'px';\n      cursor.style.top = e.clientY + 'px';\n    });\n  });\n}\n```\n\nオーバーレイはナビゲーション時に破棄されるため、ページナビゲーションのたびに `injectCursor(page)` を呼び出す。\n\n#### 4. マウスの動き\n\nカーソルを瞬間移動させない。クリック前にターゲットに移動する：\n\n```javascript\nasync function moveAndClick(page, locator, label, opts = {}) {\n  const { postClickDelay = 800, ...clickOpts } = opts;\n  const el = typeof locator === 'string' ? page.locator(locator).first() : locator;\n  const visible = await el.isVisible().catch(() => false);\n  if (!visible) {\n    console.error(`WARNING: moveAndClick skipped - \"${label}\" not visible`);\n    return false;\n  }\n  try {\n    await el.scrollIntoViewIfNeeded();\n    await page.waitForTimeout(300);\n    const box = await el.boundingBox();\n    if (box) {\n      await page.mouse.move(box.x + box.width \u002F 2, box.y + box.height \u002F 2, { steps: 10 });\n      await page.waitForTimeout(400);\n    }\n    await el.click(clickOpts);\n  } catch (e) {\n    console.error(`WARNING: moveAndClick failed on \"${label}\": ${e.message}`);\n    return false;\n  }\n  await page.waitForTimeout(postClickDelay);\n  return true;\n}\n```\n\nデバッグのために各呼び出しに説明的な `label` を含める。\n\n#### 5. 入力\n\n瞬時に入力するのではなく、目に見えるように入力する：\n\n```javascript\nasync function typeSlowly(page, locator, text, label, charDelay = 35) {\n  const el = typeof locator === 'string' ? page.locator(locator).first() : locator;\n  const visible = await el.isVisible().catch(() => false);\n  if (!visible) {\n    console.error(`WARNING: typeSlowly skipped - \"${label}\" not visible`);\n    return false;\n  }\n  await moveAndClick(page, el, label);\n  await el.fill('');\n  await el.pressSequentially(text, { delay: charDelay });\n  await page.waitForTimeout(500);\n  return true;\n}\n```\n\n#### 6. スクロール\n\nジャンプではなくスムーズスクロールを使用する：\n\n```javascript\nawait page.evaluate(() => window.scrollTo({ top: 400, behavior: 'smooth' }));\nawait page.waitForTimeout(1500);\n```\n\n#### 7. ダッシュボードパン\n\nダッシュボードや概要ページを表示する場合、主要な要素の上にカーソルを移動させる：\n\n```javascript\nasync function panElements(page, selector, maxCount = 6) {\n  const elements = await page.locator(selector).all();\n  for (let i = 0; i \u003C Math.min(elements.length, maxCount); i++) {\n    try {\n      const box = await elements[i].boundingBox();\n      if (box && box.y \u003C 700) {\n        await page.mouse.move(box.x + box.width \u002F 2, box.y + box.height \u002F 2, { steps: 8 });\n        await page.waitForTimeout(600);\n      }\n    } catch (e) {\n      console.warn(`WARNING: panElements skipped element ${i} (selector: \"${selector}\"): ${e.message}`);\n    }\n  }\n}\n```\n\n#### 8. 字幕\n\nビューポートの下部に字幕バーを注入する：\n\n```javascript\nasync function injectSubtitleBar(page) {\n  await page.evaluate(() => {\n    if (document.getElementById('demo-subtitle')) return;\n    const bar = document.createElement('div');\n    bar.id = 'demo-subtitle';\n    bar.style.cssText = `\n      position: fixed; bottom: 0; left: 0; right: 0; z-index: 999998;\n      text-align: center; padding: 12px 24px;\n      background: rgba(0, 0, 0, 0.75);\n      color: white; font-family: -apple-system, \"Segoe UI\", sans-serif;\n      font-size: 16px; font-weight: 500; letter-spacing: 0.3px;\n      transition: opacity 0.3s;\n      pointer-events: none;\n    `;\n    bar.textContent = '';\n    bar.style.opacity = '0';\n    document.body.appendChild(bar);\n  });\n}\n\nasync function showSubtitle(page, text) {\n  await page.evaluate((t) => {\n    const bar = document.getElementById('demo-subtitle');\n    if (!bar) return;\n    if (t) {\n      bar.textContent = t;\n      bar.style.opacity = '1';\n    } else {\n      bar.style.opacity = '0';\n    }\n  }, text);\n  if (text) await page.waitForTimeout(800);\n}\n```\n\nナビゲーションのたびに `injectSubtitleBar(page)` を `injectCursor(page)` と一緒に呼び出す。\n\n使用パターン：\n\n```javascript\nawait showSubtitle(page, 'Step 1 - Logging in');\nawait showSubtitle(page, 'Step 2 - Dashboard overview');\nawait showSubtitle(page, '');\n```\n\nガイドライン：\n\n* 字幕テキストは短く、60文字以内が望ましい。\n* 一貫性のために `Step N - Action` 形式を使用する。\n* 長い一時停止でインターフェースが自己説明的な場合は字幕をクリアする。\n\n## スクリプトテンプレート\n\n```javascript\n'use strict';\nconst { chromium } = require('playwright');\nconst path = require('path');\nconst fs = require('fs');\n\nconst BASE_URL = process.env.QA_BASE_URL || 'http:\u002F\u002Flocalhost:3000';\nconst VIDEO_DIR = path.join(__dirname, 'screenshots');\nconst OUTPUT_NAME = 'demo-FEATURE.webm';\nconst REHEARSAL = process.argv.includes('--rehearse');\n\n\u002F\u002F Paste injectCursor, injectSubtitleBar, showSubtitle, moveAndClick,\n\u002F\u002F typeSlowly, ensureVisible, and panElements here.\n\n(async () => {\n  const browser = await chromium.launch({ headless: true });\n\n  if (REHEARSAL) {\n    const context = await browser.newContext({ viewport: { width: 1280, height: 720 } });\n    const page = await context.newPage();\n    \u002F\u002F Navigate through the flow and run ensureVisible for each selector.\n    await browser.close();\n    return;\n  }\n\n  const context = await browser.newContext({\n    recordVideo: { dir: VIDEO_DIR, size: { width: 1280, height: 720 } },\n    viewport: { width: 1280, height: 720 }\n  });\n  const page = await context.newPage();\n\n  try {\n    await injectCursor(page);\n    await injectSubtitleBar(page);\n\n    await showSubtitle(page, 'Step 1 - Logging in');\n    \u002F\u002F login actions\n\n    await page.goto(`${BASE_URL}\u002Fdashboard`);\n    await injectCursor(page);\n    await injectSubtitleBar(page);\n    await showSubtitle(page, 'Step 2 - Dashboard overview');\n    \u002F\u002F pan dashboard\n\n    await showSubtitle(page, 'Step 3 - Main workflow');\n    \u002F\u002F action sequence\n\n    await showSubtitle(page, 'Step 4 - Result');\n    \u002F\u002F final reveal\n    await showSubtitle(page, '');\n  } catch (err) {\n    console.error('DEMO ERROR:', err.message);\n  } finally {\n    await context.close();\n    const video = page.video();\n    if (video) {\n      const src = await video.path();\n      const dest = path.join(VIDEO_DIR, OUTPUT_NAME);\n      try {\n        fs.copyFileSync(src, dest);\n        console.log('Video saved:', dest);\n      } catch (e) {\n        console.error('ERROR: Failed to copy video:', e.message);\n        console.error('  Source:', src);\n        console.error('  Destination:', dest);\n      }\n    }\n    await browser.close();\n  }\n})();\n```\n\n使用方法：\n\n```bash\n# Phase 2: Rehearse\nnode demo-script.cjs --rehearse\n\n# Phase 3: Record\nnode demo-script.cjs\n```\n\n## 録画前チェックリスト\n\n* \\[ ] 探索フェーズが完了\n* \\[ ] リハーサルが通過し、すべてのセレクターが機能する\n* \\[ ] ヘッドレスモードが有効\n* \\[ ] 解像度が `1280x720` に設定されている\n* \\[ ] 各ナビゲーション後にカーソルと字幕のオーバーレイを再注入する\n* \\[ ] 主要なトランジション時に `showSubtitle(page, 'Step N - ...')` を使用する\n* \\[ ] すべてのクリックが説明的なラベル付きの `moveAndClick` を使用する\n* \\[ ] 目に見える入力が `typeSlowly` を使用する\n* \\[ ] サイレントキャッチなし。ヘルパー関数は警告を記録する\n* \\[ ] コンテンツ表示にスムーズスクロールを使用する\n* \\[ ] 重要な一時停止が視聴者に対して見える\n* \\[ ] フローが要求されたストーリー順序に従っている\n* \\[ ] スクリプトがフェーズ1で発見した実際のUIを反映している\n\n## よくある落とし穴\n\n1. ナビゲーション後にカーソルが消える——再注入する。\n2. 動画が速すぎる——一時停止を追加する。\n3. カーソルが矢印ではなく点になっている——SVGオーバーレイを使用する。\n4. カーソルが瞬間移動する——クリック前に移動する。\n5. ドロップダウン選択が途切れる——移動を表示してからオプションを選択する。\n6. モーダルが唐突に見える——確認前に読み取り一時停止を追加する。\n7. 動画ファイルパスがランダム——安定した出力名にコピーする。\n8. セレクターの失敗が飲み込まれる——サイレントキャッチブロックを絶対に使わない。\n9. フィールドタイプを仮定する——まず探索する。\n10. 機能を仮定する——スクリプトを書く前に実際のUIを確認する。\n11. プレースホルダーの選択値が本物に見える——`\"0\"` と `\"Select...\"` に注意する。\n12. ポップアップが別の動画を作成する——ポップアップページを明示的にキャプチャし、必要に応じて後でマージする。\n","# UI デモ動画レコーダー\n\nPlaywrightの動画録画機能を使用して、注入されたカーソルオーバーレイ、自然なリズム、ナラティブフローを備えた美しいWebアプリのデモ動画を録画する。\n\n## 使用場面\n\n* ユーザーが「デモ動画」「スクリーン録画」「操作デモ」または「チュートリアル」を求める場合\n* ユーザーが機能またはワークフローを視覚的に見せたい場合\n* ユーザーがドキュメント、オンボーディング、ステークホルダーへのデモのために動画が必要な場合\n\n## 3フェーズのプロセス\n\nすべてのデモは **探索 -> リハーサル -> 録画** の3つのフェーズを経る。録画フェーズに直接ジャンプしない。\n\n***\n\n## フェーズ 1：探索\n\nスクリプトを書く前に、ターゲットページを探索して実際の内容を把握する。\n\n### なぜか\n\n見たことのない内容のスクリプトは書けない。フィールドが `\u003Ctextarea>` ではなく `\u003Cinput>` の場合、ドロップダウンが `\u003Cselect>` ではなくカスタムコンポーネントの場合、コメントボックスが `@mentions` や `#tags` をサポートしている場合があある。仮定は録画を静かに壊す。\n\n### 方法\n\nフローの各ページに移動し、インタラクティブな要素をダンプする：\n\n```javascript\n\u002F\u002F Run this for each page in the flow BEFORE writing the demo script\nconst fields = await page.evaluate(() => {\n  const els = [];\n  document.querySelectorAll('input, select, textarea, button, [contenteditable]').forEach(el => {\n    if (el.offsetParent !== null) {\n      els.push({\n        tag: el.tagName,\n        type: el.type || '',\n        name: el.name || '',\n        placeholder: el.placeholder || '',\n        text: el.textContent?.trim().substring(0, 40) || '',\n        contentEditable: el.contentEditable === 'true',\n        role: el.getAttribute('role') || '',\n      });\n    }\n  });\n  return els;\n});\nconsole.log(JSON.stringify(fields, null, 2));\n```\n\n### 確認すべき内容\n\n* **フォームフィールド**：`\u003Cselect>`、`\u003Cinput>`、カスタムドロップダウン、コンボボックスのどれか？\n* **選択オプション**：オプションの値とテキストをダンプする。プレースホルダーには `value=\"0\"` または `value=\"\"` が含まれることがあり、非空に見える。`Array.from(el.options).map(o => ({ value: o.value, text: o.text }))` を使用する。テキストに「選択」が含まれるオプションや値が `\"0\"` のオプションをスキップする。\n* **リッチテキスト**：コメントボックスは `@mentions`、`#tags`、Markdown、絵文字をサポートしているか？プレースホルダーテキストを確認する。\n* **必須フィールド**：どのフィールドがフォームの送信をブロックするか？ラベルの `required`、`*` を確認し、空のフォームを送信してバリデーションエラーを確認する。\n* **動的コンテンツ**：他のフィールドを入力した後にフィールドが表示されるか？\n* **ボタンラベル**：正確なテキスト（`\"Submit\"`、`\"Submit Request\"`、`\"Send\"` など）。\n* **テーブル列ヘッダー**：テーブル駆動のモーダルには、各 `input[type=\"number\"]` をその列ヘッダーにマッピングする。すべての数値入力が同じ意味を持つと仮定しない。\n\n### 出力\n\nスクリプトに正しいセレクターを書くために使用する、ページごとのフィールドマッピング。例：\n\n```text\n\u002Fpurchase-requests\u002Fnew:\n  - 予算コード: \u003Cselect>（ページの最初のドロップダウン、4オプション）\n  - 希望納期: \u003Cinput type=\"date\">\n  - 背景説明: \u003Ctextarea>（inputではない）\n  - BOMテーブル: インライン編集可能なセル、span.cursor-pointer -> inputパターン\n  - 送信: \u003Cbutton> テキスト=\"送信\"\n\n\u002Fpurchase-requests\u002FN（詳細）:\n  - コメント: \u003Cinput placeholder=\"メッセージを入力...\">、@ユーザーと#PRタグに対応\n  - 送信: \u003Cbutton> テキスト=\"送信\"（入力前は無効）\n```\n\n***\n\n## フェーズ 2：リハーサル\n\n録画せずにすべてのステップを実行する。各セレクターが解決されることを確認する。\n\n### なぜか\n\nセレクターの失敗は、デモ録画が壊れる最大の原因。リハーサルは録画を無駄にする前に問題を発見する。\n\n### 方法\n\n`ensureVisible` を使用する——ログを記録して大きくエラーを報告するラッパー：\n\n```javascript\nasync function ensureVisible(page, locator, label) {\n  const el = typeof locator === 'string' ? page.locator(locator).first() : locator;\n  const visible = await el.isVisible().catch(() => false);\n  if (!visible) {\n    const msg = `REHEARSAL FAIL: \"${label}\" not found - selector: ${typeof locator === 'string' ? locator : '(locator object)'}`;\n    console.error(msg);\n    const found = await page.evaluate(() => {\n      return Array.from(document.querySelectorAll('button, input, select, textarea, a'))\n        .filter(el => el.offsetParent !== null)\n        .map(el => `${el.tagName}[${el.type || ''}] \"${el.textContent?.trim().substring(0, 30)}\"`)\n        .join('\\n  ');\n    });\n    console.error('  Visible elements:\\n  ' + found);\n    return false;\n  }\n  console.log(`REHEARSAL OK: \"${label}\"`);\n  return true;\n}\n```\n\n### リハーサルスクリプトの構造\n\n```javascript\nconst steps = [\n  { label: 'Login email field', selector: '#email' },\n  { label: 'Login submit', selector: 'button[type=\"submit\"]' },\n  { label: 'New Request button', selector: 'button:has-text(\"New Request\")' },\n  { label: 'Budget Code select', selector: 'select' },\n  { label: 'Delivery date', selector: 'input[type=\"date\"]:visible' },\n  { label: 'Description field', selector: 'textarea:visible' },\n  { label: 'Add Item button', selector: 'button:has-text(\"Add Item\")' },\n  { label: 'Submit button', selector: 'button:has-text(\"Submit\")' },\n];\n\nlet allOk = true;\nfor (const step of steps) {\n  if (!await ensureVisible(page, step.selector, step.label)) {\n    allOk = false;\n  }\n}\nif (!allOk) {\n  console.error('REHEARSAL FAILED - fix selectors before recording');\n  process.exit(1);\n}\nconsole.log('REHEARSAL PASSED - all selectors verified');\n```\n\n### リハーサルが失敗した場合\n\n1. 可視要素のダンプを読む。\n2. 正しいセレクターを見つける。\n3. スクリプトを更新する。\n4. リハーサルを再実行する。\n5. すべてのセレクターが通過した後のみ続行する。\n\n***\n\n## フェーズ 3：録画\n\n探索とリハーサルが通過した後にのみ、録画を作成する。\n\n### 録画の原則\n\n#### 1. ナラティブフロー\n\n動画をストーリーとして計画する。ユーザーが指定した順序に従うか、このデフォルト順序を使用する：\n\n* **エントリー**：ログインまたは開始点へのナビゲーション\n* **コンテキスト**：周囲を確認して、視聴者がどこにいるか理解できるようにする\n* **アクション**：主要なワークフローステップを実行する\n* **バリアント**：設定、テーマ、ローカライゼーションなどの補助機能を表示する\n* **結果**：結果、確認、または新しい状態を表示する\n\n#### 2. リズム\n\n* ログイン後：`4秒`\n* ナビゲーション後：`3秒`\n* ボタンクリック後：`2秒`\n* 主要なステップ間：`1.5〜2秒`\n* 最終アクション後：`3秒`\n* 入力の遅延：文字ごとに `25〜40ms`\n\n#### 3. カーソルオーバーレイ\n\nマウスの動きを追うSVGの矢印カーソルを注入する：\n\n```javascript\nasync function injectCursor(page) {\n  await page.evaluate(() => {\n    if (document.getElementById('demo-cursor')) return;\n    const cursor = document.createElement('div');\n    cursor.id = 'demo-cursor';\n    cursor.innerHTML = `\u003Csvg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\">\n      \u003Cpath d=\"M5 3L19 12L12 13L9 20L5 3Z\" fill=\"white\" stroke=\"black\" stroke-width=\"1.5\" stroke-linejoin=\"round\"\u002F>\n    \u003C\u002Fsvg>`;\n    cursor.style.cssText = `\n      position: fixed; z-index: 999999; pointer-events: none;\n      width: 24px; height: 24px;\n      transition: left 0.1s, top 0.1s;\n      filter: drop-shadow(1px 1px 2px rgba(0,0,0,0.3));\n    `;\n    cursor.style.left = '0px';\n    cursor.style.top = '0px';\n    document.body.appendChild(cursor);\n    document.addEventListener('mousemove', (e) => {\n      cursor.style.left = e.clientX + 'px';\n      cursor.style.top = e.clientY + 'px';\n    });\n  });\n}\n```\n\nオーバーレイはナビゲーション時に破棄されるため、ページナビゲーションのたびに `injectCursor(page)` を呼び出す。\n\n#### 4. マウスの動き\n\nカーソルを瞬間移動させない。クリック前にターゲットに移動する：\n\n```javascript\nasync function moveAndClick(page, locator, label, opts = {}) {\n  const { postClickDelay = 800, ...clickOpts } = opts;\n  const el = typeof locator === 'string' ? page.locator(locator).first() : locator;\n  const visible = await el.isVisible().catch(() => false);\n  if (!visible) {\n    console.error(`WARNING: moveAndClick skipped - \"${label}\" not visible`);\n    return false;\n  }\n  try {\n    await el.scrollIntoViewIfNeeded();\n    await page.waitForTimeout(300);\n    const box = await el.boundingBox();\n    if (box) {\n      await page.mouse.move(box.x + box.width \u002F 2, box.y + box.height \u002F 2, { steps: 10 });\n      await page.waitForTimeout(400);\n    }\n    await el.click(clickOpts);\n  } catch (e) {\n    console.error(`WARNING: moveAndClick failed on \"${label}\": ${e.message}`);\n    return false;\n  }\n  await page.waitForTimeout(postClickDelay);\n  return true;\n}\n```\n\nデバッグのために各呼び出しに説明的な `label` を含める。\n\n#### 5. 入力\n\n瞬時に入力するのではなく、目に見えるように入力する：\n\n```javascript\nasync function typeSlowly(page, locator, text, label, charDelay = 35) {\n  const el = typeof locator === 'string' ? page.locator(locator).first() : locator;\n  const visible = await el.isVisible().catch(() => false);\n  if (!visible) {\n    console.error(`WARNING: typeSlowly skipped - \"${label}\" not visible`);\n    return false;\n  }\n  await moveAndClick(page, el, label);\n  await el.fill('');\n  await el.pressSequentially(text, { delay: charDelay });\n  await page.waitForTimeout(500);\n  return true;\n}\n```\n\n#### 6. スクロール\n\nジャンプではなくスムーズスクロールを使用する：\n\n```javascript\nawait page.evaluate(() => window.scrollTo({ top: 400, behavior: 'smooth' }));\nawait page.waitForTimeout(1500);\n```\n\n#### 7. ダッシュボードパン\n\nダッシュボードや概要ページを表示する場合、主要な要素の上にカーソルを移動させる：\n\n```javascript\nasync function panElements(page, selector, maxCount = 6) {\n  const elements = await page.locator(selector).all();\n  for (let i = 0; i \u003C Math.min(elements.length, maxCount); i++) {\n    try {\n      const box = await elements[i].boundingBox();\n      if (box && box.y \u003C 700) {\n        await page.mouse.move(box.x + box.width \u002F 2, box.y + box.height \u002F 2, { steps: 8 });\n        await page.waitForTimeout(600);\n      }\n    } catch (e) {\n      console.warn(`WARNING: panElements skipped element ${i} (selector: \"${selector}\"): ${e.message}`);\n    }\n  }\n}\n```\n\n#### 8. 字幕\n\nビューポートの下部に字幕バーを注入する：\n\n```javascript\nasync function injectSubtitleBar(page) {\n  await page.evaluate(() => {\n    if (document.getElementById('demo-subtitle')) return;\n    const bar = document.createElement('div');\n    bar.id = 'demo-subtitle';\n    bar.style.cssText = `\n      position: fixed; bottom: 0; left: 0; right: 0; z-index: 999998;\n      text-align: center; padding: 12px 24px;\n      background: rgba(0, 0, 0, 0.75);\n      color: white; font-family: -apple-system, \"Segoe UI\", sans-serif;\n      font-size: 16px; font-weight: 500; letter-spacing: 0.3px;\n      transition: opacity 0.3s;\n      pointer-events: none;\n    `;\n    bar.textContent = '';\n    bar.style.opacity = '0';\n    document.body.appendChild(bar);\n  });\n}\n\nasync function showSubtitle(page, text) {\n  await page.evaluate((t) => {\n    const bar = document.getElementById('demo-subtitle');\n    if (!bar) return;\n    if (t) {\n      bar.textContent = t;\n      bar.style.opacity = '1';\n    } else {\n      bar.style.opacity = '0';\n    }\n  }, text);\n  if (text) await page.waitForTimeout(800);\n}\n```\n\nナビゲーションのたびに `injectSubtitleBar(page)` を `injectCursor(page)` と一緒に呼び出す。\n\n使用パターン：\n\n```javascript\nawait showSubtitle(page, 'Step 1 - Logging in');\nawait showSubtitle(page, 'Step 2 - Dashboard overview');\nawait showSubtitle(page, '');\n```\n\nガイドライン：\n\n* 字幕テキストは短く、60文字以内が望ましい。\n* 一貫性のために `Step N - Action` 形式を使用する。\n* 長い一時停止でインターフェースが自己説明的な場合は字幕をクリアする。\n\n## スクリプトテンプレート\n\n```javascript\n'use strict';\nconst { chromium } = require('playwright');\nconst path = require('path');\nconst fs = require('fs');\n\nconst BASE_URL = process.env.QA_BASE_URL || 'http:\u002F\u002Flocalhost:3000';\nconst VIDEO_DIR = path.join(__dirname, 'screenshots');\nconst OUTPUT_NAME = 'demo-FEATURE.webm';\nconst REHEARSAL = process.argv.includes('--rehearse');\n\n\u002F\u002F Paste injectCursor, injectSubtitleBar, showSubtitle, moveAndClick,\n\u002F\u002F typeSlowly, ensureVisible, and panElements here.\n\n(async () => {\n  const browser = await chromium.launch({ headless: true });\n\n  if (REHEARSAL) {\n    const context = await browser.newContext({ viewport: { width: 1280, height: 720 } });\n    const page = await context.newPage();\n    \u002F\u002F Navigate through the flow and run ensureVisible for each selector.\n    await browser.close();\n    return;\n  }\n\n  const context = await browser.newContext({\n    recordVideo: { dir: VIDEO_DIR, size: { width: 1280, height: 720 } },\n    viewport: { width: 1280, height: 720 }\n  });\n  const page = await context.newPage();\n\n  try {\n    await injectCursor(page);\n    await injectSubtitleBar(page);\n\n    await showSubtitle(page, 'Step 1 - Logging in');\n    \u002F\u002F login actions\n\n    await page.goto(`${BASE_URL}\u002Fdashboard`);\n    await injectCursor(page);\n    await injectSubtitleBar(page);\n    await showSubtitle(page, 'Step 2 - Dashboard overview');\n    \u002F\u002F pan dashboard\n\n    await showSubtitle(page, 'Step 3 - Main workflow');\n    \u002F\u002F action sequence\n\n    await showSubtitle(page, 'Step 4 - Result');\n    \u002F\u002F final reveal\n    await showSubtitle(page, '');\n  } catch (err) {\n    console.error('DEMO ERROR:', err.message);\n  } finally {\n    await context.close();\n    const video = page.video();\n    if (video) {\n      const src = await video.path();\n      const dest = path.join(VIDEO_DIR, OUTPUT_NAME);\n      try {\n        fs.copyFileSync(src, dest);\n        console.log('Video saved:', dest);\n      } catch (e) {\n        console.error('ERROR: Failed to copy video:', e.message);\n        console.error('  Source:', src);\n        console.error('  Destination:', dest);\n      }\n    }\n    await browser.close();\n  }\n})();\n```\n\n使用方法：\n\n```bash\n# Phase 2: Rehearse\nnode demo-script.cjs --rehearse\n\n# Phase 3: Record\nnode demo-script.cjs\n```\n\n## 録画前チェックリスト\n\n* \\[ ] 探索フェーズが完了\n* \\[ ] リハーサルが通過し、すべてのセレクターが機能する\n* \\[ ] ヘッドレスモードが有効\n* \\[ ] 解像度が `1280x720` に設定されている\n* \\[ ] 各ナビゲーション後にカーソルと字幕のオーバーレイを再注入する\n* \\[ ] 主要なトランジション時に `showSubtitle(page, 'Step N - ...')` を使用する\n* \\[ ] すべてのクリックが説明的なラベル付きの `moveAndClick` を使用する\n* \\[ ] 目に見える入力が `typeSlowly` を使用する\n* \\[ ] サイレントキャッチなし。ヘルパー関数は警告を記録する\n* \\[ ] コンテンツ表示にスムーズスクロールを使用する\n* \\[ ] 重要な一時停止が視聴者に対して見える\n* \\[ ] フローが要求されたストーリー順序に従っている\n* \\[ ] スクリプトがフェーズ1で発見した実際のUIを反映している\n\n## よくある落とし穴\n\n1. ナビゲーション後にカーソルが消える——再注入する。\n2. 動画が速すぎる——一時停止を追加する。\n3. カーソルが矢印ではなく点になっている——SVGオーバーレイを使用する。\n4. カーソルが瞬間移動する——クリック前に移動する。\n5. ドロップダウン選択が途切れる——移動を表示してからオプションを選択する。\n6. モーダルが唐突に見える——確認前に読み取り一時停止を追加する。\n7. 動画ファイルパスがランダム——安定した出力名にコピーする。\n8. セレクターの失敗が飲み込まれる——サイレントキャッチブロックを絶対に使わない。\n9. フィールドタイプを仮定する——まず探索する。\n10. 機能を仮定する——スクリプトを書く前に実際のUIを確認する。\n11. プレースホルダーの選択値が本物に見える——`\"0\"` と `\"Select...\"` に注意する。\n12. ポップアップが別の動画を作成する——ポップアップページを明示的にキャプチャし、必要に応じて後でマージする。\n",{"name":5,"origin":24,"description":7},"ECC","main","57e7aa6b6e03bce1a7d7862ba9c2ec312f7f19b5","src\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Fja-JP\u002Fskills\u002Fui-demo",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 ui-demo",{"tool":40,"command":41},"bunx","bunx skills add Cyrilthetecchieee\u002Fcyril-code- --skill ui-demo",{"tool":43,"command":44},"pnpm","pnpm dlx skills add Cyrilthetecchieee\u002Fcyril-code- --skill ui-demo","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Fja-JP\u002Fskills\u002Fui-demo\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",[],[]]