开发测试 33.3k 仓库 Star
Vercel Composition Patterns
让复杂组件更容易组合和维护
这套组件组合规范用于改进 React 组件的组织方式。它关注大量开关参数、重复结构和不清晰的状态归属,通过组合子组件、共享上下文与明确接口,让同一套结构支持不同页面。适合重构逐渐复杂的组件库,或在增加新变体前整理已有设计。
你需要准备:React 组件代码、需要保留的行为和当前遇到的复用问题
一桉AI 整理 · 更新 · 查看 GitHub 来源
粘贴到 Codex,它会先检查安装条件,再引导你使用。
Vercel Composition Patterns 能帮你做什么?
识别组件职责混杂
查看多个布尔参数和条件分支是否形成难以理解的组合,找出需要独立表达的结构与行为。
整理状态与组合接口
确定状态应放在哪一层,通过复合组件和 Context 等方式,让使用者按需要组合界面。
核对版本与既有行为
保留原有功能约定,按项目版本选择规则,并通过相关测试和页面检查确认重构影响。
什么时候适合用?
下面是用法示例,可换成你的材料和目标。
表单组件变体过多
例如一个输入框同时处理标签、提示、校验和不同布局时,拆出明确子组件让调用方式更直观。
多个页面重复搭组件
例如编辑器在不同页面只改变按钮和状态来源,整理共享结构与注入方式以减少复制。
怎么开始使用?
组件代码与复用问题
准备这些材料React 组件架构整理
React 组件代码、需要保留的行为和当前遇到的复用问题
组件架构整理流程
- 01
检查参数与状态归属
- 02
设计可组合的组件接口
- 03
核对行为与相关检查
准备什么,会得到什么?
- 准备的材料
- React 组件代码、需要保留的行为和当前遇到的复用问题
- 交付的结果
- 组件职责、状态归属和对外接口的改进方案。
- 实施后的重构代码,以及行为保持和相关检查说明。
使用前要知道
需要 React 源码并保留配套 rules、AGENTS.md。部分指导涉及 React 19,旧版本需检查适用性;组件结构更清楚也不自动等于页面性能提升。
常见问题
和 React Best Practices 重复吗?
本项主要整理组件结构、接口和复用方式;React Best Practices 更多关注请求、渲染与包体积。可按当前问题选择相应规则。
React 18 项目也能参考吗?
组合方式中的通用原则仍可参考,但涉及新 API 的建议不能照搬。应先核对 React 版本,再保持现有行为和兼容要求。
GitHub 与官方参考
依据项目说明与参考文档整理。页面中的任务与流程示例用于说明用法。
- vercel-composition-patterns · SKILL.md ↗2026-10-31 核对
来源与使用条件
- 原始项目
- vercel-labs/agent-skills ↗
- Skill 名称
vercel-composition-patterns- Skill 目录
skills/composition-patterns- 仓库 Star
- 33,285 · 2026-10-31 核对,仅代表仓库关注度。
- 许可说明
- MIT
- 使用条件
- 需要 React 项目和相关组件源码,保留配套 rules 与 AGENTS.md。部分规则针对 React 19 API,应用前需核对项目版本及既有测试。
- 注意事项
- Vercel 安装器支持 Codex。真实 Skill 名称是 vercel-composition-patterns,目录为 composition-patterns;与 React 性能检查关注点不同,本站未运行实测。
查看安装与使用提示词
请帮我准备并使用 Vercel Composition Patterns Skill,完成下面的任务。请实际执行当前环境允许的安装与检查,不要只返回一份安装教程。 【来源与目标】 原始仓库:https://github.com/vercel-labs/agent-skills 所选目录:skills/composition-patterns 参考分支:main 原始目录 frontmatter name:vercel-composition-patterns 安装后的目标调用名:vercel-composition-patterns 来源页面:https://github.com/vercel-labs/agent-skills/tree/main/skills/composition-patterns 安装路线核对日期:2026-11-01 vercel-composition-patterns:当前源 SKILL.md:https://github.com/vercel-labs/agent-skills/blob/main/skills/composition-patterns/SKILL.md vercel-labs/agent-skills:当前安装说明:https://github.com/vercel-labs/agent-skills/blob/main/README.md OpenAI:Build skills(Skill目录、发现和插件):https://learn.chatgpt.com/docs/build-skills 【先检查环境,再安装】 先识别操作系统、当前 shell、工作目录、同名 Skill 和已有工具;命令须适配实际平台并正确处理带空格的路径。默认安装到当前项目的 .agents/skills;如果没有可用项目目录,再使用用户目录的 .agents/skills。遵循当前 Codex 实际支持的位置;上游 CLI 或插件有专用目录时使用其正式方案。检查现有安装来源与完整性,能复用就复用,不重复注册相同来源、不覆盖用户修改。系统内置与所选第三方来源同名时保留系统版,明确区分来源和实际目录,不能只凭名称认定装过或选对了。 下文 ~/.agents/skills 是用户级路径示例;已选项目范围时,使用项目的 .agents/skills 并保持相同子目录层级。<SKILL_DIR>、<项目根目录> 等占位符须先换成核对过的真实路径再执行。依赖仓库的存放目录与 Codex 发现入口分别处理,不把缓存目录当作已注册入口。 这是完整目录安装路线。优先使用当前 Codex 自带的 $skill-installer,明确传入仓库 vercel-labs/agent-skills、目录 skills/composition-patterns、分支 main、安装名 vercel-composition-patterns,并把 --dest 设为已解析的目标 .agents/skills 绝对路径。目录为“.”时表示仓库根目录,仍要传入安装名。不要猜测安装器在本机的固定路径。如果没有内置安装器,按下列项目说明从原仓库获取完整目录,保留全部配套文件。 所选 Skill 的具体安装步骤: 1. 先定位用户要使用的项目根目录,并检查项目与用户目录中是否已有同名 Skill;发现已有版本先比较来源和内容,不覆盖,也不删除系统或插件缓存。 2. 调用系统 skill-installer 的 scripts/install-skill-from-github.py,参数明确为 --repo vercel-labs/agent-skills --path skills/composition-patterns --ref main --name vercel-composition-patterns --dest <项目根目录>/.agents/skills。--dest 是所有 Skill 的父目录,不是 SKILL.md 文件路径。 3. 安装整个所选目录,保留以下 resources 列出的脚本、参考资料和资产;检查相对路径引用,不只下载一份 SKILL.md。 4. 在该项目中查看 Skill 列表,并用 $vercel-composition-patterns 显式选择;Codex 会自动检测目录变化,尚未出现时再开新聊天或重新加载。 必须保留的资源: - skills/composition-patterns/(SKILL.md、AGENTS.md、README.md、metadata.json 与 rules/) 已知依赖:需要 React 项目和相关组件源码,保留配套 rules 与 AGENTS.md。部分规则针对 React 19 API,应用前需核对项目版本及既有测试。 原项目许可:MIT 特别条件:Vercel 安装器支持 Codex。真实 Skill 名称是 vercel-composition-patterns,目录为 composition-patterns;与 React 性能检查关注点不同,本站未运行实测。 需要账号、密钥或服务时先检查现有可用连接;让用户在官方授权或本地配置入口完成,不要求把密钥粘贴到聊天。缺少付费服务或不支持的客户端能力时,明确剩余条件与可完成的范围。 【安装后验收】 读取实际安装位置的 SKILL.md,核对真实 name,并检查它引用的脚本、模板、共享文件与工具是否存在。若上游已迁移路径或更名,先核对正式说明再调整;找不到则报告实际错误,不猜路径或宣称成功。 1. 核对 name=vercel-composition-patterns,AGENTS.md、metadata.json 和 rules/ 存在。 2. 只读 package.json 判断 React 版本及组件现状,不为安装检查运行应用或升级 React。 Codex 通常自动发现变更;只有未出现时才引导新建聊天或重载。若本轮尚未出现在可用列表,可在允许的范围内读取已安装的完整文件继续准备任务,同时说明自动识别尚待确认。插件依赖的工具未连接时,不能用读取文件代替连接成功。 分别报告“文件已安装”“Codex 已识别”“任务所需能力已就绪”的实际状态和证据;失败时给出卡住的步骤、错误与下一步,不反复执行相同的失败命令。 【接着引导我使用】 请使用实际可用的 $vercel-composition-patterns;若实际名称发生变化,以刚核对的本地 name 为准。存在不同来源同名项时,明确选择所选来源与实际文件路径,避免调用成系统版或另一版本。对于必须由用户显式调用的 Skill,直接给我下一条可复制的调用语句。 - 提供膨胀的组件、过多布尔参数或重复交互实例,让 Skill 先指出职责与组合边界。 - 再选择组合组件、显式变体或状态接口等方案;React 19 特定建议只在版本匹配时使用,并按项目检查验证行为。 我想完成的任务: 检查我指定的 React 组件,重点处理大量布尔参数、重复结构和不清晰的状态归属。根据项目版本提出组合方式,说明接口如何变化;实施时保持已约定的行为,并运行现有相关检查,不为套用模式而扩大重构范围。 需要我提供的材料: React 组件代码、需要保留的行为和当前遇到的复用问题 期望得到: 组件结构与接口改进方案;实施时附代码变更、兼容性说明和检查结果。 先查看我在当前聊天中已经提供的目标与材料,只问缺少的关键内容;没有材料时,告诉我第一步提供什么,可给一个简短示例。条件满足后从一个小任务开始,检查输出,再说明怎样继续使用。示例仅用于演示,不充当我的真实数据;没有执行过的步骤、测试或交付物不要写成已经完成。需要发送、发布或修改外部账号内容时,先让我核对具体对象和内容。