Agent Skills：给你的AI编码Agent装上“工程化大脑” 🧠⚡

# 一个典型的Skill定义示例
skill:
  name: "add-error-boundary"
  description: "为React组件添加错误边界"
  trigger: "当生成新组件或修改现有组件时"
  rules:
    - "必须使用ErrorBoundary组件包裹可能出错的children"
    - "提供fallback UI，包含重试按钮和错误详情"
    - "在componentDidCatch中记录错误到监控系统"
  examples:
    - "// 错误边界组件示例"
    - "class MyErrorBoundary extends React.Component { ... }"

// 没有Skill时，AI可能会生成这样的代码
app.get('/user', (req, res) => {
  const userId = req.query.id;
  const user = db.query(SELECT * FROM users WHERE id = ${userId});
  res.json(user);
});

// 启用Security Skill后，AI会这样写
app.get('/user', (req, res) => {
  const userId = parseInt(req.query.id);
  if (isNaN(userId)) {
    return res.status(400).json({ error: 'Invalid user ID' });
  }
  const user = db.query('SELECT * FROM users WHERE id = ?', [userId]);
  res.json(user);
});

# 启用TDD Skill后，AI会先生成测试
def test_process_payment():
    # 测试失败的情况
    with pytest.raises(ValueError):
        process_payment(None, 100)
    with pytest.raises(ValueError):
        process_payment("valid_card", -50)
    
    # 测试成功的情况
    result = process_payment("valid_card", 100)
    assert result["status"] == "success"

# 然后再生成实现代码
def process_payment(card_number, amount):
    if not card_number:
        raise ValueError("Card number is required")
    if amount <= 0:
        raise ValueError("Amount must be positive")
    # ... 实际支付逻辑

# 克隆项目
git clone https://github.com/addyosmani/agent-skills.git

# 复制规则文件到你的项目根目录
cp agent-skills/cursor/.cursorrules your-project/

# 重启Cursor，AI现在会自动应用这些工程技能

# 在Copilot Chat中输入
@workspace 请应用 "secure-coding-practices" 和 "tdd-mode" 技能包
然后帮我生成一个用户注册的API端点

from agent_skills import SkillManager

# 加载技能包
skills = SkillManager()
skills.load("production-ready")
skills.load("observability")

# 将技能注入到AI的system prompt中
system_prompt = skills.to_system_prompt()
agent = create_agent(system_prompt)

# 现在你的Agent会像资深工程师一样思考

# my-team-skills.yaml
skills:
  - name: "use-our-internal-libs"
    rules:
      - "所有HTTP请求必须使用@company/http-client"
      - "日期处理统一使用dayjs而不是moment"
    examples:
      - "import { httpClient } from '@company/http-client'"
  
  - name: "code-review-checklist"
    rules:
      - "每个函数必须有JSDoc注释"
      - "禁止使用any类型，使用unknown替代"
      - "所有异步操作必须使用try/catch包裹"

# 合并技能包
agent-skills merge --official --custom my-team-skills.yaml --output .cursorrules