wigolo skills add完全指南:按Agent安装、项目级与全局级作用域
【免费下载链接】wigoloThe go-to web for your AI coding agent — local-first search, fetch, crawl & research over MCP. No API keys, no cloud, $0/query. Public beta.项目地址: https://gitcode.com/GitHub_Trending/wi/wigolo
wigolo是一个本地优先(local-first)的 AI 编码代理网络工具,通过 MCP 提供搜索、抓取、爬站与深度研究能力,无需 API Key、无需云、零成本每次查询。而wigolo skills add是它的一键技能包安装命令——只需一行,就能把 wigolo 教给你的编码代理"如何正确使用这 10 个网络工具"的技能包,装到 Claude Code、Cursor 等 6 种主流 Agent 中,并支持项目级与全局级两种作用域。🎯
什么是 wigolo skills add?
Skill(技能包)是一种"按需加载的指令包":代理只在任务匹配时才读取对应技能,而不是把所有说明塞进系统提示词。wigolo 内置了11 个技能包,覆盖工具选择、缓存优先策略、查询技巧等实战经验,核心入口是 skills/wigolo/SKILL.md。
wigolo skills共提供三个子命令(源码见 src/cli/skills.ts):
| 子命令 | 作用 |
|---|---|
add | 安装技能包到目标 Agent |
list | 查看每个 Agent 的安装状态 |
remove | 移除已安装的技能包 |
60 秒快速上手:一键安装全部技能包
在任意项目目录下执行(若未全局安装 wigolo,可用npx直接运行,安装方式见 docs/installation.md):
wigolo skills add这一条命令的默认行为是:自动检测本机已安装的 Agent + 安装全部 11 个技能包 + 装到当前项目(项目级作用域)。
装完之后,打开 Claude Code 提问"帮我搜索 X",它就会优先走 wigolo 的cache → search → fetch升级链路,而不是内置的 WebSearch。
按 Agent 安装:用 --agent 精确指定目标
默认安装给"检测到的所有 Agent"。如果想只装给指定的代理,用--agent传逗号分隔的 id:
wigolo skills add wigolo-search wigolo-fetch --agent claude-code,cursor当前支持以下 6 种 Agent(完整矩阵见 src/cli/agents/skills/targets.ts):
| Agent | id | 项目级安装位置 | 全局级安装位置 |
|---|---|---|---|
| Claude Code | claude-code | .claude/skills/<pack>/ | ~/.claude/skills/<pack>/ |
| Codex | codex | .agents/skills/<pack>/ | ~/.agents/skills/<pack>/ |
| Cursor | cursor | .agents/skills/<pack>/ | ~/.cursor/skills/<pack>/ |
| Gemini CLI | gemini-cli | .agents/skills/<pack>/ | ~/.agents/skills/<pack>/ |
| Cline | cline | .cline/skills/<pack>/ | ~/.cline/skills/<pack>/ |
| Windsurf | windsurf | .windsurf/rules/wigolo.md | 全局规则文件中的围栏块 |
💡 小细节:Windsurf 本身不读取技能目录,所以项目级会收到一份合并好的规则文件
wigolo.md;全局级则写入~/.codeium/windsurf/memories/global_rules.md中一个专属围栏块,卸载时只精确删除该块,不动其他内容。
项目级 vs 全局级作用域:该怎么选?
| 场景 | 推荐作用域 | 命令 |
|---|---|---|
| 团队项目,希望技能随仓库提交、全员共享 | 项目级(默认) | wigolo skills add |
| 个人开发机,所有项目都要用 wigolo 工具链 | 全局级 | wigolo skills add --global |
| 只想在实验项目试水 | 项目级 | wigolo skills add --dry-run先预览 |
两个作用域互不干扰,可以并存:全局级提供"底座"能力,项目级覆盖或补充特定项目的技能。
11 个技能包:按需选装清单
不指定 pack 名时安装全部;指定则只装对应技能包:
| 技能包 | 教会代理什么 |
|---|---|
wigolo | 总控:10 个工具的选择策略、缓存优先模式 |
wigolo-search | 多关键词查询、深度档位、域名限定、新鲜度过滤 |
wigolo-fetch | 干净 Markdown 抓取、JS 渲染、认证会话 |
wigolo-crawl | 站点索引策略与缓存预热 |
wigolo-cache | 先查本地缓存再走网络的省钱技巧 |
wigolo-extract | 结构化抽取与 schema 设计 |
wigolo-find-similar | 混合语义发现与冷启动处理 |
wigolo-research | 研究简报、深度选择、交叉引用 |
wigolo-agent | 带 schema 与预算的自主数据采集 |
wigolo-diff | 页面版本对比 |
wigolo-watch | 变更监控与 webhook |
例如只给 Cursor 装搜索技能:
wigolo skills add wigolo-search --agent cursor --global进阶选项:dry-run、json 与 force 三件套
| 选项 | 作用 | 典型用法 |
|---|---|---|
--dry-run | 只打印安装计划,不碰文件系统 | wigolo skills add --dry-run |
--json | 输出机器可读 JSON(stdout 只有一个 JSON 文档) | 接入 CI / 自动化脚本 |
--force | 覆盖被用户改过的文件 / 替换符号链接 | 解决 refused 冲突 |
--global | 用户级(默认是项目/当前目录) | 全局安装 |
收据(receipts)模型:安全可逆的安装机制
每次安装都会记录在~/.wigolo/skills/receipts.json,附带逐文件内容哈希。这带来四个好处:
- 幂等重装—— 重复执行
skills add对未变更的包是空操作,对已更新的包是干净升级; - 安全卸载——
skills remove只删除哈希仍匹配的 wigolo 所写文件,你手动改过的文件会被跳过并明确点名; - 字节级确定—— 文件统一 LF 行尾写入,哈希稳定、漂移可检测;
- 收养与升级—— 识别旧版 wigolo 装下的包并接管,不重复、不覆盖。
验证与卸载:完整闭环
wigolo skills list # 查看各 Agent 安装状态 wigolo skills list --global # 查看全局级状态 wigolo skills remove --dry-run # 先预览移除计划 wigolo skills remove # 真正移除想深入了解每个技能的规则细节,可阅读 skills/wigolo/rules/cache-first.md 等规则文件;完整命令参考见 docs/cli.md,官方技能文档见 docs/skills.md。
写在最后
一行wigolo skills add,就把 wigolo 的搜索、抓取、爬站、研究能力"教"给了你的编码代理——按 Agent 精准投放、项目级与全局级自由切换、收据模型保证随时可逆。本地优先、无 API Key、每次查询 $0,这正是 wigolo 作为 AI 代理"首选网络层"的底气。✨
【免费下载链接】wigoloThe go-to web for your AI coding agent — local-first search, fetch, crawl & research over MCP. No API keys, no cloud, $0/query. Public beta.项目地址: https://gitcode.com/GitHub_Trending/wi/wigolo
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考