巧手 (qiaoshou-plugin-dev) · 浏览器扩展与 IDE 插件开发
一、定位
巧手 是 Chrome 扩展与 IDE 插件开发 skill。它补齐 vibecoding 生态中"插件/扩展开发"这一空白，
把插件开发从"照葫芦画瓢"变为结构化的开发流程，重点覆盖：
- 浏览器扩展（Manifest V3）：清单设计、权限、Content/Background/Service Worker 架构。
- VS Code 扩展：Extension API、命令/视图/语言特性、激活事件。
- JetBrains 插件：Plugin SDK、Action/Service、打包发布。
- 发布落地：Chrome Web Store / VS Code Marketplace / JetBrains Marketplace。
二、何时使用
- 插件开发 / 浏览器插件 / Chrome 扩展 / 浏览器扩展 / manifest v3
- VS Code 插件 / vscode extension / JetBrains 插件 / IDE 插件
- 开发扩展 / chrome extension / browser extension
- 上架插件 / 插件打包 / 扩展发布
三、前置信息
| 输入 | 说明 | 缺失时 |
|---|---|---|
| 插件定位 | 要解决什么问题、目标平台（Chrome/VS Code/JetBrains） | 问一个阻塞性问题 |
| 核心功能 | 插件的核心交互（右键菜单/侧边栏/命令/自动处理） | 问一个阻塞性问题 |
| 技术栈 | 语言偏好（JS/TS/Kotlin/Java） | 默认 TS |
四、工作流（agent 执行）
步骤 1 需求定位 : 明确插件解决的核心问题、触发方式（命令/菜单/页面注入/自动监听）。
步骤 2 脚手架 : 生成最小可运行骨架（manifest.json / extension.ts / plugin.xml）；
优先以 assets/scaffolds/ 下对应平台骨架（chrome-mv3 / vscode-ext / jetbrains）为起点改造。
步骤 3 核心逻辑 : 实现核心功能，遵守各平台架构规范（见下方"架构要点"）。
步骤 4 权限与安全 : 按最小权限原则声明权限，限制可访问范围，避免注入风险。
步骤 5 打包 : 产出可加载/可安装的产物（.crx/.zip / .vsix / .jar）。
步骤 6 发布 : 提交对应商店/Marketplace 的审核要点与文案。
步骤 7 交付 : 输出插件骨架代码 + 打包产物 + 发布指南。
五、架构要点（必守）
Chrome 扩展（MV3）：
- Service Worker 取代持久后台页，事件驱动、不可常驻。
- Content Script 与页面隔离，通过消息通信（chrome.runtime）。
- 权限最小化（activeTab 优先，避免 <all_urls>）。
VS Code 扩展：
- 按 activationEvents 惰性激活，避免启动拖慢。
- 命令/视图/语言特性用对应 Contribution Point。
JetBrains 插件：
- Action + Service 分层，用 Plugin SDK，注意线程（EDT）。
六、质量门控
- 权限必须最小化，并解释每项权限的用途（商店审核硬要求）。
- 涉及注入/读取网页内容的，须说明数据流向与隐私（不得静默上传）。
- 产出必须包含可运行的骨架代码，禁止只给文字方案。
- 上架材料必须过
references/store-publishing.md对应商店清单；涉及时效的结论附官方来源与核查/生效月份。 - VS Code 自 2026-12-01 起不再依赖全局 PAT 的新发布流程，优先 Trusted Publishing/OIDC；不得把长期凭据写入生成的工程。
七、输出格式
# 插件开发方案
插件定位 / 目标平台 / 核心功能
## 架构设计（清单/入口/消息通信）
## 关键代码骨架
## 权限与安全说明
## 打包与发布指南
八、目录
references/chrome-extension.md— Chrome MV3 扩展开发要点references/vscode-extension.md— VS Code 扩展开发要点references/jetbrains-plugin.md— JetBrains 插件开发要点references/store-publishing.md— 三商店上架清单（各 ≥10 项）、文案模板与官方来源（v1.2 新增）assets/scaffolds/chrome-mv3/— Chrome MV3 最小可运行骨架（side panel + content script + service worker）（v1.1 新增）assets/scaffolds/vscode-ext/— VS Code 扩展最小可运行骨架（命令 + 树视图，零构建）（v1.1 新增）assets/scaffolds/jetbrains/— JetBrains 插件最小源文件（Action + Service，含线程纪律）（v1.1 新增）
九、免责声明
各商店/Marketplace 审核政策会更新，发布前以官方最新政策为准；涉及用户数据的插件须遵守隐私合规要求。
