用途:这是 gluestack-ui 的提交前 PR 检查清单技能,帮助贡献者在创建 PR 之前完整审查自己的改动,降低被退回的风险。
主要能力(按阶段组织):
- 识别改动:用 git status 与 git diff 检查修改文件,确认只改了源文件、无生成文件、无意外改动或调试代码。
- 代码质量:检查 console.log、注释代码、TODO、未使用导入与变量、命名、重复代码、错误处理、硬编码值;TypeScript 要求类型明确、避免 any、类型导出,并用 yarn tsc --noEmit 校验;代码风格使用 Prettier。
- 组件结构:复合组件模式、React.forwardRef、Props 接口导出、displayName、子组件与样式上下文(withStyleContext/useStyleContext)、导出方式与命名导出。
- 样式:NativeWind/Tailwind 使用 className、styles.tsx 与 tva() 定义变体,含响应式与暗色模式一致性。
- 无障碍:ARIA 属性、键盘导航、屏幕阅读器、语义化标签。
- 文档:docs/index.mdx、前置元数据、安装步骤、API 属性表、示例与 meta.json/template.handlebars、sidebar.json。
- 测试:在 kitchen-sink 应用中于 iOS、Android、Web 多浏览器手动测试,覆盖变体、边界情况、性能与回归。
- 依赖:dependencies.json、packages/gluestack-ui/src/dependencies.ts、版本约束与本地链接解除。
- Git:仅提交源文件、遵循约定式提交格式、原子提交与分支规范。
- 构建:yarn build 与 yarn tsc --noEmit 确认无错误无警告。
- 最终审查与创建 PR:核对 CONTRIBUTING.md,使用 PR 标题与描述模板,执行 git push origin [branch-name],在 GitHub 创建 PR 并请求评审。
使用方式:作为技能在提交前逐阶段运行,按检查点逐项确认。
适用场景:为 gluestack-ui 提交组件、增强或修复的贡献者。
限制:资料为检查清单与流程指引,未提供具体自动化脚本、收费或平台支持信息。