wot-ui-cli

name	wot-ui-cli
description	使用、调试或维护 @wot-ui/cli 与 open-wot 仓库。适用于 wot CLI 命令、Agent/MCP 接入、doctor/usage/lint、组件知识查询、客户端 adapter、离线数据提取、构建测试、发布包检查和仓库开发；如果任务是直接编写 wd-* 组件页面或解释组件 API，应改用 wot-ui-v2 skill。

Wot UI CLI

处理 @wot-ui/cli、MCP、Agent 接入和 open-wot 仓库维护任务时，基于当前源码、package.json 和 README 行事，不根据旧文档猜测命令。

路由

• CLI、MCP、Agent、数据提取或仓库开发：使用本 Skill。
• 组件选型、页面代码、props、主题和组件问题：使用 wot-ui-v2 Skill。
• 通过 CLI 查询组件知识时，保留 CLI 使用语境；需要生成组件代码时再切换到 wot-ui-v2。

工作流

1. 先查看 README.md、package.json#scripts 和相关源码。
2. 修改 CLI、MCP、prompt、数据结构或 Skill 后，同步测试与 README。
3. 写配置前先运行 --dry-run，使用隔离 --cwd，不要修改真实用户配置。
4. 修改命令输出后，至少运行一个真实源码或构建产物命令。
5. 提交前运行 pnpm lint && pnpm typecheck && pnpm test && pnpm build。

命令分组

组件知识：

wot list [keyword]
wot info <component>
wot doc <component>
wot demo <component> [name]
wot token [component]
wot changelog [versionOrComponent] [component]

项目分析：

wot doctor [dir]
wot usage [dir]
wot lint [dir]

Agent 接入：

wot agent list
wot agent init --client cursor
wot agent status --client cursor
wot agent doctor --client cursor
wot agent remove --client cursor
wot agent init --client all

MCP 管理：

wot mcp
wot mcp serve
wot mcp list
wot mcp init --client cursor
wot mcp status --client cursor
wot mcp doctor --client cursor
wot mcp remove --client cursor
wot mcp print --client cursor

查询命令支持 --version 和 --format text|json|markdown。Agent/MCP 管理命令支持的具体选项以 --help 和源码为准；写操作优先使用 --dry-run。

仓库开发

pnpm install
pnpm dev
pnpm exec tsx src/index.ts list
pnpm build
node dist/index.mjs list

更新离线数据：

pnpm sync:clone
pnpm extract:clone
pnpm sync --wot-dir ../wot-ui
pnpm extract --wot-dir ../wot-ui --output data/v2.0.4.json

发布包检查：

pnpm build
pnpm compress
pnpm exec publint
npm pack --dry-run --json

MCP 注意事项

• wot mcp 使用 stdio，终端无普通输出通常正常。
• doctor 验证配置和真实 handshake；部分客户端还会检查注册状态。
• --client all 在 project scope 处理四个支持客户端。
• 保留已有 Server、JSONC 注释、非托管 TOML 和用户 Instructions。

参考

需要完整命令矩阵、目录职责、验证要求、数据与发布流程时，读取 references/overview.md。