Agent Skills
› videojs/video.js
videojs/video.js
GitHub指导修改SPF播放引擎行为，涵盖更新、重构、拆分或合并职责。通过标准化工作流确保状态、生命周期及测试的正确性，并执行相关构建与测试命令。
安装全部 Skills
npx skills add videojs/video.js --all -g -y
集合内 Skills (38)
指导修改SPF播放引擎行为，涵盖更新、重构、拆分或合并职责。通过标准化工作流确保状态、生命周期及测试的正确性，并执行相关构建与测试命令。
需要更新或重构SPF行为逻辑
拆分或合并SPF职责与信号处理
npx skills add videojs/video.js --skill change-spf-behavior -g -y
自动化执行代码提交、推送及创建或更新 Pull Request 的流程。确保变更符合规范，智能选择范围，构建完整 PR 描述并报告结果，适用于需要发布或准备合并请求的场景。
用户明确要求提交代码并推送
用户要求创建或更新 Pull Request
npx skills add videojs/video.js --skill commit-pr -g -y
配置 Vite+ 工作流，涵盖构建、打包、任务编排及缓存管理。指导如何定义任务依赖、保持构建边界、优化本地与 CI/CD 缓存策略，并处理 GitHub Actions 集成中的注意事项。
需要配置 Vite 构建或打包流程
设置 Vite+ 任务依赖和缓存
优化 CI/CD 中的 Vite 构建性能
npx skills add videojs/video.js --skill configure-vite-plus -g -y
用于创建或修改 Video.js 自定义 HTML UI 组件，涵盖属性、事件、控制器、样式钩子及生命周期管理。指导如何定义契约、组织代码结构、实现响应式更新及注册流程，确保组件的可复用性与测试覆盖。
创建新的 Video.js UI 组件
修改现有 HTML 组件的属性和事件
调整组件的生命周期逻辑
npx skills add videojs/video.js --skill create-html-component -g -y
自动化创建或起草 GitHub Issue，支持 Bug、功能及任务类型。通过收集信息、查重、验证依赖关系并生成结构化草稿，利用 gh CLI 创建 Issue 及其层级与阻塞关系，确保问题聚焦且可追踪。
需要提交 Bug 报告
需要创建新功能提案
需要建立任务或 Epic 的父子/依赖关系
npx skills add videojs/video.js --skill create-issue -g -y
指导创建和修改 Video.js React UI 组件，涵盖状态管理、API 设计、样式钩子及测试规范，确保组件符合核心契约与渲染最佳实践。
创建新的 Video.js React 组件
修改现有 Video.js React 组件结构或逻辑
npx skills add videojs/video.js --skill create-react-component -g -y
用于创建可复用的 Agent 技能，通过规范化的流程定义触发条件、核心逻辑及验证方式，以增强自动化工作流的标准化和可维护性。
需要为重复性工作流创建新的 Agent 技能
对现有技能进行扩展或合并以避免冗余
npx skills add videojs/video.js --skill create-skill -g -y
用于创建或提取 SPF 播放引擎的原子行为，涵盖信号、生命周期及测试定义。适用于新增具备独立职责的行为模块，确保可测试性与边界清晰，并执行相关验证。
需要创建新的 SPF 行为
将功能拆分为独立的原子行为
npx skills add videojs/video.js --skill create-spf-behavior -g -y
用于设计 Video.js TypeScript API，涵盖公共接口、类型推断、状态管理及扩展点等，旨在优化开发者体验与代码质量。
设计新的 TypeScript API 接口
优化现有 API 的类型安全性与推断能力
评估 API 的可组合性与扩展性
npx skills add videojs/video.js --skill design-api -g -y
用于记录SPF功能特性的文档，明确能力范围、状态及证据。在用户请求时整理并更新特性条目，区分已实现与未来工作，确保事实准确且引用源码路径。
用户明确要求编写或修订功能特性文档
查询功能的能力范围、关系、状态或约束
npx skills add videojs/video.js --skill document-spf-feature -g -y
用于记录SPF用例，明确交付场景、功能组成、状态及验证信息。在用户明确要求时创建或修订条目，区分现状与计划，更新关联项并标记缺失要素。
用户要求记录交付场景
用户要求记录功能变体
用户要求确认关系或状态
用户要求进行验证
npx skills add videojs/video.js --skill document-spf-use-case -g -y
实现符合无障碍标准的 Video.js UI，涵盖语义化、ARIA、键盘交互、焦点管理及屏幕阅读器支持，确保遵循最佳实践并验证兼容性。
需要实现或修复前端组件的无障碍访问功能
涉及 ARIA 属性、键盘导航或焦点管理的开发任务
npx skills add videojs/video.js --skill implement-accessible-ui -g -y
依据工作流规范，将SPF功能条目转化为最小可验证增量。通过编写失败测试、分层实现及运行测试验证，更新注册表状态并报告实施进度与风险。
需要实现新的引擎能力或功能特性
需要将功能规划转化为代码实现和测试
npx skills add videojs/video.js --skill implement-spf-feature -g -y
实现SPF用例组合，涵盖功能变体集成、测试验证及状态更新。需先读取工作流文档，按规范拆解任务，测试驱动开发各组件边界，执行累计检查并报告进度与风险。
需要组合多个功能变体的交付场景
涉及新功能或适配器的集成与测试
npx skills add videojs/video.js --skill implement-spf-use-case -g -y
指导实现UI过渡动画，涵盖生命周期管理、取消处理及HTML/React框架适配。确保CSS控制动效，保持状态一致性并处理竞态条件与无障碍模式。
实现UI组件的进入或退出动画
修复UI过渡中的状态不同步问题
适配HTML或React框架的过渡逻辑
npx skills add videojs/video.js --skill implement-ui-transition -g -y
用于在不修改代码的前提下调查 GitHub Issue，通过收集证据分析根因并制定实施计划。
用户要求调查或诊断 Issue
需要生成基于证据的实施计划
npx skills add videojs/video.js --skill investigate-issue -g -y
维护仓库 Agent 文档，处理 AGENTS.md 兼容性、技能漂移及重复指令。通过更新源指针、移除过时指南和运行工作区检查来优化上下文预算，确保文档与可执行源码一致。
需要清理重复或过时的 Agent 指导内容
检查 AGENTS.md 与 CLAUDE.md 的兼容性及技能漂移
优化上下文预算或修复路由逻辑
npx skills add videojs/video.js --skill maintain-agent-docs -g -y
提供测试维护技能，涵盖编写、审查和清理测试用例。通过作者门控、审计扫描和活动式修剪三种模式，确保测试保护可观测行为，避免冗余和实现耦合，提升代码置信度。
编写新测试或修改现有测试时
审查或清理测试代码时
npx skills add videojs/video.js --skill maintain-tests -g -y
用于维护 VJSC 皮肤功能差异清单，当在 skins 包中发现或处理行为、样式等可见差异时，同步更新 gaps.md 以记录或关闭差异。
发现皮肤行为、样式或标记的差异
实现或故意推迟差异修复
npx skills add videojs/video.js --skill maintain-vjsc-skin-gaps -g -y
用于审查视频播放器UI无障碍性，不修改代码。检查语义、ARIA、键盘交互、焦点管理、字幕及对比度等，依据WCAG标准报告可观察到的障碍与修复建议。
需要评估界面无障碍合规性
审查特定组件的键盘和屏幕阅读器支持
npx skills add videojs/video.js --skill review-accessibility -g -y
用于审查 TypeScript API 的设计、兼容性、类型推断及架构合理性，不修改代码。通过检查公开接口、调用方和测试，评估运行时行为与维护成本，输出按严重程度排序的具体改进建议。
审查新提出的 API 设计
评估现有接口的兼容性与维护成本
进行架构或类型推断审计
npx skills add videojs/video.js --skill review-api -g -y
用于对代码分支进行非侵入式审查，评估 PR 风格发现、回归风险及合并前质量。通过对比差异、检查上下文和验证候选问题，输出按严重性排序的可操作发现，辅助决策是否合并。
需要执行 PR 风格审查时
评估分支合并前的回归或安全风险时
npx skills add videojs/video.js --skill review-branch -g -y
用于审查 Video.js 文档的准确性、结构、语气及 MDX 规范，不直接编辑。通过验证声明与代码一致性，识别内容错配并报告修复建议，确保读者体验和文档质量。
审查文档准确性
检查文档结构与规范
npx skills add videojs/video.js --skill review-docs -g -y
审查 HTML 组件设计，评估边界、API、可复用性、生命周期及无障碍访问。通过追踪数据流和 bundle 成本，确保组件符合最佳实践并最小化变更。
审查 HTML 组件设计方案
评估 Web Component API 与边界
npx skills add videojs/video.js --skill review-html-component-design -g -y
用于审查自定义 HTML Web Components，检查数据流、DOM 生命周期、职责边界、注册机制及可访问性，确保符合 ReactiveElement 规范并识别耦合与状态问题。
审查新的 Web Component 实现
检查组件的 DOM 操作合规性
评估组件的职责划分与注册逻辑
npx skills add videojs/video.js --skill review-html-component -g -y
审查React组件设计，评估边界、API、可重用性及打包成本。检查数据流、无障碍、SSR约束及树摇优化，确保架构合理与性能最优。
审查React组件设计提案
评估组件API复杂度与包体积
npx skills add videojs/video.js --skill review-react-component-design -g -y
审查React组件实现，检查数据流、状态同步、DOM操作合规性、API设计、依赖树摇及SSR/无障碍等，输出分级问题报告。
需要审查React UI组件代码质量时
评估组件边界、依赖或性能隐患时
npx skills add videojs/video.js --skill review-react-component -g -y
用于生成 Video.js API 参考文档，涵盖组件、钩子及工具函数。通过读取源码和测试规范，利用构建器生成 JSON 并编写 MDX 页面，确保元数据准确且符合框架兼容性要求。
需要为 Video.js 组件或 API 编写参考文档
更新或创建基于 JSDoc 的 API 说明页面
npx skills add videojs/video.js --skill write-api-reference -g -y
用于根据用户明确请求撰写或更新 Video.js 架构、功能或决策记录。通过阅读代码和现有文档，提炼非显而易见的rationale，生成简洁的设计文档。
用户明确要求创建设计文档
用户明确要求修订决策记录
npx skills add videojs/video.js --skill write-design-doc -g -y
负责编写 Video.js 各类文档，包括指南、概念页、README 及 JSDoc。依据 Diataxis 框架区分内容形态，遵循特定写作风格与结构规范，确保文档准确性、SEO 优化及版本重定向处理。
需要撰写或更新项目文档
生成 API 参考说明或安装指南
维护技术博客或概念性文章
npx skills add videojs/video.js --skill write-docs -g -y
用于撰写 HTML 组件设计记录，需用户明确请求。通过分析代码、测试及元数据，提炼非代码可解释的设计 rationale、边界及约束，保持简洁并链接源码，不生成 React 契约。
用户明确要求编写 HTML 组件设计文档
需要梳理前端 UI 组件的设计决策与约束
npx skills add videojs/video.js --skill write-html-component-design -g -y
用于翻译或审计 Video.js 本地化包中的值，确保翻译准确、有据可查且符合无障碍标准。
新键需要填充值
英文源文件更新导致旧翻译失效
需要对现有本地化包进行审计
npx skills add videojs/video.js --skill write-locale-translations -g -y
根据用户明确请求，编写React组件设计记录。通过阅读相关代码、测试和文档，提炼组件边界、约束及非显而易见的设计 rationale，生成简洁的决策文档并链接源码。
用户明确要求编写React组件设计记录
提供组件路径或UI记录位置
npx skills add videojs/video.js --skill write-react-component-design -g -y
用于起草或修订 Video.js RFC，涵盖公共 API、产品方向及架构提案。通过验证必要性、分析现状与约束、对比替代方案，生成旨在获取团队共识的正式提案文档。
需要为公共 API 变更撰写提案
制定影响广泛的产品或架构方向
发起需要团队共识的重大技术决策
npx skills add videojs/video.js --skill write-rfc -g -y
指导创建 Rolldown 插件的实现规范，涵盖钩子选择、模块处理、虚拟模块管理及源码映射配置，确保与构建流程兼容。
需要编写 Rolldown 插件
实现构建钩子逻辑
npx skills add videojs/video.js --skill create-rolldown-plugin -g -y
指导创建 Vite 插件，涵盖 Hook 分类、环境配置、路径处理及构建测试。用于实现符合 Vite 和 Rolldown 规范的插件开发。
需要创建 Vite 插件
编写 Vite Hook 逻辑
配置 Vite 构建选项
npx skills add videojs/video.js --skill create-vite-plugin -g -y
用于创建 VJSC 组件模块，规范组件结构、状态管理及样式隔离。指导使用数据属性与 ARIA 状态进行样式编写，禁止使用peer或复杂选择器，确保组件可独立转换与组合。
需要创建新的 UI 组件
实现组件的样式定义
重构现有组件以符合 VJSC 规范
npx skills add videojs/video.js --skill create-vjsc-component -g -y
提供基于 Rolldown 和 Oxc AST 的代码转换技能，指导通过 transform hook 进行模块级源码编辑、MagicString 使用及源映射处理。
需要对代码进行 AST 级别的修改
配置 Rolldown 构建插件以启用原生 MagicString
处理 TypeScript/JSX 的源码转换
npx skills add videojs/video.js --skill transform-rolldown-code -g -y
