76 lines
3.0 KiB
Markdown
76 lines
3.0 KiB
Markdown
# 浏览器扩展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) — 多技能仓库结构参考。 |