关于 chrome-extension-dev
chrome-extension-dev 是面向浏览器扩展开发者的指南,涵盖 Chrome API 和 Manifest V3,并以 WXT 为主要框架。内容包括实现模式,以及测试和发布参考资料。
主要功能
- 01WXT 项目初始化与结构
- 02Content Script 和 Service Worker 指引
- 03Chrome API 用法与权限
- 04Manifest V3 限制及应对方式
- 05测试与发布参考资料
适用场景
- 01使用 WXT 启动浏览器扩展
- 02实现标签页、存储或 Cookie 功能
- 03将扩展适配到 Manifest V3
- 04查阅扩展测试和发布实践
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ aktsmm/ agent-skills --skill chrome-extension-dev安装后在 Claude Code 中输入/chrome-extension-dev确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
LICENSE.txtreferences/chrome-api.mdmanifest-v3.mdpatterns.mdpublishing.mdtesting.md详细介绍
来自项目 READMEChrome Extension Dev
ブラウザ拡張機能開発の包括的ガイド。
When to Use
- ブラウザ拡張機能を作りたい、Chrome拡張、browser extension
- WXT フレームワークでの開発
- Content Script / Service Worker の実装
- Chrome API(tabs, storage, cookies等)の使用
- Manifest V3 への対応・移行
推奨技術スタック(2025/2026)
| カテゴリ | 推奨 |
|---|---|
| フレームワーク | WXT (Vite ベース) |
| フロントエンド | React 18+ / Vue 3 / Svelte |
| 言語 | TypeScript |
| スタイリング | Tailwind CSS |
| UIコンポーネント | shadcn/ui / Mantine |
| 状態管理 | Zustand / Jotai |
| テスト | Vitest (ユニット) + Playwright (E2E) |
WXT クイックスタート
# 新規プロジェクト作成(対話式)
npx wxt@latest init
# テンプレート指定(vanilla / vue / react / svelte / solid、全て TypeScript)
npx wxt@latest init my-extension -t react
# 開発コマンド
npm run dev # HMR付き開発サーバー
npm run build # プロダクションビルド
npm run zip # ストア提出用パッケージ
プロジェクト構成
project/
├── entrypoints/ # 自動検出エントリポイント
│ ├── background.ts # Service Worker
│ ├── content.ts # Content Script
│ ├── popup/ # Popup UI
│ │ ├── index.html
│ │ └── main.tsx
│ └── options/ # Options Page
├── components/ # 自動インポートUIコンポーネント
├── utils/ # 自動インポートユーティリティ
├── public/ # 静的アセット(icon等)
├── wxt.config.ts # WXT設定
└── package.json
主要 Chrome API
| API | 用途 | 権限 |
|---|---|---|
chrome.tabs | タブ操作 | tabs / activeTab |
chrome.storage | データ永続化 | storage |
chrome.runtime | メッセージング | なし |
chrome.scripting | スクリプト/CSS注入 | scripting + host権限 |
chrome.cookies | Cookie操作 | cookies + host権限 |
chrome.offscreen | DOM操作(SW内) | offscreen |
→ 詳細: references/chrome-api.md
Manifest V3 制限事項
| 制限 | 対処法 |
|---|---|
| 30秒タイムアウト | chrome.alarms でウェイクアップ |
| DOMアクセス不可 | chrome.offscreen を使用 |
| 永続化なし | chrome.storage.session を使用 |
| eval()禁止 | 事前にバンドル |
| リモートコード禁止 | 全コードをバンドル |
→ 詳細: references/manifest-v3.md
権限変更時の注意
⚠️ 重要:
permissions/host_permissions変更後は拡張機能の再読み込みでは不十分。 削除→再インストールが必要。
Key References
| トピック | リファレンス |
|---|---|
| Chrome API 詳細 | references/chrome-api.md |
| Manifest V3 | references/manifest-v3.md |
| テスト | references/testing.md |
| 公開 | references/publishing.md |
| よくあるパターン | references/patterns.md |
Done Criteria
- WXT プロジェクト構成が正しい
- 必要な権限が
wxt.config.tsに設定されている - Manifest V3 制限を考慮した実装
- 開発モードで動作確認済み
- ビルドエラーがない
External Resources
评论
支持 Markdown