wigolo skills add完全指南:按Agent安装、项目级与全局级作用域
2026/9/15 20:45:58 网站建设 项目流程

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):

Agentid项目级安装位置全局级安装位置
Claude Codeclaude-code.claude/skills/<pack>/~/.claude/skills/<pack>/
Codexcodex.agents/skills/<pack>/~/.agents/skills/<pack>/
Cursorcursor.agents/skills/<pack>/~/.cursor/skills/<pack>/
Gemini CLIgemini-cli.agents/skills/<pack>/~/.agents/skills/<pack>/
Clinecline.cline/skills/<pack>/~/.cline/skills/<pack>/
Windsurfwindsurf.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,附带逐文件内容哈希。这带来四个好处:

  1. 幂等重装—— 重复执行skills add对未变更的包是空操作,对已更新的包是干净升级;
  2. 安全卸载——skills remove只删除哈希仍匹配的 wigolo 所写文件,你手动改过的文件会被跳过并明确点名;
  3. 字节级确定—— 文件统一 LF 行尾写入,哈希稳定、漂移可检测;
  4. 收养与升级—— 识别旧版 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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询