菜单
Use when promoting an F0 component from experimental/ to stable (Phases 4–5 of the lifecycle). Owned by Foundations team. For building a new component, use f0-component-contribution.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Audits AI configuration files (AGENTS.md, copilot-instructions.md, SKILL.md files) for instruction duplication. Load when modifying any AI config file, adding a new skill, or reviewing whether instructions have drifted out of sync.
Code review checklist for the F0 React component library. Use when reviewing PRs, auditing component code quality, or checking compliance with F0 conventions before merging. Covers component structure, TypeScript strictness, testing standards, styling, accessibility, and Storybook requirements.
Use when someone wants to add or change something in F0 (a component, prop, token, icon, or pattern). Covers the filter, the alignment, and the build in experimental/. You (the agent) are the door — you search, filter, and guide. For promotion to stable, use f0-component-promotion.
Detailed reference for F0 React component architecture, context/state, styling, testing, i18n, and animation patterns with code examples. Load when building or modifying components in the F0 design system.
Guide for migrating components from experimental to stable locations (components/, sds/, ui/). Trigger when the user wants to migrate, promote, or move an experimental component, or asks about deprecating experimental exports.
Create pull requests for the F0 design system monorepo using gh CLI. Use when opening a PR from the f0 repo — handles title format, PR body mapped to PULL_REQUEST_TEMPLATE.md, conventional commit change list, and interactive clarification for missing context.
| name | f0-component-promotion |
| description | Use when promoting an F0 component from experimental/ to stable (Phases 4–5 of the lifecycle). Owned by Foundations team. For building a new component, use f0-component-contribution. |
This skill guides Foundations team members through validating that an experimental component meets the maturity criteria and promoting it to stable. The full contract is in packages/react/docs/definition-of-done.mdx Phases 4–5.
Who can run this skill: members of
@factorialco/foundations. Other contributors can request promotion in#f0-support, but only Foundations executes the move.
The component owner (or a Foundations engineer) starts a promotion request in #f0-support and proves all DoD criteria are met.
Run a cross-repo search across the factorialco GitHub org. Use GitHub code search (not local rg):
org:factorialco "F0MyComponent" -repo:factorialco/f0
Required: ≥3 distinct product teams import or use the component in production code (not tests, not docs, not examples).
Document the findings in the #f0-support promotion thread with links.
Also check: no "would you remove this?" or "this should be deprecated" feedback in the last 30 days (search the component name in #f0-support).
Verify all four:
No breaking changes for ≥60 days. Run:
git log --since="60 days ago" --oneline -- packages/react/src/experimental/<Category>/F0Name/
Inspect any commits touching types.ts, prop signatures, or default values.
Zero open critical or high-severity bugs. Search #f0-support (and any bug tracker) for the component name; check severity.
f0-quality-gate passes including extended subagent reviews. Load and run f0-quality-gate with full subagent suite (a11y, design tokens, dark mode).
Owner declares API stable in the #f0-support promotion thread (explicit message).
A Foundations team member explicitly approves promotion in the #f0-support promotion thread. There is no auto-promotion.
If any axis fails, the promotion is deferred with a documented explanation in the thread.
| If the component is… | Move to… |
|---|---|
| A primitive (Button, Input) | src/components/ |
| A composition (Page header) | src/patterns/ |
| A vertical bundle | src/kits/ |
| A layout primitive | src/layout/ |
| A hook | src/hooks/ |
For Domain specific components in src/sds/<area>/, promotion stays inside the domain folder and ownership stays with the domain team — only the story tag changes (experimental → stable). Foundations does not take ownership of Domain specific components.
Load f0-experimental-component-migration and follow it end-to-end. It handles file moves, import updates, removing the experimentalComponent() wrapper, and ensuring exports.ts is correct.
Change tag from experimental to stable:
tags: ["autodocs", "stable"]
Story title stays the same (no rename).
Load factorial-f0-component-documentation. Required for stable: Good tier minimum (Gold encouraged).
Transfer ownership to Foundations. Add a line to CODEOWNERS:
packages/react/src/components/F0Name/ @factorialco/foundations
(Or update an existing wildcard line if one already covers the destination.)
Load f0-quality-gate and run the full workflow on the promoted component.
Load f0-pr.
PR title: feat(F0Name): promote to stable
The promotion is not a breaking change for consumers — the public import path doesn't change and the API was already stable de facto during Phase 4. So we use plain feat: (which the release pipeline interprets as a MINOR bump) without the ! marker. Using feat!: would trigger an unintended MAJOR version bump in Conventional Commits / semantic-release. PR body:
#f0-support promotion thread.After merge:
#f0-support Slack with a short changelog entry.Stable badge in the Component Status table on next nightly regeneration.An F0 designer + Foundations engineer respond to promotion requests based on team availability and as quickly as possible — we don't commit to a fixed SLA today, as it depends on team size and current focus. For urgent or blocking cases, ping #f0-support in Slack.
rg only checks the design-system repo, which has zero product consumers. Always use GitHub code search across factorialco.CODEOWNERS — the original team will keep getting bug pings.experimentalComponent() wrapper — consumers will see the warning forever."Components/F0Name", do not rename.