# 浏览器扩展AI技能库

`浏览器扩展` `AI代理` `技能库` `Addfox`

# addfox-skills

一个独立的技能库，专为使用 [Addfox](https://github.com/addfox/addfox) 框架构建浏览器扩展的 AI 代理设计。使用 [skills CLI](https://github.com/vercel-labs/skills)，通过 **`npx skills add`** 添加这些技能。

**[中文文档（英文版）](README-zh_CN.md)**

## 安装

在项目根目录下运行：

```bash
# 从此仓库添加所有技能（例如添加到 .cursor/skills/ 或 .agents/skills/）
npx skills add addfox/skills

# 仅添加特定技能
npx skills add addfox/skills --skill migrate-to-addfox
npx skills add addfox/skills --skill addfox-best-practices
npx skills add addfox/skills --skill extension-functions-best-practices
npx skills add addfox/skills --skill addfox-debugging
npx skills add addfox/skills --skill addfox-testing

# 安装前列出可用技能
npx skills add addfox/skills --list
```

或使用完整的 GitHub URL：

```bash
npx skills add https://github.com/addfox/skills
```

## 技能列表

| 技能 | 描述 |
|-------|-------------|
| **migrate-to-addfox** | 将现有项目从 WXT、Plasmo、Extension.js 或原生（无框架）迁移到 Addfox。 |
| **addfox-best-practices** | 使用 Addfox 构建扩展的最佳实践：入口、配置、manifest、权限、跨平台、框架/样式、消息传递。 |
| **extension-functions-best-practices** | 扩展功能实践：视频/音频、录制、截图、AI、登录、翻译；推荐轻量级库（如 Mediabunny）和开源扩展。 |
| **addfox-debugging** | 调试构建和运行时错误：使用 addfox/rsbuild 终端输出、`.addfox/error.md` 和 `.addfox/meta.md`；通过入口、位置、消息、堆栈和前端框架定位并修复问题。 |
| **addfox-testing** | 使用 Rstest 进行单元测试和端到端测试：如何配置 rstest、何时使用单元测试与端到端测试、依赖项（如 @rstest/core、playwright、@rstest/browser）、文件命名及框架专用库（React、Vue、Svelte、Solid）。 |

## 目录结构

```
.
├── package.json
├── README.md
├── README-zh_CN.md
└── skills/
    ├── migrate-to-addfox/
    │   ├── SKILL.md
    │   └── references/
    ├── addfox-best-practices/
    │   ├── SKILL.md
    │   ├── reference.md
    │   └── rules/
    ├── extension-functions-best-practices/
    │   ├── SKILL.md
    │   └── reference.md
    ├── addfox-debugging/
    │   ├── SKILL.md
    │   └── reference.md
    └── addfox-testing/
        ├── SKILL.md
        └── reference.md
```

## 参考资料

- [skills CLI](https://github.com/vercel-labs/skills) — 使用 `npx skills add` 添加任意技能仓库。
- [Remotion skills](https://github.com/remotion-dev/skills/tree/main/skills/remotion) — 技能与规则布局参考。
- [rstackjs/agent-skills](https://github.com/rstackjs/agent-skills/tree/main/skills) — 多技能仓库结构参考。