AI Agent Skills 完整指南

一、统一 Skills 目录结构（推荐）

推荐统一使用：

.ai-skills/

统一同步到：

• Cursor
• Claude Code
• GPT Codex
• Antigravity
• OpenCode
• Continue
• Aider

二、推荐目录结构

project-root/
│
├── .ai-skills/
│   ├── grill-me.md
│   ├── frontend-design.md
│   ├── opsx-propose.md
│   ├── opsx-apply.md
│   ├── opsx-explore.md
│   ├── opsx-archive.md
│   ├── task-planner.md
│   ├── code-review.md
│   ├── bug-hunter.md
│   ├── refactor.md
│   ├── api-design.md
│   ├── db-design.md
│   ├── dockerize.md
│   ├── ci-cd.md
│   ├── security-audit.md
│   ├── perf-optimize.md
│   ├── websocket-design.md
│   ├── mobile-responsive.md
│   ├── ui-polish.md
│   └── docs-gen.md
│
├── .cursor/
├── .claude/
├── .codex/
├── .antigravity/
├── .opencode/
├── .continue/
└── .aider/

三、核心 Skills（推荐）

四、推荐 Skill 用途分类

1. 架构设计类

2. 开发实现类

3. UI / 前端类

4. 测试 / 质量类

五、全部 Skills 自动安装（推荐）

Linux / macOS

mkdir -p .ai-skills
mkdir -p .cursor/commands
mkdir -p .claude/commands
mkdir -p .codex/commands
mkdir -p .antigravity/commands
mkdir -p .opencode/commands
mkdir -p .continue/prompts
mkdir -p .aider/prompts

git clone https://github.com/openagentx/ai-agent-skills.git .ai-skills

cp -R .ai-skills/* .cursor/commands/
cp -R .ai-skills/* .claude/commands/
cp -R .ai-skills/* .codex/commands/
cp -R .ai-skills/* .antigravity/commands/
cp -R .ai-skills/* .opencode/commands/
cp -R .ai-skills/* .continue/prompts/
cp -R .ai-skills/* .aider/prompts/

Windows PowerShell

mkdir .ai-skills

mkdir .cursor\commands
mkdir .claude\commands
mkdir .codex\commands
mkdir .antigravity\commands
mkdir .opencode\commands
mkdir .continue\prompts
mkdir .aider\prompts

git clone https://github.com/openagentx/ai-agent-skills.git .ai-skills

Copy-Item .ai-skills\* .cursor\commands -Recurse
Copy-Item .ai-skills\* .claude\commands -Recurse
Copy-Item .ai-skills\* .codex\commands -Recurse
Copy-Item .ai-skills\* .antigravity\commands -Recurse
Copy-Item .ai-skills\* .opencode\commands -Recurse
Copy-Item .ai-skills\* .continue\prompts -Recurse
Copy-Item .ai-skills\* .aider\prompts -Recurse

六、自动同步脚本（推荐）

sync-skills.sh

#!/bin/bash

TARGETS=(
".cursor/commands"
".claude/commands"
".codex/commands"
".antigravity/commands"
".opencode/commands"
".continue/prompts"
".aider/prompts"
)

for target in "${TARGETS[@]}"
do
    mkdir -p "$target"
    cp -R .ai-skills/* "$target/"
done

echo "AI Skills synced."

七、各 Agent 客户端适配

八、推荐工作流

1. 技术探索

/opsx-explore

2. 架构拷打

/grill-me

3. 生成规格

/opsx-propose

生成：

• proposal
• design
• specs
• tasks

4. UI 设计

/frontend-design

5. 自动实现

/opsx-apply

6. 阶段归档

/opsx-archive

九、推荐组合

小项目

task-planner
frontend-design

中型项目

task-planner
grill-me
frontend-design

大型项目

opsx-explore
grill-me
opsx-propose
frontend-design
opsx-apply
opsx-archive

十、推荐开发模式

推荐：

Explore
→ Grill
→ Propose
→ Design
→ Apply
→ Archive

避免：

直接让 AI 一次性生成完整项目

Spec-Driven Development 是大型 AI Agent 项目最稳定的开发模式。