React Native 约定索引是技能库的“前门”：每个任务都从这里开始。其核心用途是把一项 React Native 或 Expo 任务映射到需要加载的技能集合，再按固定流程完成、验证并报告。
用途与定位 索引由技能库目录和每个技能的描述生成，任务表与意图映射帮助开发者确定某项工作应加载哪些技能。它本身不替代具体技能，而是负责分派：匹配任务行、加载行内全部技能（第一个为主技能）、按构建顺序放置工作、以各技能的完成定义取证并汇报。
主要能力
- 任务表：列出常见任务及其应加载的技能，如从空仓库引导新 Expo 应用、添加带逻辑与数据的屏幕功能、构建或修改屏幕与对话框、新增共享组件、修改主题与暗色模式、处理加载/空/失败/离线状态、表单与校验、动画、可见文案与翻译、路由与返回、根布局与冷启动、设置开关、状态存储、API 调用与服务端状态、持久化与迁移、错误处理、隐私声明、依赖管理、质量门禁排错、TypeScript/ESLint/Prettier 修复、文件与目录放置、故障排查、测试编写、设计一致性验证、TestFlight 与 Google Play 发布、提交与报告、需求溯源。
- 行规则：包括 test-first（涉及产品代码的改动须测试先行并接入 tdd-workflow）、ui-verification（UI 变更须同时加载 i18n-strings-and-catalogs、rtl-and-direction、accessibility-as-code 和 design-visual-parity）、以及提交或报告类任务加载 git-commits-and-reporting。
- 构建顺序（references/build-orders.md）：覆盖新应用、新功能、发布、在既有应用采用技能、新游戏等场景，每一步列出要复制、合并、安装和生成的内容，并且只有下一层通过检查后才能进入上一层。
- 索引精确性：技能新增、删除、重命名、描述变更或目录变更后，需运行 build-index.mjs --write 再运行 check-index.mjs；生成部分不得手工编辑。
使用方式
- 匹配任务：在任务表或 references/task-matrix.md 中找对应行；若任务含需求 ID（如 REQ-4、SCR-2），加入 spec-traceability；若含错误信息，加入 troubleshooting-playbook。无匹配行时读 references/intent-map.md，加载所有“Use when”匹配的技能，不得凭技能名猜测内容。
- 加载技能：以主技能为先，先阅读各技能的 Rules 和 Definition of done；references/loading-and-reporting.md 说明在 Claude Code 插件（react-native:<skill>）、独立安装、通过 AGENTS.md 的其他代理以及开发者“Skills:”行下的加载方式。
- 放置工作：在 references/build-orders.md 中找到当前步骤，不得在前置步骤通过前开始；按步骤清单复制、合并、安装；按“done when”命令原样运行，参数顺序为仓库根目录在前，不使用 --root。
- 按主技能工作流实施，测试先行，其余已加载技能的规则作用于各自负责部分。
- 取证：运行每个已加载技能的完成定义检查及 npm run -s check:fast，修复所有 FAIL 并重跑，直至每个检查打印 RESULT: PASS；SKIP 与 NOT APPLICABLE 视为通过，exit 2 不算通过。
- 报告：结论先行，列出所用技能、复制的 RESULT 行、未验证内容、不阻塞的人工检查，最多提出一个问题并给出默认答案；格式由 git-commits-and-reporting 负责。
完成定义 匹配行的所有技能和开发者点名的技能均在工作前加载；各技能检查打印 RESULT: PASS 且 check:fast 通过；构建工作遵循构建顺序；报告写明所用技能、RESULT 行和未验证内容；技能集或目录变更后重新生成索引且不手改生成内容；check-index.mjs 在库模式和安装模式下分别打印相应结果。
适用场景与限制 适用于开始或规划 React Native/Expo 任务、需要确定加载哪些技能并按顺序构建的场合。限制在于：它依赖技能库目录与各技能描述保持同步，索引过期会把任务路由到已不存在的技能；不能从技能名推断内容；它规定流程与验证方式，但不替代各具体技能的实施细节；资料未说明其收费、价格或平台支持范围。