web-skill
让Web应用为AI Agent提供任务级自动化API的开发库。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：web-skill。 它的用途是：让Web应用为AI Agent提供任务级自动化API的开发库。 完整的 Skill 内容见：https://321skill.com/skills/web-skill/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我在这个采购系统中找一个‘不锈钢螺丝’的供应商。”，Agent会先发现页面中由web-skill暴露的`findSupplierItem`技能，然后直接调用这个函数并返回结构化的供应商列表，而不是去费力地模拟点击搜索框、输入文字、等待结果加载等一系列DOM操作。
介绍
web-skill 旨在解决AI Agent与Web应用交互时面临的“黑箱”问题。传统浏览器自动化（DOM驱动）对Agent而言缓慢、昂贵且不可靠，而web-skill通过让Web应用主动发布结构化的任务级API，为Agent提供更透明、可中断、易协作的交互方式，使Agent能更安全地参与复杂或关键的业务流程。
使用上，开发者通过一个共享配置，即可将应用内可信的操作（如查找供应商、提交订单）注册为可供Agent调用的技能。它会自动生成技能描述文档（SKILL.md）并通过Vite插件注入到页面中，方便Agent发现和使用。整个过程TypeScript优先，并与Zod模式验证深度集成。
它非常适合那些希望将现有Web应用工作流开放给AI Agent，或在构建“Agent原生”应用时寻求更优交互界面的前端、全栈及智能体开发者。尤其适合已使用Vite和Zod的项目，能实现平滑集成。
需要注意的是，web-skill本身是一个开发库，并非开箱即用的Agent工具。它需要开发者明确规划并暴露哪些应用功能给Agent，并确保这些功能本身是安全可靠的。对于没有明确任务边界或高度依赖视觉DOM操作的纯内容型网站，其价值可能有限。
核心特点
与传统的浏览器自动化工具（如Puppeteer）不同，web-skill让Web应用主动发布结构化的任务API，使Agent能像调用函数一样操作应用，而非模拟点击，极大提升了交互的可靠性和性能。同时，它通过生成SKILL.md和标准化的发现机制，为Agent提供了清晰的“技能说明书”，实现了人机工作流的透明交接。
注意事项
不适合仅为人类用户设计、没有明确任务边界或高度依赖复杂视觉交互的纯内容展示型网站。
常见问题
web-skill和浏览器自动化插件有什么区别？
web-skill是让网站主动提供API给Agent调用，速度快且稳定；自动化插件是Agent被动模拟用户操作，容易出错且慢。
我的网站没有用Vite，能用web-skill吗？
核心运行时API（web-skill）可以使用，但无法使用Vite插件自动注入技能链接和生成文档，需要手动处理。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/web-skill/raw/index.md 读取 web-skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/web-skill/raw/index.md（查看排版版本）