project/
├── .cursor/
│   └── rules/
│       ├── react-patterns.mdc    # 带frontmatter的规则
│       ├── api-guidelines.md     # 纯markdown规则
│       └── frontend/
│           └── components.md     # 子目录组织
├── AGENTS.md                     # 根目录Agent指令(可选)
└── .cursorrules                  # 旧版(即将废弃)

---
description: "项目通用编码规范"
alwaysApply: true
---

# 编码规范

- 使用 TypeScript 编写所有新文件
- 使用函数式组件和 React Hooks
- 数据库字段使用 snake_case
- API 响应使用 camelCase
- 所有导出函数必须有 JSDoc 注释

---
description: "API 开发规范，适用于 src/api 目录"
alwaysApply: false
globs: ["src/api/**/*.ts", "src/routes/**/*.ts"]
---

# API 开发规范

- 使用 RESTful 命名约定
- 所有端点必须有错误处理中间件
- 返回格式: { success: boolean, data?: T, error?: string }
- 参考 @src/api/template.ts 作为模板

---
description: "单元测试规范。当用户请求编写测试、test、jest、vitest相关内容时应用此规则。"
alwaysApply: false
---

# 测试规范

- 使用 Vitest 作为测试框架
- 测试文件放在 __tests__ 目录
- 命名格式: {filename}.test.ts
- 每个函数至少3个测试用例: 正常、边界、异常

请以简洁风格回复。避免不必要的重复。
使用中文回复技术问题。
优先使用函数式编程范式。

# Project Overview

This is a React + Node.js web application.

## Tech Stack
- Frontend: React 18, TypeScript, Tailwind CSS
- Backend: Node.js, Express, PostgreSQL
- Testing: Jest, React Testing Library

## Coding Standards
- Use semicolons at the end of statements
- Use single quotes for strings
- Use function-based React components
- API responses follow { success, data, error } format

---
applyTo: "src/api/**/*.ts,src/services/**/*.ts"
---

# Backend Development Rules

- Use dependency injection pattern
- All database queries must use parameterized statements
- Implement proper error handling with custom error classes
- Log all API requests with request ID

---
applyTo: "**"
excludeAgent: "code-review"
---
这些指令只会被 Copilot Coding Agent 读取，
Code Review 功能不会使用。

# Coding Standards

- Use Bazel for managing Java dependencies
- JavaScript: double quotes and tabs
- Track work items in Jira
- All commits must reference a ticket number

遵循 @/docs/api-spec.md 中定义的 API 规范。
参考 @templates/service.ts 作为服务模板。

# Code Review Checklist

审查当前文件:
1. 检查错误处理是否完整
2. 验证输入参数校验
3. 评估性能影响
4. 检查安全问题
5. 提出改进建议

将选中的代码重构为 TypeScript:

- 添加完整的类型定义
- 使用接口定义数据结构
- 参考现有类型: [types](../../src/types/index.ts)
- 保持原有功能不变

---
description: 部署到生产环境
---

1. 运行测试确保通过
// turbo
2. npm test

3. 构建生产版本
// turbo
4. npm run build

---
description: 快速测试流程
---
// turbo-all

1. npm install
2. npm test
3. npm run lint

project/
└── .github/
    └── skills/
        └── my-skill/
            ├── SKILL.md        # 主指令文件 (必需)
            ├── scripts/        # 辅助脚本 (可选)
            └── examples/       # 参考实现 (可选)

---
name: web-testing
description: Web应用测试技能。当用户请求编写E2E测试、Playwright、Cypress相关内容时使用。
---

# Web Testing Skill

## When to Use
- 编写端到端测试
- 配置 Playwright/Cypress
- 测试 Web 表单交互

## Instructions
- 使用 Playwright 作为默认测试框架
- 测试文件放在 tests/e2e/ 目录
- 每个页面一个测试文件

---
name: code-review
description: 代码审查技能。当用户请求review、audit、检查代码质量时使用。
---

# Code Review Skill

## When to Use
- 用户请求代码审查
- PR 合并前检查
- 代码质量评估

## Review Checklist
1. **正确性**: 代码是否按预期工作？
2. **边界情况**: 错误条件是否处理？
3. **风格**: 是否符合项目规范？
4. **性能**: 有无明显低效？

## Output Format
提供逐行注释，使用 markdown 格式输出。

.agent/skills/my-skill/
├── SKILL.md        # 主指令文件 (必需)
├── scripts/        # 辅助脚本 (可选)
│   └── helper.py
├── examples/       # 参考实现 (可选)
│   └── sample.ts
└── resources/      # 模板资源 (可选)
    └── template.md

---
name: test-specialist
description: 专门编写和优化测试用例
---

You are a testing specialist focused on:
- Writing comprehensive unit tests
- Improving test coverage
- Optimizing test performance

Always use Jest with TypeScript.
Follow AAA pattern: Arrange, Act, Assert.

---
name: doc-writer
description: 专门编写技术文档和 README
---

You are a documentation specialist.

## Responsibilities
- Write clear README files
- Create API documentation
- Generate usage examples

## Style Guidelines
- Use headings for structure
- Include code examples
- Write concise explanations

@doc-writer 请为这个项目生成 README.md

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_URL": "postgresql://user:pass@localhost:5432/db"
      }
    }
  }
}

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxx"
      }
    }
  }
}