AGENTS.md@packages/next-sdkA

AGENTS.md@packages/next-sdk from opentiny/webmcp-sdk is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add opentiny/webmcp-sdk/packages/next-sdk/AGENTS.md@git:20260904.3c7564b

Pins git:20260904.3c7564b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
opentiny/webmcp-sdk
Path
packages/next-sdk/AGENTS.md
Versions recorded
5
Latest version
git:20260904.3c7564b, committed Sep 4, 2026
First version recorded
Jul 21, 2026
Size
3,202 bytes
Repository stars
124
License
MIT

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# @opentiny/next-sdk — Agent 指南

改本包时先读根 [`AGENTS.md`](../../AGENTS.md)(含文首 **任务分流**),再读本文,再按需打开 Skill / Spec / 测试。用户长文见 VitePress `docs/webmcp-sdk/`。

## 本包 Spec 硬提醒

修改下列任一内容前,**必须**先创建或更新 `packages/next-sdk/specs/REQ-YYYYMMDD-slug/`(仅当用户明确豁免 Spec 时可例外):

- `page-tools/`
- 公开 a11y API / 类型(含 `A11yRoleRule`、`A11yConfig`、`PageAgentToolOptions` 等)
- `consoleCloudPageAgentToolOptions` 或其他默认/预设行为
- 无障碍树构建、剪枝、Static-Lift、序列化语义

然后:

1. 按 Spec `tasks.md` 改代码与 `test/page-tools/`
2. 需要时同步 `docs/webmcp-sdk/page-agent-tool.md` 与 `skills/page-agent/SKILL.md`

现有 Spec 索引见 [`specs/README.md`](./specs/README.md)。示例:[`specs/REQ-20260722-console-layout-landmark/`](./specs/REQ-20260722-console-layout-landmark/)。

## 推荐能力(主推)

本包面向浏览器 **内置 WebMCP**(`document.modelContext`)。新代码与约束说明请围绕:

- `initializeBuiltinWebMCP()`:注入 polyfill + 桥接;默认 `forcePolyfill: true`,覆盖会崩溃的 Chromium 实验性 native
- `document.modelContext.registerTool` / 业务工具注册
- `registerPageAgentTool` 及 a11y / 运行期配置 API

**不要**再把 `WebMcpServer` / `WebMcpClient` 作为默认推荐路径写进指引或示例(历史兼容代码可能仍存在,但非本仓库 Agent 约束的一部分)。

## 模块地图

| 路径 | 职责 |
|---|---|
| `page-tools/` | page-agent-tool、a11y、`waitForRouteTools`、高亮/遮罩、`initializeBuiltinWebMCP` |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add opentiny/webmcp-sdk/packages/next-sdk/AGENTS.md@sha256:7571c7796499a850

The line at the top of this page pins the label git:20260904.3c7564b, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_wzy42tjodjpbar6f.svg)](https://markdownregistry.com/a/art_wzy42tjodjpbar6f)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Jul 21, 2026 and Sep 4, 2026, about one every 11 days.

versioncommittedcommitsizeaudit
git:20260904.3c7564b latest2026-09-04 3c7564b 3,202 BA view · diff
git:20260807.21a9d4f2026-08-07 21a9d4f 3,124 BA view · diff
git:20260722.58db2972026-07-22 58db297 3,007 BA view · diff
git:20260722.1bb3f7d2026-07-22 1bb3f7d 2,183 BA view · diff
git:20260721.cdc264a2026-07-21 cdc264a 2,170 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (3202 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

opentiny/webmcp-sdk · 124 stars · license MIT · pushed 2026-11-03 · branch dev

API

GET https://markdownregistry.com/api/v1/artifacts/art_wzy42tjodjpbar6f
GET https://markdownregistry.com/api/v1/resolve?ref=opentiny/webmcp-sdk/packages/next-sdk/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/7571c7796499a850769f6896cd55c2765d6ae913621f5372e9e4c9d5284a8ec7

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from opentiny/webmcp-sdk

AGENTS.md AGENTS.md file
opentiny/webmcp-sdk · AGENTS.md
git:20260729.c3a3843 · audit A · 124 stars
库存入库管理助手 SKILL.md skill
opentiny/webmcp-sdk · packages/doc-ai-angular/remoter/src/skills/inventory/SKILL.md · 帮助电商管理员理解入库规则并执行入库操作的业务手册
v1.0.0 · audit A · 124 stars
订单管理助手 SKILL.md skill
opentiny/webmcp-sdk · packages/doc-ai-angular/remoter/src/skills/orders/SKILL.md · 帮助电商管理员查询和跟踪客户订单信息。当用户询问某个订单的状态、物流、买家信息,或需要查阅原始订单号以发起价保申请时使用。
v1.0.0 · audit A · 124 stars
客户价保单创建及审核 SKILL.md skill
opentiny/webmcp-sdk · packages/doc-ai-angular/remoter/src/skills/price-protection/SKILL.md · 帮助电商管理员处理顾客因降价提出的补差价请求的业务说明书,比如价保单的创建、审核等
v1.0.0 · audit A · 124 stars
product-guide SKILL.md skill
opentiny/webmcp-sdk · packages/doc-ai-angular/remoter/src/skills/product-guide/SKILL.md · 商品管理指南技能包,提供商品管理相关的搜索、查询和商品详情获取功能。
git:20260312.363d2cc · audit A · 124 stars
商品销售记录分析助手 SKILL.md skill
opentiny/webmcp-sdk · packages/doc-ai-angular/remoter/src/skills/sales/SKILL.md · 帮助电商管理员查询商品销售记录并解读销售趋势的业务说明书
v1.0.0 · audit A · 124 stars
库存入库管理助手 SKILL.md skill
opentiny/webmcp-sdk · packages/doc-ai-react/remoter/src/skills/inventory/SKILL.md · 帮助电商管理员理解入库规则并执行入库操作的业务手册
v1.0.0 · audit A · 124 stars
订单管理助手 SKILL.md skill
opentiny/webmcp-sdk · packages/doc-ai-react/remoter/src/skills/orders/SKILL.md · 帮助电商管理员查询和跟踪客户订单信息。当用户询问某个订单的状态、物流、买家信息,或需要查阅原始订单号以发起价保申请时使用。
v1.0.0 · audit A · 124 stars
客户价保单创建及审核 SKILL.md skill
opentiny/webmcp-sdk · packages/doc-ai-react/remoter/src/skills/price-protection/SKILL.md · 帮助电商管理员处理顾客因降价提出的补差价请求的业务说明书,比如价保单的创建、审核等
v1.0.0 · audit A · 124 stars
商品销售记录分析助手 SKILL.md skill
opentiny/webmcp-sdk · packages/doc-ai-react/remoter/src/skills/sales/SKILL.md · 帮助电商管理员查询商品销售记录并解读销售趋势的业务说明书
v1.0.0 · audit A · 124 stars
库存入库管理助手 SKILL.md skill
opentiny/webmcp-sdk · packages/doc-ai/src/skills/inventory/SKILL.md · 帮助电商管理员理解入库规则并执行入库操作的业务手册
v1.0.0 · audit A · 124 stars
订单管理助手 SKILL.md skill
opentiny/webmcp-sdk · packages/doc-ai/src/skills/orders/SKILL.md · 帮助电商管理员查询和跟踪客户订单信息。当用户询问某个订单的状态、物流、买家信息,或需要查阅原始订单号以发起价保申请时使用。
v1.0.0 · audit A · 124 stars

Every file in opentiny/webmcp-sdk

Browse by kind, by grade A, or by owner.