Coding Agent Skills 实战指南：10 个让 AI 写代码如虎添翼的 Skills 加 11 个优质来源（2026 完整版）
AI 辅助写作声明：本文基于社区精选 10 个 Skills 与 Framework 的内容，由 CalcGuide 编辑团队结合实战场景重新结构化、补充 2026 时代背景与 CalcGuide 工程化视角。AI 协助资料整理、表格化、命令清单校对，最终观点与场景选型由人类编辑负责。详见文末「AI 辅助写作披露」一节。
一、为什么 Coding Agent 写代码”看起来聪明，实际很傻”
2026 年的今天，Claude Code、Codex、Cursor、Antigravity、Gemini CLI 这些 Coding Agent 已经能理解复杂需求、写完整功能、甚至自动跑测试。但真正把它们用起来 90% 的开发者会撞到同一面墙：
- 拿到需求 → 直接开写，不规划、不测试、不 review
- 长任务做到一半 → 忘了最初的目标
- 写完代码 → 自我感觉良好，不跑验证就交差
- 用了 MCP 工具但不知道怎么调才对（session、OAuth、错误处理全乱套）
这些问题的根因不是模型不够强，而是**「怎么用 Coding Agent」这件事本身需要一套工程化方法**——这就是 Skills 与 Framework 要解决的事。
二、底层逻辑：Skills 是什么？为什么有效
Skills 是用 SKILL.md 描述的”工作流卡片”——告诉 Coding Agent 「什么时候、做什么、怎么做」。它们可以：
- 改变 Agent 的行为模式（从”想到就做”到”先规划后做”）
- 注入领域知识（React 性能规则、设计规范、安全审计）
- 配合 MCP 工具告诉 Agent 怎么调（不只是能调）
Skills 的核心价值是：把社区或团队的工程最佳实践固化成 Agent 可以复用的”操作手册”。
三、10 个精选 Skills 与 Framework（按场景分类）
场景 1：让 Coding Agent 写代码”有规范”
1. Superpowers（⭐ 90k+）
| 字段 | 值 |
|---|---|
| 仓库 | obra/superpowers |
| 作者 | Jesse Vincent |
| 类型 | Skills Framework（完整工程方法论系统） |
| 兼容 | Claude Code（Marketplace 已收录）、Codex、Gemini CLI、OpenCode、Cursor |
GitHub 上最火的 Coding Agent 框架。但很多开发者以为它是一堆 SKILL.md 卡片，其实它是一套完整系统：包含 Skills + 子智能体 + Slash 命令 + 会话钩子 + 多平台适配器。
完整目录结构：
superpowers/
├── skills/ ← 14 个核心 Skills（按需加载 references/）
├── agents/ ← 子智能体（code-reviewer）
├── commands/ ← 3 个命令（/brainstorm /write-plan /execute-plan）
├── hooks/ ← 会话钩子（启动时自动注入）
├── .claude-plugin/ ← Claude Code 插件配置
├── .codex/ ← Codex 适配
├── .opencode/ ← OpenCode 适配
├── GEMINI.md ← Gemini CLI 适配
└── docs/14 个核心 Skills：
| 类别 | Skill | 用途 |
|---|---|---|
| 方法论 | brainstorming | 动手前按上下文-问问题-出方案-写文档的流程走 |
| 方法论 | writing-plans | 把设计变成分步计划 |
| 方法论 | executing-plans | 严格按计划执行，禁止跳步 |
| TDD | test-driven-development | 先写测试再写码，跳过测试就重来 |
| 调试 | systematic-debugging | 系统化排雷（光引用文件就 11 个） |
| 子智能体 | subagent-driven-development | 多子智能体协同 |
| 子智能体 | dispatching-parallel-agents | 并行分派 |
| 代码审查 | requesting-code-review | 发起审查 |
| 代码审查 | receiving-code-review | 接收审查反馈 |
| Git | using-git-worktrees | worktree 物理隔离分支 |
| Git | finishing-a-development-branch | 分支收尾清单 |
| 质量 | verification-before-completion | 做完了必须跑验证 |
| 元技能 | using-superpowers | 路由器（什么时候该用哪个 Skill） |
| 元技能 | writing-skills | 写新 Skill 的 SOP |
为什么排第一：它解决了一个痛点——Coding Agent 拿到需求就开写，不想不规划不测试。Superpowers 把工程流水线用 Skills 固化下来：
收到任务 → brainstorming（先想清楚）→ writing-plans → test-driven-development
→ verification-before-completion → requesting-code-review → finishing-a-development-branch每个环节都有门控——前一步没过到不了下一步。装上之后，Coding Agent 的输出质量肉眼可见提升。
2. SuperClaude Framework（⭐ 21.8k）
| 字段 | 值 |
|---|---|
| 仓库 | SuperClaude-Org/SuperClaude_Framework |
| 类型 | Skills 命令框架 |
| 兼容 | Claude Code |
这不是标准 SKILL.md 格式，而是元编程配置框架——定义了 Coding Agent 的行为模式、工作流程、输出约束。
和 Superpowers 的区别：
- Superpowers 管”怎么正确地开发”（TDD、代码审查）
- SuperClaude 管”怎么高效地指挥 Coding Agent 干活”（命令调度、行为约束）
两个配合用效果最好。
30 条命令一览：
| 类别 | 命令 |
|---|---|
| 规划设计 | /brainstorm /design /estimate /spec-panel |
| 开发 | /implement /build /improve /cleanup /explain |
| 测试质量 | /test /analyze /troubleshoot /reflect |
| 文档 | /document /help |
| 版本控制 | /git |
| 项目管理 | /pm /task /workflow |
| 研究 | /research /business-panel |
| 工具 | /agent /spawn /index-repo /save /load 等 |
场景 2：领域专业技能
3. MiniMax Skills（⭐ 1.8k）
| 字段 | 值 |
|---|---|
| 仓库 | MiniMax-AI/skills |
| 类型 | Skills 集合包（10 个生产级技能） |
| 兼容 | Claude Code / Cursor / Codex / OpenCode |
这是 MiniMax 官方出的 10 个技能，每个都带完整工作流、设计系统、质量门控，可直接用于生产环境。
| Skill | 定位 | 用途 |
|---|---|---|
| frontend-dev | 前端 | 设计 + 动画（Framer Motion / GSAP）+ AI 资源 + 文案 |
| fullstack-dev | 全栈 | 7 条规范 + 三层架构 + 13 种模式 |
| android-native-dev | Android | Kotlin/Compose + Material Design 3 |
| ios-application-dev | iOS | UIKit + SwiftUI + Apple HIG |
| shader-dev | 着色器 | 36 种 GLSL 技术 |
| gif-sticker-maker | GIF 贴纸 | 照片转 Funko Pop 风格动画 |
| minimax-pdf | 从零创建 / 填表 / 重排版 | |
| pptx-generator | PPT | PptxGenJS + 完整设计系统 |
| minimax-xlsx | Excel | 创建/读/分析/编辑/验证 |
| minimax-docx | Word | OpenXML SDK + XSD 验证 |
4. Anthropic Official Skills（官方出品）
| 字段 | 值 |
|---|---|
| 仓库 | anthropics/skills |
| 类型 | 官方 Skills |
| 兼容 | Claude Code（原生支持） |
Anthropic 自己出的 Skills，是行业标杆。强烈建议先装 skill-creator——它是教你”怎么写 Skill 的 Skill”，入门必装。
| Skill | 用途 |
|---|---|
| skill-creator | 教你怎么写 Skill 的元技能（入门必装） |
| frontend-design | 前端设计、UI/UX |
| web-artifacts-builder | 构建 HTML artifacts（React + Tailwind） |
| mcp-builder | 创建 MCP Server |
| webapp-testing | Playwright 测试 |
| docx / pptx / xlsx / pdf | 文档四件套 |
| algorithmic-art | p5.js 生成艺术 |
| canvas-design | PNG/PDF 可视化设计 |
5. Vercel Agent Skills（⭐ 23.6k）
| 字段 | 值 |
|---|---|
| 仓库 | vercel-labs/agent-skills |
| 类型 | Skills 集合包（前端最佳实践） |
| 兼容 | Claude Code / Cursor / Codex / 通用 |
Vercel 工程团队出品的 5 个 Skills。不教怎么写代码，而是教 Coding Agent 按 Vercel 团队的工程标准来审查和优化代码。
| Skill | 用途 |
|---|---|
| react-best-practices | 40+ 条 React/Next.js 性能优化规则（消除 waterfall、包体积、SSR） |
| web-design-guidelines | 100+ 条 Web 设计审查规则（无障碍、焦点状态、表单、动画、暗色模式） |
| react-native-guidelines | 16 条 RN/Expo 最佳实践（FlashList、Reanimated、手势） |
| composition-patterns | 用组合模式替代 boolean prop 泛滥（compound components） |
| vercel-deploy-claimable | 一键部署到 Vercel，自动检测 40+ 框架 |
特别推荐 web-design-guidelines——100 多条规则覆盖 UI 细节，Coding Agent 做完 UI 后让它跑一遍这个 Skill，能抓出自己审不到的问题。
场景 3：上下文管理
6. Planning with Files
| 字段 | 值 |
|---|---|
| 仓库 | OthmanAdi/planning-with-files |
| 类型 | 专项 Skill（上下文工程） |
| 兼容 | Claude Code / Codex / 通用 |
做过长任务的开发者都知道，Coding Agent 做到一半就忘了最初的目标，上下文太长前面的指令就被稀释。这个 Skill 用 Markdown 文件给 Coding Agent 做外挂记忆库：
task_plan.md → 任务规划
findings.md → 调研发现
progress.md → 进度追踪Coding Agent 做重大决策前会先重读计划，推进过程中更新进度，非常适合跨多轮对话的复杂任务。
7. Context Engineering Skills
| 字段 | 值 |
|---|---|
| 仓库 | muratcankoylan/Agent-Skills-for-Context-Engineering |
| 类型 | Skills 集合包（上下文治理） |
| 兼容 | 通用 |
社区逐渐意识到：提示词工程只是冰山一角。左右 Coding Agent 输出质量的还有很大一部分是上下文工程——给它看什么、按什么顺序看、什么时候压缩、什么时候忘掉。
| Skill | 教什么 |
|---|---|
| context-fundamentals | 理解上下文的本质 |
| context-degradation | 识别上下文退化（丢信息、注意力分散） |
| context-compression | 长对话压缩策略 |
| context-optimization | 缓存、掩码策略 |
| multi-agent-patterns | 编排者/对等/层级式多智能体架构 |
| memory-systems | 短期/长期/图结构记忆 |
场景 4：对接外部服务
8. Composio Skills
| 字段 | 值 |
|---|---|
| 仓库 | ComposioHQ/skills |
| 类型 | Skills + MCP（双层配合） |
| 兼容 | 通用（npx skills add composiohq/skills 一键安装） |
日常开发里 Coding Agent 经常要对接外部服务——读写 GitHub Issues、发 Slack 通知、操作 Google Sheets、查 Jira。每个服务自己写 MCP Server 很麻烦，Composio 把这些都封装好了。
Composio 的特别之处：MCP + Skills 配合
- Composio 提供 MCP Server（
composio mcp），Coding Agent 通过标准 MCP 协议调用外部服务 - 同时还有 SKILL.md + rules 文件，教 Coding Agent 怎么正确使用这些工具（session、OAuth、错误处理）
光有 MCP 工具 Coding Agent 知道能调，加上 Skills 它才知道怎么调才对。
四块能力：
| 模块 | 用途 |
|---|---|
| Tool Router | 教 Coding Agent 选工具、管 session、用户隔离 |
| Authentication | 自动 OAuth + 手动授权 |
| Toolkits & Connections | 查询可用工具集、管理连接 |
| Triggers & Events | 创建实时事件触发器、Webhook 验证 |
独特的规则设计：rules 文件按场景拆小卡片（tr-session-management.md、tr-framework-integration.md），Coding Agent 按需读取，不会一次性全加载。
场景 5：学习范式与索引
9. Antfu Skills
| 字段 | 值 |
|---|---|
| 仓库 | antfu/skills |
| 类型 | 个人 Skills |
| 兼容 | 通用 |
Anthony Fu（Vue / Vite / UnoCSS / Vitest 核心维护者）的个人 Skills 仓库。与其一口气装一堆别人写的 Skills，不如先看顶级大佬怎么组织和写 Skills——学到手后自己写的才好用。
10. Awesome Agent Skills（⭐ 12.4k）
| 字段 | 值 |
|---|---|
| 仓库 | VoltAgent/awesome-agent-skills |
| 类型 | Skills 索引 |
| 兼容 | Claude Code / Codex / Antigravity / Gemini CLI / Cursor |
这不是一个 Skill，而是500+ Skills 的索引仓库。收录了 Anthropic、Google Labs、Vercel、Stripe、Cloudflare、Netlify、Trail of Bits、Sentry、Expo、Hugging Face 等大厂团队贡献的高质量 Skills。
| 来源团队 | 代表 Skills |
|---|---|
| Stripe | stripe-best-practices、upgrade-stripe |
| Supabase | postgres-best-practices |
| Google Gemini | Gemini API / Vertex AI 开发指南 |
| Vercel | 部署和开发最佳实践 |
| Cloudflare | Workers / Pages 开发 |
| Trail of Bits | 安全审计 |
⚠️ 千万不要一口气都装下来！ 把它当索引用。
四、Skills 加载机制：全量 vs 按需路由
| 模式 | 工作方法 | 优缺点 |
|---|---|---|
| 全量加载 | 启动时把所有 SKILL.md 一股脑塞进 system prompt | Skills 多了会吃大量 token |
| 按需路由 | 只读 name + description，匹配到才加载完整内容 | 可以多装，token 友好 |
全量加载的工具，Skills 装多了会吃掉大量 token——留给实际对话的空间骤减。按需路由可以多装。
references/ 目录设计
好的 Skill 把详细内容拆到 references/ 子目录：
my-skill/
├── SKILL.md ← 先读这个（短，做路由）
└── references/
├── detailed-guide.md ← 需要时才读
└── anti-patterns.md ← QA 阶段才读主 SKILL.md 越短越好。Superpowers 的 systematic-debugging 有 11 个引用文件，但主文件很短，只在任务匹配时才加载详细指南。
五、怎么选？10 个 Skills 选型决策表
| 你的情况 | 选这个 |
|---|---|
| Coding Agent 写码太随意，需要引入规范 | Superpowers（#1） |
| 想要一套命令系统指挥 Coding Agent | SuperClaude Framework（#2） |
| 需要特定领域指导（前端/全栈/移动端） | MiniMax Skills（#3） |
| 想用官方标准 Skills | Anthropic Official（#4） |
| 做 React/Web 前端想要工程标准 | Vercel Agent Skills（#5） |
| Coding Agent 做长任务忘了最初目标 | Planning with Files（#6） |
| 想深入上下文管理 | Context Engineering（#7） |
| 要对接外部 API 和服务 | Composio Skills（#8） |
| 想学怎么写好 Skills | Antfu Skills（#9） |
| 想看大厂团队都用什么 | Awesome Agent Skills（#10） |
分层建议
层 1：一个 Framework（Superpowers 或 SuperClaude，二选一）
层 2：1-2 个领域 Skill
层 3：Awesome 系列当 Skills 索引，而不要整个装六、自建 Skill SOP
用别人的 Skills 之后，建议自己写一个。回顾你和 Coding Agent 协作最顺畅的那几次，把那套流程固化下来。用 Anthropic 的 skill-creator 来引导编写。
自建 Skill 模板：
my-skill/
├── SKILL.md # name + description（短，路由用）
│ # + 主流程步骤
└── references/ # 详细指南（按需加载）
├── workflow.md
├── anti-patterns.md
└── examples.md七、附录一：11 个 Skills 整合平台
| 平台 | 特点 | 链接 |
|---|---|---|
| Skills.sh | Vercel 出，3.5 万+ 技能包，支持一键安装 | skills.sh |
| SkillsMP | 聚合 GitHub 12.1 万+ 开源技能，AI 语义搜索 | skillsmp.com |
| Agent Skills Me | 人工精选 | agentskills.me |
| agent-skills.md | 6000+ 高频技能 | agent-skills.md |
| Agent Skills Hub | 29,000+ Skills + MCP Servers | agentskillshub.top |
| agent-skills.cc | 从 63,000+ GitHub Skills 精选 1,000+ | agent-skills.cc |
| Claude Marketplaces | Claude Code 插件市场 | claudemarketplaces.com |
| AI Templates | 1000+ Agents / Commands / Skills / MCP | aitmpl.com |
| SkillStore | 中文友好，有安全审查 | skillstore.io |
| Skills Directory | Reddit 社区推荐口碑榜 | skillsdirectory.com |
| SkillHub（腾讯） | 2.2 万+ 技能，国内高速镜像 | skillhub.tencent.com |
八、附录二：9 个推荐 Repo
| 仓库 | 定位 |
|---|---|
| anthropics/skills | Anthropic 官方 Skills |
| obra/superpowers | Superpowers 框架 |
| SuperClaude-Org/SuperClaude_Framework | SuperClaude 命令框架 |
| MiniMax-AI/skills | MiniMax 10 个生产级 Skills |
| VoltAgent/awesome-agent-skills | 500+ Skills 索引 |
| ComposioHQ/skills | Composio MCP + Skills |
| vercel-labs/agent-skills | Vercel 官方 |
| antfu/skills | Antfu 的个人实践 |
| ZhanlinCui/Agent-Skills-Hunter | 大杂烩（400+ Skills） |
九、CalcGuide 视角的 3 个选型建议
- 新团队先装 Superpowers——14 个核心 Skills 覆盖完整工程流水线，比自己拼装效果稳定
- 对接外部服务必装 Composio——MCP + Skills 配合是 2026 年的工程化标配
- 不要贪多——一个 Framework + 1-2 个领域 Skill + Awesome 当索引，足够
AI 辅助写作披露
本文基于社区精选 10 个 Skills 与 Framework 的公开内容，由 CalcGuide 编辑团队重新结构化、补充 2026 时代背景与 CalcGuide 工程化视角。AI 协助资料整理、表格化、命令清单校对。最终观点与场景选型由人类编辑负责。
参考来源：
- 精选 Skills 推荐：10 个让 Coding Agent 如虎添翼的 Skills（社区精选，2026-10）
- Anthropic 官方 Skills 文档
- CalcGuide 编辑团队实战经验