maintain-v0-v1-component
Fix or maintain existing v0 (foundation-compose) or v1 (framework compose/compressible) components, including their platform variants. Classifies the generation first and loads only its recipe. Not for new components, agentic components, read-only reviews, or native-only changes.
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 1.4k
- Forks
- 179
01 前言 Front Matter
- name
- maintain-v0-v1-component
- license
- MIT
- description
- Fix or maintain existing v0 (foundation-compose) or v1 (framework compose/compressible) components, including their platform variants. Classifies the generation first and loads only its recipe. Not for new components, agentic components, read-only reviews, or native-only changes.
03 SKILL.md 正文
Maintain v0 and v1 components
v0 and v1 are maintenance-only (R-V0-001 and R-V1-001). A request for a new component uses the agentic authoring skill. A read-only review uses review-component.
Workflow
- Classify every surface the change touches with the
classification guide. Confirm the generation from
imports and structure, not directory names (R-CLASSIFY-001); Button contains both generations. A legacy public
entrypoint is not evidence of v0 or v1: native-core's
/legacywrappers use framework-base patterns and belong to the native component skill. - Load only the matching recipe: v0 or v1. Load both only when the change touches both generations.
- Add overlays only when the change triggers them:
- native root, registration, codegen, podspec, or native project: the native component skill checklist;
- focus, keyboard activation, or focus visuals: common focus authoring and its platform file;
- token values or theme behavior: design tokens and theming;
- FluentTester pages or E2E specs: legacy test apps.
- Read the component's existing tests, snapshots, platform variants, and any
SPEC.mdorMIGRATION.mdbefore editing. - Make the smallest change that fixes the problem. Preserve public props, types, exports and aliases, display names,
componentRef, token contracts, and native registration names (R-V0-002, R-V0-003, R-V1-002, R-V1-003). - Validate with the owning package's declared scripts (R-VALID-001), narrowest first (R-VALID-004):
yarn test <component>while iterating, then the package's build, test, and lint, plus the framework packages named in the recipe when framework semantics change. Review snapshot diffs before accepting them. Report each check's outcome (R-VALID-002), and finish with oneyarn clean-lage-cacheand thenyarn lage buildci(R-VALID-003). - Add a changeset for published packages (R-REPO-003).
Stop and confirm scope before migrating between frameworks, creating a component, or changing a public API. Those are separate tasks, not maintenance.
04 同仓库更多 Skills
review-component
Review component code or changes of any generation (v0, v1, agentic, primitive, or native-backed) without editing files. Classifies each changed surface, applies the matching checklists and native overlay, and reports evidence-backed findings with validation status.
maintain-desktop-testing
Change, review, or plan source changes to desktop-driver, desktop-test, storybook-desktop, or storybook-desktop-runtime, including native helpers. Applies package invariants, documentation, native and consumer validation, and changesets.
implement-native-component
Implement or change native components, TurboModules, native services, codegen specs, or native-backed platform wrappers (Swift, Objective-C, C++/WinRT, podspecs, Windows projects). Also supplies the native overlay checklist for v0, v1, and agentic work. Not for Storybook toolchain failures.
fix-security-issues
Audit and remediate dependency security advisories while respecting package age policy, removing unused vulnerable capabilities, deduplicating Yarn resolutions, and validating affected tooling.
desktop-testing
Configure, run, or troubleshoot native desktop tests using desktop-test, desktop-driver, and storybook-desktop, including app targets and suites, helpers, permissions, WDIO suites, Storybook story tests and smoke runs, reports, and CI. Not for package source changes or the Storybook app build toolchain.
agentic-storybook-development
Develop, bundle, build, or troubleshoot the agentic-components Storybook app in apps/storybook on macOS, Windows, or Win32, including app catalog configuration, Metro, CocoaPods, native projects, and renderer builds. Not for configuring or running desktop tests or changing desktop package source.