| 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。
工作流
- 先查看
README.md、package.json#scripts 和相关源码。
- 修改 CLI、MCP、prompt、数据结构或 Skill 后，同步测试与 README。
- 写配置前先运行
--dry-run，使用隔离 --cwd，不要修改真实用户配置。
- 修改命令输出后，至少运行一个真实源码或构建产物命令。
- 提交前运行
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。
