Imported from ziniao-open/skills (
skills/ziniao-page/SKILL.md) via skills.sh. Install upstream withnpx skills add ziniao-open/skills --skill ziniao-page. Copyright stays with the author.
紫鸟页面能力
本技能负责已打开紫鸟店铺浏览器中的通用网页资源操作，不负责店铺生命周期，也不定义用户的业务流程。
负责范围
- 对当前店铺浏览器中的网页进行通用操作或读取。
- 在页面操作中复用已确认的
store-id，必要时指定target-id。 - 根据页面状态选择 CLI 已提供的页面命令；参数以
ziniao-cli page <command> --help为准。 - 页面操作需要复杂编排时，按需读取 automation reference。
路由边界
- 已有店铺浏览器并且目标是网页资源：直接使用本技能。
- 任务尚未确定或打开店铺：转到
ziniao-store，不要自行猜测店铺 ID。 - 不要把用户的业务目标或任务参数写入技能；这些是用户任务，由模型组合通用页面能力完成。
- 配置、认证、Bridge、客户端或网络异常：按需读取
ziniao-shared的诊断规则，不在本技能重复维护环境修复流程。
最小执行规则
- 确认店铺已打开，并取得有效
store-id；页面命令通常都需要它。 - 先确认当前页面状态，再执行必要的页面操作；页面变化后不要复用失效的目标或定位信息。
- 对导航、等待、读取、交互、提取和截图等能力，直接使用 CLI 的对应命令；不确定参数时先看
--help。 - 涉及附件或图片上传时，在下载、路径转换或上传调用前，必须完整读取 page upload 安全规则；未读取不得执行上传。
- 只在当前任务需要时读取 reference，不要默认读取全部页面文档。
- 报错时区分页面/目标定位问题和环境问题；环境问题再转
ziniao-shared/doctor。
页面读取与定位顺序
- 页面状态、
target-id和稳定 CSS selector 已知时，直接复用并执行必要操作；不要为每一步重复读取页面。 - 需要理解页面或验证导航、搜索、提交结果时，优先使用
page content --content-format structured；只需 URL/title 时也可使用page exec。 - selector 未知时，先使用
page content、page query或page exec分析 DOM，再使用page input/page click --selector。 - 只有上传控件、自定义或图标控件、多个相似控件存在歧义，或上述 DOM 方法仍无法唯一定位时，才使用
page snapshot和当前页面 ref。
page snapshot 不是通用页面状态检查命令。不得为了验证店铺窗口、读取 URL/title/target-id、操作已知 selector、普通搜索或结果验证而调用 snapshot；页面未变化时也不得重复创建 snapshot/ref。snapshot ref 只属于当前店铺、tab 和页面，页面导航或刷新后不得复用。
输入后提交只能选择一种方式：使用 page input --submit 后等待并验证结果，或不传 --submit 再执行提交按钮的 page click --wait-nav；不得重复提交。
按需参考
- page visit：需要导航时读取。
- page screenshot：需要截图时读取。
- page upload 安全规则：涉及附件、图片、文件输入框或
page upload时必须读取。 - automation run：需要多步骤自动化时读取。
ziniao-store：需要确定或打开店铺时使用。ziniao-shared：仅在环境、配置、认证或 Bridge 诊断时读取。
