speclite-react-project-context-and-review

Speclite React Project Context And Review

[Overview（技能说明）] Speclite React Project Context And Review 是 ecosystem-frontend-react module 的前端生态分析工作流。它面向已经选择 React ecosystem module 的目标项目，用代码事实、lockfile、配置文件、测试文件、官方文档或用户资料建立 React 项目上下文，并输出组件架构、state、routing、testing、accessibility、build 和 migration review 结论。

[Core Capabilities（核心能力）] - 项目事实发现：读取 package.json、workspace 配置、lockfile、TypeScript / bundler / test 配置和源码入口，确认 React project 边界。 - 版本证据提取：React、React DOM、router、state library、test runner 和 build tool 版本必须来自 lockfile、package manager output、官方 docs 或用户提供资料。 - 组件架构审查：识别页面、route、feature、shared component、hook、context、server/client boundary 和 design-system usage。 - 状态与数据流审查：整理 local state、Context、Redux、Zustand、TanStack Query、Relay、Apollo 或其它状态/数据工具的实际使用证据。 - 路由与构建审查：基于证据分析 React Router、Next.js、Remix、Vite、Webpack、Turbopack 或 monorepo build wiring，不从依赖名臆测 runtime 行为。 - 测试与可访问性审查：检查 unit/component/e2e 测试、Testing Library、Vitest/Jest/Playwright/Cypress、ARIA 和 keyboard/focus 证据。 - 迁移风险记录：对 React major upgrade、router migration、state consolidation 或 framework migration 给出 evidence-linked risk list。

[Workflow（执行流程）] 详细步骤见 references/react-project-context-and-review-workflow.md。

1. 确认 `{project-root}` 与输出位置；若用户未给输出目录，先询问。
2. 收集 React evidence：manifest、lockfile、package manager output、framework config、source entry、test config、CI 和用户资料。
3. 只记录可验证事实。框架版本、API 语义和迁移建议不得来自记忆或猜测；缺证据时写入 `Unknowns（未知项）`。
4. 分析组件/route/state/testing/build/accessibility/migration 维度，并给出文件路径级证据。
5. 输出 Markdown review note 到用户指定位置，默认建议 `{project_knowledge}/frontend/react-project-context-and-review.md`。

[Notes（注意事项）] - 本 Skill 只处理 React-specific 前端项目事实；通用 UX、PRD、Architecture、Story creation 和 Code Review 仍属于 sdlc workflow。 - 不要硬编码 React、React Router、Next.js、Vite 或测试框架的最新版本；必须从目标项目文件、lockfile、官方 docs 或用户资料取证。 - SpecLite 仍是 CLI + filesystem control plane；本 Skill 不创建 Web UI、dashboard、browser runtime 或 GUI product scope。 - 如果项目同时包含 Vue、Angular、Svelte 或 backend services，只分析与 React evidence 直接相关的范围，并把其它生态写为 out-of-scope。