react-components
GitHub指导在 React 项目中正确导入和使用 UI 组件,区分 CoreAI 包与本地适配器的边界,强调查阅官方文档而非依赖默认行为,确保语义化使用链接和按钮。
Trigger Scenarios
Install
npx skills add github/replica --skill react-components -g -y
SKILL.md
Frontmatter
{
"name": "react-components",
"description": "CoreAI Sandbox component usage: import boundaries, published CoreAI documentation, and local adapter inspection. USE WHEN: editing any `*.tsx` file, picking a component, or writing component imports."
}
CoreAI Sandbox Component Usage
Import Boundary
Import CoreAI components, styling APIs, and tokens directly from
@coreai-ds/react-components.
import { Button, Dropdown, Spinner } from '@coreai-ds/react-components';
Import CoreAI-Sandbox-owned components and adapters from ~/components/common.
import { Card, ExternalLink, Image, Link, TabLinkList } from '~/components/common';
The app barrel exports only repository-owned behavior. It does not re-export CoreAI. Never import
components from @fluentui/react-components directly. Direct imports from
@fluentui/react-icons remain supported.
Use the local Link for React Router navigation, ExternalLink for external URLs, Card for all
cards, and Image for theme-aware and deployment-safe image sources. ESLint restricts direct
Link, Card, and Image imports from @coreai-ds/react-components; only the local adapter
implementations may import those underlying CoreAI components.
Skill Boundary
- This skill owns CoreAI Sandbox's repository boundary: decide whether the need is satisfied by CoreAI or by an existing app-owned adapter, composition, hook, theme utility, or asset.
coreai-ds-fluentui-reactowns external package documentation retrieval and version checks. Invoke it for every CoreAI component or prop decision instead of restating its catalog here.- Local source under
app/components/common/**is authoritative only for CoreAI-Sandbox-owned behavior; it is not a substitute for CoreAI documentation.
Choose and Verify Components
- Invoke the
coreai-ds-fluentui-reactskill and retrieve the relevant published documentation before selecting, changing, or reviewing a component or its props. Follow its discovery, version-check, and retrieval-failure workflow. Do not infer APIs from stock Fluent behavior. - Verify the selected API against the installed package when documented versions differ. Report missing guidance or unsupported APIs rather than silently substituting prior knowledge.
- Check
app/components/common/index.tsfor an existing CoreAI-Sandbox-owned export only when the requested behavior is product-specific or integrates an app concern such as React Router. - When a local export exists, read its source under
app/components/common/**before using it. Published package documentation does not define CoreAI-Sandbox-owned behavior. - Prefer an existing documented component or template over recreating the same interaction with custom markup and CSS.
Do not maintain a static component catalog in this skill. Published CoreAI documentation is the source of truth for CoreAI components, and the app barrel and local source are the source of truth for repository-owned exports.
Semantics
Use links for navigation and buttons for actions. Do not make a Button navigate
or use a link to perform an action. Use Link for app routes and ExternalLink for URLs outside
the app.
Related skills
css-styling— required when writing styles for the componenticons— for icon selection and bundlingcoreai-ds-fluentui-react— required for CoreAI component documentation and API decisions
Version History
- f19c050 Current 2026-11-07 08:51


