SuperAPI AI 工具集

design

设计与创作

查看项目

更新于 10-16 06:15

技能介绍

用途:为 Video.js 10 编写 Design Doc,适用于你负责的架构选择、组件规格和内部模式。涉及公共 API、产品方向、开发者体验或核心架构重大变更、需要他人认可时,应改用 RFC;缺陷修复、单包内小功能、实现细节、文档更新则两者都不必写。

主要能力:提供编写原则与模板索引。原则包括:先讲问题再给方案;面向人类可读,先解释“为什么”;简洁流畅;渐进式披露(问题→方案概览→快速开始→API 表面→理由);代码只说明概念而非实现;按时间顺序展开概念;调研内部既有模式与外部先行方案;仅在真正有争议时才记录决策,并就地更新条目而非追加。

使用方式:按任务加载参考文件——任何设计任务读 SKILL.md;选择结构读 references/structure.md;功能指导读 references/features.md;组件指导读 references/components.md;简单决策用 templates/decision.md;单文件功能用 templates/feature-single.md;多文件功能用 templates/feature-multi.md;基础组件用 templates/component-basic.md;复合组件用 templates/component-compound.md。格式与文件命名参见 internal/design/README.md。

适用场景:内部实现选择、自有设计模式与组件规格、需长期留存的决策记录。流程为探索代码、调研先行方案(Base UI、WAI-ARIA APG 及播放器库)、选类型、起稿、删减、链接、对照清单复核。清单要求覆盖问题先行、概念先解释、API 表面含 props/data 属性/CSS 自定义属性、状态与 store 需求、无障碍(ARIA、键盘、焦点管理)等;未来工作放入 Open Questions,架构与实现细节另置 .claude/plans/。

限制:资料未提供具体收费、平台支持范围或团队协作要求等信息。