处理 wot CLI、MCP/Agent 接入或…

适用于 @wot-ui/cli 命令使用与调试、Agent/MCP 接入、doctor/usage/lint、组件知识查询、离线数据提取、构建测试和发布包检查。

适用场景

解决思路

1. 按任务类型路由：CLI、MCP、Agent、数据提取或仓库开发使用本 Skill；组件选型、页面代码、props、主题和组件问题使用 wot-ui-v2 Skill；通过 CLI 查询组件知识时保留 CLI 使用语境，需要生成组件代码时切换到 wot-ui-v2。
2. 先查看 README.md、package.json#scripts 和相关源码，不根据旧文档猜测命令。
3. 修改 CLI、MCP、prompt、数据结构或 Skill 后，同步更新测试与 README。
4. 写配置前先运行 --dry-run，使用隔离 --cwd，不要修改真实用户配置。
5. 修改命令输出后，至少运行一个真实源码或构建产物命令。
6. 提交前运行 pnpm lint && pnpm typecheck && pnpm test && pnpm build。
7. 组件知识查询使用：wot list [keyword]、wot info <component>、wot doc <component>、wot demo <component> [name]、wot token [component]、wot changelog [versionOrComponent] [component]。
8. 项目分析使用：wot doctor [dir]、wot usage [dir]、wot lint [dir]。
9. 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。
10. 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。
11. 查询命令支持 --version 和 --format text|json|markdown。
12. Agent/MCP 管理命令支持的具体选项以 --help 和源码为准；写操作优先使用 --dry-run。
13. 仓库开发运行 pnpm install、pnpm dev、pnpm exec tsx src/index.ts list、pnpm build、node dist/index.mjs list。
14. 更新离线数据运行 pnpm sync:clone、pnpm extract:clone、pnpm sync --wot-dir ../wot-ui、pnpm extract --wot-dir ../wot-ui --output data/v2.0.4.json。
15. 发布包检查运行 pnpm build、pnpm compress、pnpm exec publint、npm pack --dry-run --json。
16. wot mcp 使用 stdio，终端无普通输出通常正常。
17. doctor 验证配置和真实 handshake；部分客户端还会检查注册状态。
18. --client all 在 project scope 处理六个支持客户端。
19. 保留已有 Server、JSONC 注释、非托管 TOML 和用户 Instructions。
20. 需要完整命令矩阵、目录职责、验证要求、数据与发布流程时，读取 references/overview.md。

适用边界 · 注意事项

• 组件选型、页面代码、props、主题和组件问题应改用 wot-ui-v2 Skill。
• 直接编写 wd-* 组件页面或解释组件 API 应改用 wot-ui-v2 Skill。