# 在 .cursorrules 中引用技能文件
source ~/.agent-skills/python-flask.sh
source ~/.agent-skills/git-commit.sh

# AI Agent 技能指令包

## 通用规则
- 所有代码必须包含类型注解（Python）或类型声明（TypeScript）
- 每个函数/方法必须有 docstring 或 JSDoc，说明用途、参数、返回值
- 捕获所有可预见的异常，并返回结构化的错误响应
- 禁止硬编码密钥或敏感信息，必须通过环境变量获取
- 单元测试覆盖率不低于 80%，测试放在 tests/ 目录

## 语言/框架特定规则
- Python: 使用 Pydantic 进行数据验证，使用 `pathlib` 处理路径
- TypeScript: 严格模式启用，使用 `zod` 进行运行时校验
- React: 使用函数组件和 Hooks，避免 class 组件

## 工作流程
1. 在实现之前，先写测试用例（TDD 风格）
2. 每次提交前，运行 `npm run lint` 和 `npm test`
3. 代码变更后，更新相关文档

# install-skill.sh — 一键安装多个技能
#!/bin/bash
SKILLS_DIR="$HOME/.agent-skills"
mkdir -p "$SKILLS_DIR"

# 创建 Flask API 技能
cat > "$SKILLS_DIR/flask-api.sh" << 'SKILL'
SKILL_NAME="flask-api"
SKILL_DESC="Professional Flask API with Blueprints, Pydantic, error handling"
SKILL_RULES=$(cat <<RULES
- Use Flask Blueprints to organize routes by module
- Define request/response schemas with Pydantic
- Wrap endpoints in try/except, return JSON with status_code
- Add health-check endpoint at /health
- Type hint all function parameters and return values
RULES
)
export SKILL_RULES
SKILL

# 创建 Git 提交技能
cat > "$SKILLS_DIR/git-commit.sh" << 'SKILL'
SKILL_NAME="git-commit"
SKILL_DESC="Conventional commit message format"
SKILL_RULES=$(cat <<RULES
- Format: <type>(<scope>): <description>
- Types: feat | fix | docs | style | refactor | test | chore
- Use imperative mood, no period at end
- Keep first line under 72 characters
RULES
)
export SKILL_RULES
SKILL

# 加载所有技能
for f in "$SKILLS_DIR"/*.sh; do source "$f"; done

@app.route('/users')
def get_users():
    users = User.query.all()
    return jsonify(users)

from flask import Blueprint, jsonify
from pydantic import BaseModel
from typing import List
from your_project.extensions import db
from your_project.models.user import User
from your_project.errors import APIError

user_bp = Blueprint('users', __name__, url_prefix='/api/v1/users')

class UserResponse(BaseModel):
    id: int
    name: str
    email: str

class UserListResponse(BaseModel):
    code: int = 0
    data: List[UserResponse]

@user_bp.route('/', methods=['GET'])
def get_users() -> tuple:
    """返回所有用户列表"""
    try:
        users = User.query.all()
        response = UserListResponse(
            data=[UserResponse(id=u.id, name=u.name, email=u.email) for u in users]
        )
        return jsonify(response.model_dump()), 200
    except Exception as e:
        raise APIError(str(e), status_code=500)