TDesign React Web API

本 skill 只服务 tdesign-react。实现时使用 React Web JSX、React 事件、className / style 和 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-react，并查看已有代码的导入与写法。
2. 组件是否存在：已安装 tdesign-docs 时查 ../tdesign-docs/references/meta/stack-matrix-web.json 的 coverage.byStack.react；未安装 tdesign-docs 时，用 tdesign-mcp-server 的 get-component-list（framework:"react"）确认组件是否存在，不从记忆推断。
3. 具体组件 API：调用 tdesign-mcp-server 的 get-component-docs，传 framework: "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-changelog；对应 skill 未安装时跳过查询，不凭记忆编造版本或组合结论，建议补装对应 skill 获得准确结果，查完仍用 get-component-docs 返回的当前栈 API 落实写法。

React 写法边界

• 使用 JSX 和 React 组件导入，不套用 Vue 模板或小程序标签写法，因为跨范式混用会导致编译错误或运行时异常。
• 事件、受控字段、子组件和渲染函数以 tdesign-mcp-server 返回的当前栈 API 为准，因为不同栈的事件名和受控字段命名有差异。
• 不把 tdesign-vue-next、tdesign-vue、tdesign-mobile-react 的 API 当作 React Web API。
• 不凭经验编造 props、事件、插槽或函数式调用，应通过 tdesign-mcp-server 查 react 栈该组件的 API 确认。
• 不凭经验编造复合组件成员名；例如 Table 先查 columns、render 和相关类型，不要直接生成 TableColumn 或其他未在当前栈 API 中确认的导出名。
• 用户要求“怎么用”或“给个示例”时，先用 get-component-docs 拿当前组件 API 与 demo，必要时补读同栈 references/examples/ 最小示例，再组织代码；不要跳过 API 直接给经验写法。

约束

• 只按当前任务查询需要的单个组件，不一次性批量拉取整库 API，因为会浪费大量 token 且信息过载。
• 优先用 TDesign 组件和 props 解决问题，最后才补最小 CSS，因为 TDesign 组件经过跨端适配和可访问性测试。
• 不引入其他组件库，因为混用会导致样式冲突、包体积膨胀和视觉不一致；不用 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；未安装时按本文件内联规则执行。