Web-Skills-Protocol
让网站通过标准文件,直接教会AI如何与之交互。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:Web-Skills-Protocol。 它的用途是:让网站通过标准文件,直接教会AI如何与之交互。 完整的 Skill 内容见:https://321skill.com/skills/web-skills-protocol/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我在Example商城下单一本《AI入门指南》。” AI会首先访问该商城的 `skills.txt` 文件,找到“下单”技能的定义(SKILL.md),然后严格按照文件中描述的API端点、参数格式和业务流程来完成订购,而不是去尝试点击网页按钮。
介绍
Web Skills Protocol (WSP) 旨在解决AI智能体在访问网站时面临的交互难题。当前,AI只能通过解析HTML、猜测按钮功能或逆向工程API来与网站互动,这种方式不仅脆弱、缓慢,而且极易出错。WSP提供了一个标准化的解决方案,让网站能够主动、清晰地告知AI其功能和使用方法。
WSP的使用方式非常简单。网站所有者只需在根目录下放置一个名为 skills.txt(或 agents.txt)的发现文件,并在 /skills/(或 /agents/)目录下发布具体的技能定义文件(SKILL.md)。这些技能文件采用AI生态中已广泛使用的标准格式:包含YAML元数据的Markdown文件,其中详细描述了如何调用API、完成特定工作流程等。
这个协议主要适合两类用户:一是希望自己的网站或服务能被AI智能体更可靠、更高效使用的开发者与产品团队;二是构建和优化AI智能体的开发者,他们可以利用WSP让智能体获得更稳定、官方的网站操作指南,提升任务成功率。
与同类工具相比,WSP的核心优势在于它并非创造新标准,而是为现有且成熟的“AI技能文件”格式(已被Claude、OpenClaw等广泛采用)增加了一个Web发现层。它借鉴了 robots.txt 的经典思路,将控制权交还给网站所有者,实现了从“禁止爬取”(robots.txt)到“提供内容”(llms.txt),再到“教授能力”(skills.txt)的进化。
核心特点
WSP的核心区别在于其“轻量级协议”定位:它没有发明新的技能文件格式,而是为AI生态中已事实存在的标准技能文件(SKILL.md)增加了一个基于 `skills.txt` 的Web发现机制,类似于RSS之于XML。这使得它易于采纳且与现有工具链兼容。
注意事项
该协议依赖于网站所有者主动创建和维护技能文件,对于尚未支持WSP的网站,AI智能体仍需依赖传统方式交互。
常见问题
skills.txt 和 robots.txt 有什么区别?
robots.txt 告诉网络爬虫不要访问哪些页面(访问控制),而 skills.txt 则主动告诉AI智能体如何使用该网站的功能(能力开放)。
网站如何开始使用WSP?
只需在网站根目录创建 skills.txt 文件,列出可用技能,并在 /skills/ 目录下以标准SKILL.md格式编写具体的技能说明文件即可。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/web-skills-protocol/raw/index.md 读取 Web-Skills-Protocol 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/web-skills-protocol/raw/index.md(查看排版版本)