mcpField
C
chrome-extension-dev

chrome-extension-dev

github.com/aktsmm开发2646 次安装今天更新
代码仓库

关于 chrome-extension-dev

chrome-extension-dev 是面向浏览器扩展开发者的指南,涵盖 Chrome API 和 Manifest V3,并以 WXT 为主要框架。内容包括实现模式,以及测试和发布参考资料。

主要功能

  1. 01WXT 项目初始化与结构
  2. 02Content Script 和 Service Worker 指引
  3. 03Chrome API 用法与权限
  4. 04Manifest V3 限制及应对方式
  5. 05测试与发布参考资料

适用场景

  1. 01使用 WXT 启动浏览器扩展
  2. 02实现标签页、存储或 Cookie 功能
  3. 03将扩展适配到 Manifest V3
  4. 04查阅扩展测试和发布实践

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/aktsmm/agent-skills --skill chrome-extension-dev

安装后在 Claude Code 中输入/chrome-extension-dev确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

LICENSE.txt
references/
chrome-api.md
manifest-v3.md
patterns.md
publishing.md
testing.md

详细介绍

来自项目 README

Chrome 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.cookiesCookie操作cookies + host権限
chrome.offscreenDOM操作(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 V3references/manifest-v3.md
テストreferences/testing.md
公開references/publishing.md
よくあるパターンreferences/patterns.md

Done Criteria

  • WXT プロジェクト構成が正しい
  • 必要な権限が wxt.config.ts に設定されている
  • Manifest V3 制限を考慮した実装
  • 開発モードで動作確認済み
  • ビルドエラーがない

External Resources

评论

支持 Markdown