⚡ AI Skill 最佳实践

先用起来 > 再选好 > 最后才写 — 一条命令装完三大必装合集，立刻享受生产级 AI 编程

更新于 2026-04-29 · 实战验证 · npx skills add 一键安装 · 7 条 Slash 命令速查

第一梯队 必装 第二梯队 场景必选 第三梯队 轻量高效 免费 全部免费开源
🛤️ 三步路线图：先用 > 再选 > 再写
1
🚀 一键装起来
小白最快路径：npx skills add 一条命令装完三大必装合集，立刻享受生产级 AI 编程。别急着学写，先享受效果。
2
🎯 按场景选装
用起来之后，根据你的场景选装更多。产品管理、前端优化、调试排错……各有所长。
3
✍️ 编写自己的
进阶：现成的不够用，开始定制。掌握 SKILL.md 规范和 Slash 命令，跨工具适配。
🚀 第一步：一条命令装完三大必装合集
💡 核心原则：先用效果说话，再学原理
  • 别从零开始写 — 直接装现成合集，感受 AI 编程效率的质变
  • 三大必装各有侧重 — Addy 管工程流程、Matt 管 TS/前端、Karpathy 管极简思维，互补覆盖 100% 编程需求
  • 选默认 Symlink — 安装时选 Symlink（不要选 Copy），方便后续 git pull 更新
  • 用好了再迭代 — 发现哪些 Skill 最有用，再精简或定制
🏆 三大必装合集 — 为什么要全装？
addyosmani/agent-skills 综合第一 24k+ ★
主打：团队级工程规范、流程管控
作用：写方案、架构评审、安全审计、交付规范、大型项目兜底
✅ 适合：正经业务、后端/架构、交付质量要求高的场景
作者：Addy Osmani（Google Chrome 工程总监），融入《Software Engineering at Google》工程实践
Hyrum's Law 测试金字塔 Trunk-based Development 7 条 Slash 命令
mattpocock/skills TS/前端之王
主打：TS / 前端 / 现代 JS 实操细节、语法最佳实践
作用：类型体操、写法优化、坑点规避、代码精简
✅ 适合：日常写代码、类型纠错、前端/TS 项目提速
场景：写 TS、前端、类型、语法优化 → 用 Matt
TypeScript 深度 前端最佳实践 语法优化
karpathy-skills 极简思维
主打：极简思维、克制设计、通用编程哲学
作用：避免过度设计、做减法、逻辑清晰、AI 少写垃圾冗余代码
✅ 适合：所有项目，全局提升 AI 写代码的「简洁度 & 合理性」
场景：嫌 AI 代码啰嗦、过度设计、逻辑混乱 → 加 Karpathy
极简设计 做减法 抗过度工程
⌨️ 一键安装命令（复制即用）
🟢 三大必装 — 全局安装
# 1. Addy 工程全流程规范（综合第一，必装）
npx skills add addyosmani/agent-skills --global
# 国内加速：
# npx skills add https://gh-proxy.com/github.com/addyosmani/agent-skills --global

# 2. Matt TS/前端最佳实践
npx skills add mattpocock/skills --global
# 国内加速：
# npx skills add https://gh-proxy.com/github.com/mattpocock/skills --global

# 3. Karpathy 极简编程思维
npx skills add https://github.com/forrestchang/andrej-karpathy-skills --global
# 国内加速：
# npx skills add https://gh-proxy.com/github.com/forrestchang/andrej-karpathy-skills --global
⚡ 安装时注意
  • 选 Symlink（推荐），不要选 Copy — 方便后续 git pull 更新
  • 国内网络慢？ — 用 https://gh-proxy.com/github.com/ 前缀加速
  • --global 表示全局安装，所有项目都能用；去掉则只装到当前项目
🔄 更新所有 AI Skills
# 1. 进入全局 Skills 目录
cd ~/.agents/skills   # Windows: C:\Users\你的用户名\.agents\skills

# 2. 拉取最新更新
git pull

# 3. Cursor 用户执行 Reload Skills
# Claude Code 用户重启 claude 即可
⌨️ Slash 命令速查（Addy 合集核心）

安装 Addy 合集后，7 条与开发生命周期对应的 Slash 命令即可使用。此外，各种技能也会根据你所从事的任务自动激活——比如设计 API 时会触发 api-and-interface-design，开发 UI 时会触发 frontend-ui-engineering。

/spec
确定要建造什么 — 代码之前的规格说明
/plan
规划如何建造 — 小型、独立的原子任务
/build
逐步构建/分阶段实现 — 一次切一片就好
/test
证明其确实可行 — 测试就是证明
/review
合并前先审查 — 提升代码质量
/code-simplify
简化代码 — 聪明不如清晰明了
/ship
投入生产 — 更快则更安全
📂 各工具 Skills 目录结构

npx skills add 安装后，Skill 文件会放到对应目录。了解目录结构有助于手动管理。

工具全局目录项目目录
Cursor~/.cursor/skills/.cursor/skills/
Claude Code~/.claude/skills/.claude/skills/
Copilot~/.copilot/skills/.github/skills/
Windsurf~/.windsurf/skills/.windsurf/skills/
Codex~/.codex/skills/.codex/skills/
OpenCode~/.config/opencode/skills/.opencode/skills/
OpenClaw~/.openclaw/skills/skills/
💡 目录小贴士
  • 全局目录 — 所有项目共享的通用 Skill（如 Karpathy 极简思维、Addy 工程规范）
  • 项目目录 — 项目特定的 Skill（如某个 React 项目的组件规范）
  • 优先级 — 项目级 > 全局级；同类 Skill 只保留一个，避免冲突
🎯 第二步：按场景选装 — 实战梯队排名

三大必装搞定后，根据你的场景选装更多。以下是实战验证的梯队排名。

🏆 第一梯队 — 和必装同级，互补最强
TashanGKD/tashan-cursor-skills 执行能力最强
定位：复杂项目、自主执行、自进化 AI 编程
优势：95 个实战技能 + 32 条强制规则，支持 AI 自主拆解任务、自动调试、批量修改
✅ Addy 偏规范，Tashan 偏「动手干活」
安装
npx skills add TashanGKD/tashan-cursor-skills --global
ComposioHQ/awesome-codex-skills 工具调用最强
定位：Codex Skills 精选集，工具调用、API 对接、工作流自动化
优势：联网搜索、调用接口、操作数据库等实战技能，模块化 SKILL.md 结构
✅ 补齐必装合集没有的「对外调用」能力
安装
npx skills add ComposioHQ/awesome-codex-skills --global
📌 第二梯队 — 专精场景，刚需必选
JackyST0/awesome-agent-skills 精选列表 国内
定位：精选的 AI Agent Skills 列表，适用于 Cursor、Claude Code、Copilot 等
包含：api-doc-generator、code-review、debug-helper、git-commit、unit-test-generator
✅ 开发生命周期全覆盖，含中文 README
安装
npx skills add JackyST0/awesome-agent-skills --global
# 国内加速：
# npx skills add https://gh-proxy.com/github.com/JackyST0/awesome-agent-skills --global
shanraisshan/claude-code-best-practice Claude Code 最佳实践 46k+ ★
定位：Claude Code 从「氛围编程」到「智能体工程」的完整指南
包含：Agents、Commands、Skills、Hooks、MCP 等 86+ 实战技巧
✅ Claude Code 深度用户必装
安装
npx skills add shanraisshan/claude-code-best-practice --global
# 国内加速：
# npx skills add https://gh-proxy.com/github.com/shanraisshan/claude-code-best-practice --global
yunshu0909/yunshu_skillshub 产品需求管理 国内
定位：产品需求全流程管理，云舒出品
必装技能：backlog-manager、priority-judge、version-planner、req-change-workflow、prd-doc-writer
推荐装：multi-perspective-analysis、product-naming、project-map-builder、thinking-partner
✅ 产品经理 / 需求管理必装
安装
npx skills add yunshu0909/yunshu_skillshub --global
# 国内加速：
# npx skills add https://gh-proxy.com/github.com/yunshu0909/yunshu_skillshub --global
🪶 第三梯队 — 轻量化、极简高效
Official Skills 1000+ 官方精选
定位：官方 + 社区精选技能集，兼容 Claude Code/Codex/Gemini CLI/Cursor
✅ 想多工具通用？这个覆盖面最广
cursor-handbook 平民王者
定位：日常编码、高频小技能、开箱即用
110+ 条规则/技能：注释、格式化、代码审查、Bug 修复，零学习成本

🎯 场景速选 — 你该装什么？

→
通用开发 / 生产级代码：死守 addyosmani/agent-skills（永远第一）
→
TS / 前端 / 类型优化：搭配 mattpocock/skills
→
嫌 AI 代码啰嗦 / 过度设计：加 karpathy-skills
→
AI 自主干活 / 复杂项目：搭配 tashan-cursor-skills
→
AI 联网 / 调用接口 / 工作流：搭配 ComposioHQ/awesome-codex-skills
→
产品需求管理：搭配 yunshu_skillshub
→
中文开发 / 精选合集：搭配 awesome-agent-skills（含中文 README）
→
最佳实战组合：必装三件套 + 任一场景方案 = 完美
🏪 Skill 市场与商店完整列表
Skills.shAgent 技能发现与分享平台，社区驱动
Skills RankAI Agent 技能排行榜，发现最热门技能
LinSkillsAI Agent 技能导航与分发，七牛云出品，国内直连
ClawSkills.shAgent 技能市场，快速发现可用工具与插件
SkillsMPAgent 技能市场，中文社区技能分享与分发
Skill-CN中文 Agent 技能社区，工具与 Prompt 分享
Claude Code MarketplaceClaude Code 插件/技能市场，原生兼容 Cursor/TRAE
腾讯 SkillHub腾讯 AI 技能市场，Agent 工具与能力注册中心
AgentSkillsHubAgent 技能聚合平台，多框架工具注册与发现
Agent Skills 开放标准SKILL.md 开放标准，26+ 工具兼容
MCP Market SkillsAgent Skills 目录与发现
CocoloopAI Agent 协作与技能共享平台
MiniMax SkillsMiniMax 智能体技能市场，海螺AI工具分发
CryptoSkillsWeb3 + AI Agent 技能市场，链上自动化工具
✍️ 第三步：编写自己的 Skill（进阶）

当现成的 Skill 无法满足你的需求，是时候写自己的了。核心是理解不同工具的配置文件格式。

工具配置文件作用域格式自动加载
Claude CodeSKILL.md / .claude/skills/项目级 / 全局级Markdown✓
Cursor.cursorrules / .cursor/rules/项目级 / 用户级纯文本 / Markdown✓
Codex CLIAGENTS.md项目级Markdown✓
Gemini CLIGEMINI.md项目级 / 全局级Markdown✓
Windsurf.windsurfrules项目级 / 用户级纯文本 / Markdown✓
Copilot.github/copilot-instructions.md仓库级Markdown✓
TRAE.trae/rules/项目级Markdown✓
📝 通用 Skill 模板
通用 SKILL.md 模板 — 直接复制修改
# 项目名称 Skill

## 角色定义
你是一个专业的 [技术栈] 开发者，擅长 [核心能力]。

## 编码规范
- 使用 [语言] 的最新稳定特性
- 遵循 [风格指南] 命名规范
- 优先使用 [库/框架] 解决问题

## 工作流程
1. 需求分析：理解用户意图，确认边界条件
2. 方案设计：先描述方案，确认后再编码
3. 编码实现：按模块逐步实现，每步验证
4. 测试验证：编写对应测试，确保覆盖

## 约束条件
- 不使用已弃用的 API
- 必须处理错误和边界情况
- 代码必须有类型注解（如适用）

## 输出格式
- 修改时只输出变更部分
- 附带简要修改说明
- 标注可能的风险点
🔑 编写 Skill 的 5 个关键技巧
  • 先定角色 — 告诉 AI "你是谁"，比"你要做什么"更有效
  • 约束比指令更重要 — 明确"不能做什么"比"能做什么"更能控制质量
  • 用示例代替描述 — 给 1 个好代码示例 > 写 10 行规范说明
  • 分步优于一次性 — 复杂任务拆成步骤，AI 每步确认再继续
  • 保持精简 — Skill 不是文档，300-500 行以内效果最好
🔄 跨工具适配：一份 Skill 多处使用
一键生成多工具配置文件
# 以 SKILL.md 为蓝本，生成其他工具的配置

# Cursor
cp SKILL.md .cursorrules

# Codex CLI
cp SKILL.md AGENTS.md

# Gemini CLI
cp SKILL.md GEMINI.md

# Windsurf
cp SKILL.md .windsurfrules

# Copilot
mkdir -p .github && cp SKILL.md .github/copilot-instructions.md
💡 跨工具兼容性提示
  • Markdown 格式通用性最好 — 所有工具都支持 Markdown，纯文本次之
  • Cursor 的 Type 字段 — .cursor/rules/ 下支持 type: always（自动加载）和 type: agent_requested（AI 按需读取）
  • 全局 vs 项目 — 通用规范放全局级（如 Karpathy 极简思维），项目特定放项目级
  • agentskills.io 标准 — 想让 Skill 被更多人用，遵循 SKILL.md 开放标准
❓ 常见问题
Skill 和 Prompt 有什么区别？▼
Skill 是结构化的持久化 Prompt。Prompt 是一次性的对话指令，Skill 是保存在文件中、AI 每次启动都会自动加载的行为规范。可以理解为"Prompt 的高级版"——它有角色定义、工作流程、约束条件，而且跨会话生效。
npx skills add 和 git clone 有什么区别？▼
npx skills add 是推荐的统一安装方式，它会自动识别你用的工具（Cursor/Claude Code/Codex 等），把 Skill 放到正确的目录，还支持交互式选择要装哪些。git clone 是手动方式，需要自己管理文件位置。建议优先用 npx skills add。
我该从哪个工具开始用 Skill？▼
推荐从 Claude Code 或 Cursor 开始。这两个工具的 Skill 生态最成熟、社区资源最多。Claude Code 的 SKILL.md 格式最简洁，Cursor 的 .cursorrules 用户量最大。选择你日常用的那个即可。
多个 Skill 会冲突吗？▼
可能会。如果两个 Skill 的指令矛盾（如一个要求用 TypeScript，一个要求用 Python），AI 会困惑。建议：通用规范放全局级，项目特定放项目级；同类 Skill 只保留一个。三大必装合集（Addy/Matt/Karpathy）互补不冲突，可以放心全装。
国内 GitHub 克隆慢怎么办？▼
用 gh-proxy 加速。在 GitHub 仓库 URL 前加 https://gh-proxy.com/ 前缀即可。例如：npx skills add https://gh-proxy.com/github.com/addyosmani/agent-skills --global。也可以用 LinSkills 等国内市场。
怎么更新已安装的 Skill？▼
三步搞定：① cd ~/.agents/skills（Windows: C:\Users\用户名\.agents\skills）② git pull ③ Cursor 用户执行 Reload Skills，Claude Code 用户重启 claude 即可。前提是安装时选了 Symlink 而非 Copy。

AINav · AI Skill 最佳实践 · 返回首页 · Agent横评 · 编程套餐横评

数据仅供参考，以各平台官网为准。如有错误欢迎反馈。