> **深度研究** | 2026-04-24
> **涉及项目**: Context7、Impeccable、UI/UX Pro Max、Superpowers、Next Skills
> **总代码量**: 约 50,000+ 行(含文档、脚本、参考文件)
---
## 引言:从"工具"到"操作系统"
2026 年 4 月,AI 编程领域发生了一件看似平淡、实则深远的事:**Skill 开始标准化了。**
所谓 Skill,本质上是一份结构化的 Markdown 文件(SKILL.md),告诉 AI Agent "在什么场景下、用什么方法、遵循什么规则"来完成工作。它不是代码,不是 API,不是 SDK——它是一份**行为契约**。
过去半年,我深度研读了五个最具代表性的开源 Skill 项目,逐行分析了它们的代码、文档和设计哲学。这篇文章是我的完整笔记。
我会用费曼式的语言,从"为什么需要 Skill"讲起,逐一拆解每个项目的核心设计思想,最后回答一个更大的问题:**这些 Skill 加在一起,是否构成了 AI 编程的"操作系统"?**
---
## 一、Context7:让 AI 不再"凭记忆写代码"
### 项目名片
| 字段 | 内容 |
|------|------|
| **仓库** | [upstash/context7](https://github.com/upstash/context7) |
| **作者** | Upstash(Serverless 数据基础设施公司) |
| **核心功能** | 实时获取任何编程库的最新文档 |
| **技术形态** | CLI 工具 + MCP Server + Skill 三件套 |
| **协议** | MIT |
### 问题:AI 的"知识过期"危机
想象一个场景:你让 Claude 帮你写一段 Next.js 的缓存代码。Claude 从训练数据里翻出了 `getServerSideProps` 的写法——但 Next.js 15 已经废弃了这个 API,改用 `async` 的 `params` 和 `searchParams`。
这不是 Claude 的错。它的训练数据有截止日期。而前端框架的 API 变更速度,远超模型更新的频率。
**Context7 解决的就是这个问题:让 AI 在写代码之前,先查一下最新文档。**
### 架构设计:两步查询
Context7 的核心设计极其简洁——**两步查询**:
```
第一步:ctx7 library react "How to clean up useEffect"
→ 返回: /facebook/react (Library ID)
第二步:ctx7 docs /facebook/react "How to clean up useEffect"
→ 返回: 最新的文档片段 + 代码示例
```
为什么是两步而不是一步?因为 **消歧义**。搜索 "react" 可能匹配到 React、React Native、React Router……第一步让你确认你要的是哪个库,第二步才去查具体文档。
这个设计看似简单,但背后有一个深刻的洞察:**AI 的错误往往不是"不知道",而是"自信地用错了版本"。** 两步查询强制 AI 先确认上下文,再获取信息。
### 三件套:CLI + MCP + Skill
Context7 最聪明的地方在于它提供了三种使用方式,覆盖不同场景:
| 形态 | 使用场景 | 触发方式 |
|------|---------|---------|
| **CLI** (`ctx7`) | 终端用户手动查询 | `ctx7 docs /facebook/react "hooks"` |
| **MCP Server** | Claude Code / Cursor 自动调用 | Agent 自动触发 `resolve-library-id` + `query-docs` |
| **Skill** (`find-docs`) | 任何支持 SKILL.md 的工具 | Agent 读取 SKILL.md 后自动遵循 |
**Skill 版本(find-docs)的设计哲学尤其值得注意。** 它不是简单地把 CLI 命令包装成 Markdown,而是定义了一套完整的行为规范:
- "即使你觉得自己知道答案,也要先查文档"(防止过度自信)
- "如果 Context7 配额用完了,告诉用户,不要默默回退到训练数据"(透明度)
- "不要在查询中包含 API Key 等敏感信息"(安全性)
这些规则不是技术约束,而是 **行为约束**——它们定义了 AI "应该怎么做",而不是"能做什么"。
### Skill 管理器:Context7 的隐藏王牌
除了文档查询,Context7 还内置了一个 **Skill 管理器**:
```bash
ctx7 skills install /anthropics/skills pdf # 安装特定 skill
ctx7 skills search typescript testing # 搜索 skill
ctx7 skills list # 列出已安装 skill
```
这意味着 Context7 不仅仅是一个"文档查询工具",它正在成为一个 **Skill 的包管理器** ——类似 npm 之于 JavaScript,pip 之于 Python。如果这个生态成熟,"安装一个 Skill"可能变得和"安装一个 npm 包"一样简单。
### 费曼式总结
> Context7 解决了一个看似简单、实则致命的问题:AI 的训练数据会过期。它的方案不是"训练更好的模型",而是"让模型在需要时查最新文档"。两步查询消歧义,三件套覆盖全场景,Skill 管理器暗示了更大的野心——成为 AI 编程世界的 npm。
---
## 二、Impeccable:一个设计师把"审美"变成了"纪律"
### 项目名片
| 字段 | 内容 |
|------|------|
| **仓库** | [pbakaus/impeccable](https://github.com/pbakaus/impeccable) |
| **作者** | Paul Bakaus(Google 前创意技术总监,Web 性能优化先驱) |
| **核心功能** | 让 AI 生成高品质前端界面 |
| **技术形态** | 1 个主 Skill + 23 个子命令 + 30+ 参考文件 + 自动化检测脚本 |
| **协议** | MIT |
### 问题:AI 生成的界面为什么"千篇一律"?
你让任何 AI 做一个落地页,大概率会得到这样的结果:
- Inter 字体(或 Roboto)
- 蓝色主按钮 + 紫粉渐变
- 大圆角卡片 + emoji 图标
- 左边框强调的列表项
- "hero section + 三列特性 + CTA" 的标准布局
Paul Bakaus 把这称为 **"AI Slop"**(AI 味)。他认为这不是模型能力的问题,而是**缺乏设计纪律**的问题。
### 设计哲学:不是"教 AI 做设计",而是"禁止 AI 犯蠢"
Impeccable 的 SKILL.md 有 23 个子命令:`audit`、`critique`、`polish`、`animate`、`colorize`、`typeset`、`layout`、`adapt`、`bolder`、`quieter`……每个命令对应一个 `reference/*.md` 文件。
但最精彩的部分不是这些命令,而是 **DESIGN.md** ——一份 297 行的设计系统宣言。它用 oklch 色彩空间定义了 10 种颜色,用 clamp() 定义了响应式字体,用 8/16/24/32/48/80/120 的 8px 栅格定义了间距系统。
然后,它列了一份 **禁令清单**:
- ❌ 不要用 glassmorphism(毛玻璃效果)
- ❌ 不要加第二个强调色
- ❌ 不要用圆角矩形 + 通用阴影("这看起来像任何 AI 的输出")
- ❌ 不要用弹性缓动(真实物体是平滑减速的,用 expo-out)
- ❌ 不要动画化布局属性(width、height、padding),只用 transform 和 opacity
- ❌ 不要卡片嵌套卡片
- ❌ 不要用 bounce 或 elastic 缓动
**这份清单的精髓在于:它不是在说"怎么做好的设计",而是在说"不要做那些一看就是 AI 做的设计"。** 负面清单比正面指导更有效——因为 AI 已经"知道"怎么做设计(从训练数据里学到的),它需要的是知道 **什么不该做**。
### 最硬核的设计:双盲评审
Impeccable 的 `critique` 命令实现了一个让我惊叹的机制——**双盲设计评审**:
1. **评审 A(LLM 设计评审)**:像设计总监一样审视界面,检查 AI Slop、视觉层级、认知负荷、情感旅程、Nielsen 十大可用性原则
2. **评审 B(自动化检测)**:运行一个确定性检测器(`npx impeccable --json`),扫描 25 种具体的 AI Slop 模式
关键要求:**两个评审必须独立执行,不能看到对方的输出。** 为什么?因为如果评审 A 的结果影响了评审 B,评分就会被"锚定"——和人类评审中的锚定效应一样。
这不仅是工程实现,这是 **实验设计**。Paul Bakaus 把心理学实验的严谨性带入了 AI 设计评审。
### Live Browser Iteration:实时迭代
Impeccable 还有一个独特的功能—— **实时浏览器迭代**。通过 `live` 命令,它可以在浏览器中启动一个本地服务器,注入检测脚本,让用户在浏览器中直接看到问题标记(红色高亮、箭头指向等)。
这不是"生成代码然后截图"的传统流程,而是 **"生成代码 → 在浏览器中渲染 → 实时标注问题 → 迭代修改"** 的闭环。
### 费曼式总结
> Impeccable 的核心洞察是:AI 不需要学习"怎么做好的设计",它需要学习"什么不该做"。23 个子命令覆盖了从审计到打磨的完整设计流程,双盲评审机制把心理学实验的严谨性带入了 AI 设计,DESIGN.md 用 297 行定义了一套完整的设计系统。这不是一个 Skill,这是一个设计学院的浓缩课程。
---
## 三、UI/UX Pro Max:设计生产的"瑞士军刀"
### 项目名片
| 字段 | 内容 |
|------|------|
| **仓库** | [nextlevelbuilder/ui-ux-pro-max-skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill) |
| **核心功能** | 品牌设计、Logo、CIP、Banner、图标、社交图片、PPT |
| **技术形态** | 5 个 Skill + Python 脚本 + Gemini AI 集成 |
| **协议** | MIT |
### 问题:设计生产链条太长
一个完整的品牌设计需要什么?Logo → 名片 → 信纸 → 社交媒体封面 → PPT → 图标集 → Banner。传统流程需要设计师、插画师、前端工程师协作数周。
UI/UX Pro Max 的野心是:**让一个 AI Agent 完成整条设计生产链。**
### 架构:Skill 路由 + AI 生成 + 脚本自动化
这个项目的架构可以用一张路由表概括:
| 任务 | 子 Skill | 实现方式 |
|------|---------|---------|
| 品牌识别 | `brand` | 外部 Skill |
| 设计系统 | `design-system` | 外部 Skill |
| UI 样式 | `ui-styling` | 外部 Skill |
| Logo 设计 | 内置 | Python 脚本 + Gemini AI |
| 企业形象 (CIP) | 内置 | Python 脚本 + Gemini AI |
| 演示文稿 | 内置 | HTML + Chart.js |
| Banner 设计 | 内置 | HTML/CSS + AI 生成 |
| 图标设计 | 内置 | Gemini 3.1 Pro 生成 SVG |
| 社交图片 | 内置 | HTML → 截图导出 |
**最巧妙的设计是 Logo 和 CIP 的生成流程。** 它不是简单地让 AI "画一个 Logo",而是:
1. **搜索阶段**:用 BM25 搜索引擎从 55 种风格、30 种配色、25 个行业指南中检索匹配项
2. **生成阶段**:调用 Gemini AI 生成图片
3. **渲染阶段**:用 Python 脚本把 Logo 嵌入名片、信纸等 50+ 种交付物的 Mockup 中
BM25 搜索引擎是一个有趣的工程选择——它是一个经典的文本检索算法,用在这里是为了**从结构化的设计数据库中精确匹配**,而不是让 AI 自由发挥。
### 费曼式总结
> UI/UX Pro Max 是一个"设计工厂"——它把品牌设计的完整生产链条编码成了 Skill + 脚本 + AI 的组合。BM25 搜索引擎提供精确匹配,Gemini AI 提供创意生成,Python 脚本提供自动化渲染。它的价值不在于单个功能,而在于**把碎片化的设计工具链整合成了一个连贯的工作流**。
---
## 四、Superpowers:AI 编程的"纪律手册"
### 项目名片
| 字段 | 内容 |
|------|------|
| **仓库** | [obra/superpowers](https://github.com/obra/superpowers) |
| **作者** | Jesse Vincent(RT 作者,Perl 社区传奇) |
| **核心功能** | 13 个行为纪律 Skill,覆盖编程全流程 |
| **技术形态** | 纯 Markdown(零代码),13 个 SKILL.md + 参考文件 |
| **协议** | MIT |
### 问题:AI 编程最大的敌人不是能力,而是纪律
Jesse Vincent 在 CLAUDE.md 的第一行就亮出了态度:
> "这个仓库有 94% 的 PR 拒绝率。几乎所有被拒的 PR 都是 AI Agent 提交的——它们没有读指南,或者没有遵循指南。"
然后他加了一句让我拍案叫绝的话:
> **"你的工作是保护你的人类伙伴免受这种结果。提交低质量 PR 不是在帮忙——它在浪费维护者的时间,烧毁你人类伙伴的声誉。"**
这不是在教 AI 怎么写代码,这是在教 AI **怎么做一个好同事**。
### 13 个 Skill 的设计哲学
Superpowers 的 13 个 Skill 覆盖了编程的完整生命周期:
| 阶段 | Skill | 核心原则 |
|------|-------|---------|
| **思考** | `brainstorming` | 先设计,再编码。没有设计审批,一行代码都不写 |
| **编码** | `test-driven-development` | 先写测试,再写代码。"没测试就写代码?删掉重来" |
| **调试** | `systematic-debugging` | 先找根因,再修 Bug。"没有根因调查就修 Bug?那是失败" |
| **审查** | `requesting-code-review` | 代码写完主动请求审查 |
| **审查** | `receiving-code-review` | 收到审查反馈后,先验证再实施 |
| **验证** | `verification-before-completion` | 声称完成之前,先运行验证 |
| **协作** | `dispatching-parallel-agents` | 独立任务并行分派 |
| **协作** | `subagent-driven-development` | 在当前会话中用子 Agent 执行计划 |
| **执行** | `executing-plans` | 在独立会话中执行计划,带审查检查点 |
| **规划** | `writing-plans` | 写可执行的实施计划 |
| **Git** | `using-git-worktrees` | 用 Git Worktree 隔离功能开发 |
| **收尾** | `finishing-a-development-branch` | 完成开发后决定如何集成 |
| **元技能** | `writing-skills` | 用 TDD 方法论编写新 Skill |
| **元技能** | `using-superpowers` | 每次对话开始时检查是否有适用的 Skill |
### 最精彩的设计:反合理化表格
Superpowers 的每个纪律型 Skill 都包含一个**"合理化表格"**(Rationalization Table)——列出 AI 常用的借口和对应的反驳:
| 借口 | 现实 |
|------|------|
| "这个太简单了,不需要设计" | 简单项目才是未检查假设造成最大浪费的地方 |
| "我已经手动测过了" | 手动测试通过证明不了什么 |
| "测试后写也能达到同样目的" | 测试后写 = "这代码在干嘛?" 测试先写 = "这代码该干嘛?" |
| "这不一样,因为……" | 每个例外都意味着规则有漏洞,需要修补 |
| "我觉得这不需要正式的 Skill" | 如果 Skill 存在,就用它 |
**这个设计的精妙之处在于:它不是在定义规则,而是在预判 AI 会如何违反规则,然后逐一封堵。**
Jesse Vincent 把这称为 **"Close Every Loophole Explicitly"**(显式关闭每个漏洞)。他的洞察是:AI 非常聪明,它会找到规则的漏洞——所以你不能只说"不要做 X",你必须说"不要做 X,也不要通过 Y、Z、W 的方式变相做 X"。
### writing-skills:用 TDD 写 Skill
Superpowers 里最"元"的 Skill 是 `writing-skills`——它教你**如何编写新的 Skill**,而且用的是 TDD 方法论:
| TDD 概念 | Skill 创建 |
|---------|-----------|
| 测试用例 | 用子 Agent 运行压力场景 |
| 生产代码 | Skill 文档(SKILL.md) |
| 测试失败(RED) | 没有 Skill 时 Agent 违反规则 |
| 测试通过(GREEN) | 有 Skill 时 Agent 遵守规则 |
| 重构 | 关闭新发现的漏洞 |
**"如果你没有看到 Agent 在没有 Skill 时失败,你就不知道 Skill 是否教了正确的东西。"**
这个原则和软件工程中的 TDD 完全同构——先写失败的测试,再写让测试通过的代码。只不过这里的"代码"是 Markdown,"测试"是 Agent 的行为。
### 费曼式总结
> Superpowers 是一份 AI 编程的"纪律手册"。13 个 Skill 覆盖了从思考到收尾的完整编程生命周期,每个 Skill 都包含反合理化表格来封堵 AI 的借口。最深刻的设计是 `writing-skills`——它用 TDD 方法论来编写 Skill 本身,形成了一个自指的纪律系统:用纪律来创建更多的纪律。
---
## 五、Next Skills:Vercel 官方的"最佳实践编码器"
### 项目名片
| 字段 | 内容 |
|------|------|
| **仓库** | [vercel-labs/next-skills](https://github.com/vercel-labs/next-skills) |
| **作者** | Vercel Labs(Next.js 官方团队) |
| **核心功能** | Next.js 最佳实践、升级指南、缓存组件 |
| **技术形态** | 3 个 Skill + 20+ 参考文件 |
| **协议** | MIT |
### 问题:Next.js 的 API 变化太快了
Next.js 是前端框架中 API 变更最频繁的之一。从 Pages Router 到 App Router,从 `getServerSideProps` 到 `async` params,从 `experimental.ppr` 到 `cacheComponents: true`——每次大版本更新都引入大量 breaking changes。
**Next Skills 的目标是:把 Next.js 的最佳实践编码成 Skill,让 AI 在写 Next.js 代码时自动遵循最新规范。**
### 三个 Skill 的分工
| Skill | 定位 | 关键内容 |
|-------|------|---------|
| `next-best-practices` | 日常编码规范 | 文件约定、RSC 边界、异步模式、元数据、错误处理、图片/字体优化 |
| `next-upgrade` | 版本升级指南 | 迁移路径、breaking changes、codemod |
| `next-cache-components` | Next.js 16 新特性 | PPR、`use cache`、`cacheLife`、`cacheTag`、`updateTag` |
### 最有价值的设计:`next-cache-components`
Next.js 16 引入了 **Cache Components**——一个全新的缓存模型。`next-cache-components` 这个 Skill 用 412 行 Markdown 完整地编码了这个新模型:
**三种内容类型**:
- **Static**(静态):同步代码,构建时预渲染
- **Cached**(缓存):`'use cache'` 指令,按 `cacheLife` 策略缓存
- **Dynamic**(动态):Suspense 包裹,运行时流式传输
**迁移对照表**:
| 旧 API | 新 API |
|--------|--------|
| `experimental.ppr` | `cacheComponents: true` |
| `dynamic = 'force-dynamic'` | 删除(默认行为) |
| `dynamic = 'force-static'` | `'use cache'` + `cacheLife('max')` |
| `revalidate = N` | `cacheLife({ revalidate: N })` |
| `unstable_cache()` | `'use cache'` 指令 |
这个迁移表的价值无法估量——它让 AI 在升级 Next.js 项目时,能精确地知道每个旧 API 对应的新 API 是什么,而不是"大概知道要改什么"。
### 费曼式总结
> Next Skills 是框架官方对 Skill 生态的背书。Vercel 团队把 Next.js 的最佳实践、升级指南和最新特性编码成了 Skill,让 AI 在写 Next.js 代码时自动遵循最新规范。`next-cache-components` 对 Next.js 16 新缓存模型的编码尤其出色——412 行 Markdown 完整覆盖了从概念到迁移的全链路。
---
## 六、五个项目的交叉分析
### 它们解决的是同一个问题的不同面
| 维度 | Context7 | Impeccable | UI/UX Pro Max | Superpowers | Next Skills |
|------|----------|------------|---------------|-------------|-------------|
| **核心问题** | 知识过期 | 审美缺失 | 生产链条断裂 | 纪律缺失 | API 过时 |
| **解决方式** | 实时查询 | 禁令清单 | 工作流整合 | 反合理化 | 最佳实践编码 |
| **技术形态** | CLI+MCP+Skill | Skill+脚本 | Skill+Python+AI | 纯 Markdown | 纯 Markdown |
| **设计哲学** | "先查再做" | "不该做的比该做的更重要" | "全链条自动化" | "封堵每个漏洞" | "官方权威编码" |
| **适用范围** | 任何编程语言 | 前端界面 | 设计生产 | 通用编程 | Next.js |
### 一个正在成型的"操作系统"
把这五个项目放在一起看,你会发现它们正在共同构建一个**AI 编程的操作系统**:
- **Context7** 是"包管理器"——管理知识和 Skill 的获取
- **Impeccable** 是"设计子系统"——定义视觉输出的质量标准
- **UI/UX Pro Max** 是"设计工具链"——提供从 Logo 到 Banner 的完整生产工具
- **Superpowers** 是"内核纪律"——定义编程行为的底线规则
- **Next Skills** 是"驱动程序"——让 AI 正确使用特定的技术栈
它们之间没有显式的依赖关系,但组合在一起时,覆盖了 AI 编程的**知识获取 → 行为纪律 → 设计质量 → 生产工具 → 技术栈适配**的完整链条。
### 对 Skill 生态的三个洞察
**洞察 1:Skill 的价值不在于"教 AI 新东西",而在于"让 AI 不忘旧东西"。**
Context7 解决的是"AI 忘了最新 API",Superpowers 解决的是"AI 忘了基本纪律",Next Skills 解决的是"AI 忘了框架更新"。它们都不是在扩展 AI 的能力边界,而是在**守住 AI 的能力底线**。
**洞察 2:最好的 Skill 是"负面清单"。**
Impeccable 的禁令清单、Superpowers 的合理化表格——它们不是在说"你应该怎么做",而是在说"你不应该怎么做"。这比正面指导更有效,因为 AI 已经从训练数据中"知道"了太多东西,它需要的是**过滤**,而不是**添加**。
**洞察 3:Skill 正在从"提示词工程"进化为"行为设计"。**
早期的 Skill 本质上是"更长的系统提示词"。但 Superpowers 的 `writing-skills` 用 TDD 方法论来编写 Skill,Impeccable 用双盲评审来验证设计质量——这些都不是"写提示词",而是**设计行为、测试行为、迭代行为**。Skill 正在从"文本"进化为"代码"——只不过它编码的不是计算逻辑,而是**行为逻辑**。
---
## 结语
2026 年 4 月,AI 编程领域最有趣的事情不是某个新模型的发布,而是 **Skill 生态的标准化和成熟化**。
Context7 让 AI 不再凭记忆写代码,Impeccable 让 AI 不再生成千篇一律的界面,UI/UX Pro Max 让 AI 能完成完整的设计生产链,Superpowers 让 AI 遵守编程纪律,Next Skills 让 AI 跟上框架的最新变化。
它们加在一起,正在回答一个根本性的问题:**当 AI 的能力已经足够强时,如何让它"靠谱地"使用这些能力?**
答案不是更强的模型,而是更好的 Skill。
---
📎 **Context7**: [github.com/upstash/context7](https://github.com/upstash/context7)
📎 **Impeccable**: [github.com/pbakaus/impeccable](https://github.com/pbakaus/impeccable)
📎 **UI/UX Pro Max**: [github.com/nextlevelbuilder/ui-ux-pro-max-skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill)
📎 **Superpowers**: [github.com/obra/superpowers](https://github.com/obra/superpowers)
📎 **Next Skills**: [github.com/vercel-labs/next-skills](https://github.com/vercel-labs/next-skills)
登录后可参与表态
讨论回复
0 条回复还没有人回复,快来发表你的看法吧!