AI-Skill分享第一期：superpowers-main & skills-main

weixin_65670487

346人浏览 · 2026-06-11 23:15:13

weixin_65670487 · 2026-06-11 23:15:13 发布

AI-Skill分享第一期：superpowers-main & skills-main

发布日期：2026-06-11

前言

👋 大家好，这是 AI-Skill分享 系列的第一期。今天给大家介绍两个非常实用的 Skill 项目：superpowers-main 和 skills-main。

可以帮助你更好地利用 AI 进行软件开发。

📢 本系列会持续更新，收集和分享社区中好用的 Skill，帮助大家更好地使用 AI 工具完成编码。如果你有发现好用的技能，也欢迎推荐！

🧩 什么是 Skill？

Skill（技能）是 Claude Code 的一种扩展机制。简单来说，它就是一组指令和资源的集合，Claude 会根据当前任务动态加载对应的 Skill，从而在特定任务上表现得更好。

你可以把 Skill 理解为给 AI 安装的"插件"：

📂 每个 Skill 就是一个文件夹，里面有一个 SKILL.md 文件
📝 SKILL.md 里写了这个 Skill 的用途、触发条件、具体指令
⚡ ai工具会自动识别当前场景，激活对应的 Skill
🔧 你也可以自己写 Skill，教 AI 做你想让它做的事

Skill 能做什么？

规范 AI 行为 — 比如强制先写测试再写代码，不允许跳过流程
拓展思维 — 比如在动手之前先做需求分析和方案设计
纠错能力 — 比如遇到 bug 必须先定位根因，不能瞎猜
扩展功能 — 比如让 AI 能生成 Word/PDF/PPT 文件，操作浏览器测试
等...... ai或许是泡沫，也或许刚刚开始

🦸 superpowers-main 介绍

项目来源

Superpowers 由资深开源开发者 Jesse Vincent 打造。他是 Perl 社区知名开发者，Keyboardio 键盘创始人，fsck.com 创始人。

项目地址：GitHub - obra/superpowers: An agentic skills framework & software development methodology that works. · GitHub

项目简介

Superpowers 是一个完整的软件开发方法论，它不仅仅是一组技能，更是一套完整的开发工作流程。当你使用 Superpowers 后，你的 AI 编码助手会自动遵循一套专业的开发流程，而不是直接跳进去写代码。

核心理念

测试驱动开发 (TDD) - 先写测试，再写代码
系统化而非临时化 - 流程优于猜测
降低复杂度 - 简单性是首要目标
证据优于声明 - 验证后再声明成功

工作流程

Superpowers 的核心工作流程：

brainstorming（头脑风暴） - 在写代码之前，先通过对话澄清你真正想做什么
using-git-worktrees（使用 Git Worktree） - 创建隔离的工作空间
writing-plans（编写计划） - 将工作分解为小任务（每个 2-5 分钟）
subagent-driven-development（子代理驱动开发） - 派遣子代理执行每个任务
test-driven-development（测试驱动开发） - 强制执行 RED-GREEN-REFACTOR 循环
requesting-code-review（请求代码审查） - 任务间进行代码审查
finishing-a-development-branch（完成开发分支） - 验证测试，合并/PR 决策

包含的技能列表

📌 小知识: Superpowers 的技能是自动触发的，不需要你手动调用。当你开始写代码时，它会自动判断当前阶段并激活对应的技能。

分类	技能	说明
测试	test-driven-development	RED-GREEN-REFACTOR 循环
调试	systematic-debugging	4 阶段根因分析过程
	verification-before-completion	确保问题真正修复
协作	brainstorming	苏格拉底式设计精炼
	writing-plans	详细的实施计划
	executing-plans	带检查点的批量执行
	dispatching-parallel-agents	并发子代理工作流
	requesting-code-review	预审查清单
	receiving-code-review	响应反馈
	using-git-worktrees	并行开发分支
	finishing-a-development-branch	合并/PR 决策工作流
	subagent-driven-development	快速迭代与两阶段审查
元技能	writing-skills	创建新技能
	using-superpowers	技能系统介绍

核心技能详解

🧠 brainstorming — 拓展思维，拒绝盲目编码

"不要一上来就写代码，先搞清楚你到底要做什么。"

这个技能会强制 AI 在写代码之前，先和你进行一轮对话：了解你的需求、提出 2-3 种方案、分析利弊、等你确认后才动手。哪怕是一个"很简单"的功能，也必须走这个流程。

解决的痛点：AI 经常自作聪明，上来就写一堆代码，结果方向错了全白费。有了这个技能，AI 会先问清楚再动手，节省大量返工时间。

🔴🟢 test-driven-development — 规范 AI 的编码行为

"先写测试，看着它失败，再写代码让它通过。"

这是 Superpowers 最硬核的技能。它强制 AI 遵循 RED-GREEN-REFACTOR 循环：先写一个会失败的测试 → 运行确认它真的失败 → 写最少的代码让测试通过 → 重构。

更狠的是：如果你先写了代码再补测试，它会要求你删掉代码重来。

解决的痛点：AI 写的代码"看起来能跑"但没有测试保障，后期改一个地方崩三个地方。TDD 确保每一行代码都有测试覆盖。

🔍 systematic-debugging — 纠错不靠猜，靠流程

"没有找到根因之前，不许提修复方案。"

遇到 bug 时，AI 不会上来就改代码碰运气。这个技能强制执行 4 阶段调试流程：复现 → 定位根因 → 制定方案 → 验证修复。

它特别强调：越是紧急的时候，越不能跳过流程。因为"看起来 obvious 的快速修复"往往是错的。

解决的痛点：AI 调试经常是"改一行试试，不行再改一行"，结果越改越乱。这个技能让调试变成有章法的工程行为。

✅ verification-before-completion — 不验证不许说"搞定了"

"声称完成之前，先跑一遍验证命令。"

这个技能卡住了 AI 最常见的问题：嘴上说"已修复"，实际没验证。它要求 AI 在说"通过"、"完成"、"修复"之前，必须先运行验证命令并展示输出结果。

解决的痛点：AI 经常说"测试通过了"但其实根本没跑，或者跑错了命令。这个技能让"证据优于声明"成为铁律。

🤖 subagent-driven-development — 分工协作，各司其职

"一个任务一个子代理，干完活再交给审查员。"

这个技能让 AI 把大任务拆成小任务，每个任务派遣一个独立的子代理去执行。子代理完成后，还有两轮审查：先查是否符合需求，再查代码质量。

解决的痛点：上下文太长导致 AI 后面的代码质量下降。子代理有独立的上下文，不会被前面的对话"污染"。

📚 skills-main 介绍

项目来源

skills-main 是 Anthropic 官方发布的 Claude 技能示例库。这些技能展示了 Claude 技能系统的各种可能性，涵盖创意应用、技术任务和企业工作流。

项目地址：https://github.com/anthropics/skills

项目简介

这些技能范围从创意应用（艺术、音乐、设计）到技术任务（测试 Web 应用、MCP 服务器生成）再到企业工作流（通信、品牌等）。

文档处理技能（Document Skills）

✨ 这些是 Claude 文档处理能力的底层实现，也是 Claude.ai "创建文件"功能的核心：

技能	说明
docx	Word 文档创建与编辑
pdf	PDF 文档创建与处理
pptx	PowerPoint 演示文稿创建
xlsx	Excel 电子表格创建与处理

核心技能详解

📄 docx / pdf / pptx / xlsx — 文档处理四件套

"直接让 AI 帮你生成 Word、PDF、PPT、Excel 文件。"

这四个技能是 Claude.ai "创建文件"功能的底层实现。装上之后，你可以直接让 AI 生成各种格式的文档，比如"帮我做一个项目汇报 PPT"、"把这个数据导出成 Excel"。

解决的痛点：以前只能让 AI 输出文本，再自己复制粘贴到文档里。现在直接生成文件，一步到位。

🔧 mcp-builder — 让 AI 帮你造工具

"想让 AI 连接外部服务？让它自己写一个 MCP 服务器。"

MCP（Model Context Protocol）是让 Claude 连接外部 API 的协议。这个技能会指导 AI 按照最佳实践，生成一个完整的 MCP 服务器代码，包括工具定义、错误处理、文档等。

解决的痛点：写 MCP 服务器需要了解协议规范，有了这个技能，你只需要告诉 AI "我要连接什么服务"，它帮你搞定剩下的。

🧪 webapp-testing — 自动化测试你的 Web 应用

"AI 帮你写 Playwright 测试脚本，自动验证前端功能。"

这个技能让 AI 能够操作浏览器，截图、点击、填写表单、验证页面内容。你可以让它"测试一下登录功能是否正常"，它会自动打开浏览器跑一遍。

解决的痛点：手动测试前端功能很繁琐，有了这个技能，AI 可以帮你自动化验证。

🎨 algorithmic-art / canvas-design / frontend-design — 创意设计三件套

"让 AI 帮你做设计，从算法艺术到前端页面。"

algorithmic-art: 用代码生成艺术图案
canvas-design: Canvas 画布设计
frontend-design: 前端页面设计辅助

解决的痛点：设计师不在身边时，AI 可以帮你快速出原型。

💡 skill-creator — 教 AI 造技能

"想创建自己的 Skill？让 AI 帮你写。"

这个技能会引导 AI 按照规范帮你创建新的 Skill，包括 SKILL.md 的结构、frontmatter 元数据、使用示例等。

解决的痛点：不知道怎么写 Skill？让已经装了这个技能的 AI 手把手教你。

示例技能（Example Skills）

这些技能展示了各种能力的可能性：

技能	说明
algorithmic-art	算法艺术生成
brand-guidelines	品牌指南管理
canvas-design	Canvas 画布设计
claude-api	Claude API 和 SDK 使用指南
doc-coauthoring	文档协作编辑
frontend-design	前端设计辅助
internal-comms	内部沟通文档生成
mcp-builder	MCP 服务器生成器
skill-creator	技能创建器（帮你创建新技能）
slack-gif-creator	Slack GIF 动图创建
theme-factory	主题样式工厂
web-artifacts-builder	Web 构建产物生成
webapp-testing	Web 应用自动化测试

自定义技能模板

skills-main 还提供了创建自定义技能的模板，格式非常简单：

---
name: my-skill-name
description: A clear description of what this skill does and when to use it
---

# My Skill Name

[Add your instructions here that Claude will follow when this skill is active]

## Examples
- Example usage 1
- Example usage 2

## Guidelines
- Guideline 1
- Guideline 2

只需要一个文件夹 + 一个 SKILL.md 文件，就能创建自己的技能。

🆚 两者对比

特性	superpowers-main	skills-main
定位	完整开发方法论	技能示例库
作者	Jesse Vincent (社区)	Anthropic (官方)
核心价值	工作流程优化	能力扩展
适用场景	软件开发全流程	特定任务处理
学习曲线	较高（需要适应流程）	较低（即装即用）