TDesign Mobile React API

本 skill 只服务 tdesign-mobile-react。实现时使用移动端 React API，不照搬 Web React。如果同目录存在 ../tdesign-skills/references/constraints.md，可参考它获取更详细的跨 skill 约束。

使用协议

1. 必须通过 load_skill 加载本 skill，不要绕过 skill 系统直接 grep、find 或 read references/ 下的内部文件。load_skill 返回的 SKILL.md 包含查阅顺序、写法边界和约束上下文，直接读文件会丢失这些关键指导，导致跳步、跨栈误判或凭记忆编造 API。
2. 严格按下方「查阅顺序」执行，不跳步、不凭经验猜路径。先确认依赖和组件覆盖，再查 API，最后才查示例。
3. 需要交接到其他 skill 时，对目标 skill 再次 load_skill，不要直接读目标 skill 的 references/ 文件。
4. references/ 下的文件只在 SKILL.md 指引下按需读取，它们是 skill 的内部资料，不是独立文档。

查阅顺序

前置条件：组件 API 依赖 tdesign-mcp-server 的 get-component-docs / get-component-list。查询前先确认当前环境已安装并配置 tdesign-mcp-server；若不可用，不要凭记忆编造 API，先明确告知用户缺少 tdesign-mcp-server 并引导其安装后再继续（详见 ../tdesign-docs/references/api/README.md 的「降级处理」）。

1. 先确认项目安装 tdesign-mobile-react，并查看已有代码的导入与写法。
2. 组件是否存在：已安装 tdesign-docs 时查 ../tdesign-docs/references/meta/stack-matrix-mobile.json 的 coverage.byStack.mobile-react；未安装 tdesign-docs 时，用 tdesign-mcp-server 的 get-component-list 确认组件是否存在，不从记忆推断。
3. 具体组件 API：调用 tdesign-mcp-server 的 get-component-docs，传 framework: "mobile-react"、names: ["<组件名>"]，以返回的 API（props、事件、render、函数式调用、子组件）为权威依据，不凭记忆编造。
4. 需要确认更精确的类型或复合成员（如 Table.columns）时，结合 get-component-docs 返回的 API 表与 demo，必要时再读同栈 references/examples/ 对应组件的最小示例与类型线索。
5. 用户在问“怎么用/给示例”时，再查 references/examples/README.md，命中组件目录后按需读 base.tsx 和最接近需求的关键变体。
6. 涉及跨端语义或端差异时：已安装 tdesign-docs 时先看 ../tdesign-docs/references/api/shared/index.md；未安装时按 tdesign-mcp-server 返回的当前栈 API 落实，不确定的差异明确告知用户需人工确认，建议补装 tdesign-docs 获得跨端共享契约。
7. 移动端页面骨架与组合：已安装 tdesign-composition 时查 ../tdesign-composition/references/scenarios/mobile-pages.md；未安装时只用本栈组件按移动端惯例（导航 + Cell/Form/List + 反馈）组织，不照搬 Web 中后台骨架，建议补装 tdesign-composition 获得标准场景卡。版本能力先 tdesign-changelog，未安装时跳过，查完仍用 get-component-docs 返回的当前栈 API 落实写法。

Mobile React 写法边界

• 使用移动端 React 组件和事件，不套用 Web React 组件默认值或桌面交互，因为移动端组件的触摸交互、手势支持和安全区域适配与 Web 版不同。
• 移动端页面不照搬 Web 中后台应用壳、密集表格和复杂筛选区，因为移动端交互以列表、卡片和手势为主。
• 不把 tdesign-react、Mobile Vue 或 Miniprogram API 当作 Mobile React API。
• 不凭经验编造 props、事件、插槽或函数式调用，应通过 tdesign-mcp-server 查 mobile-react 栈该组件的 API 确认。
• 不凭经验编造复合组件成员名；例如移动端 Table 先查 columns、render 和相关类型，不要直接生成 TableColumn 或其他未在当前栈 API 中确认的导出名。
• 用户要求“怎么用”或“给个示例”时，先用 get-component-docs 拿当前组件 API 与 demo，必要时补读同栈 references/examples/ 最小示例，再组织移动端 React 代码；不要跳过 API 直接给经验写法。

约束

• 只按当前任务查询需要的单个组件，不一次性批量拉取整库 API，因为会浪费大量 token 且信息过载。
• 优先用 TDesign Mobile 组件和 props 解决问题，最后才补最小 CSS，因为 TDesign Mobile 组件经过移动端适配和手势优化。
• 不引入其他组件库，因为混用会导致样式冲突、包体积膨胀和视觉不一致；不用 div / ul > li / window.confirm() 重复实现 TDesign 已有能力，因为重复实现会绕过 TDesign 的可访问性、手势支持和主题适配。
• 当前栈组件不存在或能力不足：已安装 tdesign-usage-guide 时查 ../tdesign-usage-guide/references/decisions/fallback-policy.md；未安装时优先换相似 TDesign 组件，再考虑原生 HTML + 最小 CSS，并在回复中说明这是非 TDesign 官方能力，建议补装 tdesign-usage-guide 获得完整降级策略。
• 路由交接：选型→tdesign-usage-guide、页面组合→tdesign-composition、图标→tdesign-icons、版本→tdesign-changelog；查完线索用 get-component-docs 返回的当前栈 API 落实写法。
• 完整 collection 模式下，详细职责表、跨栈隔离细则和强制约束可参考 ../tdesign-skills/references/constraints.md；未安装时按本文件内联规则执行。