XuanJi AI Fortune System

This skill configures Cursor for building AI-powered fortune telling systems based on Google's Gemini API, with strict TypeScript/React conventions and Next.js best practices.

Project Structure

Enforce the following directory organization:

Source Directory (`src/`)

Additional Directories

File Naming Conventions

Apply these naming rules strictly:

1. **Components**: PascalCase with `.tsx` extension (e.g., `FortuneCard.tsx`)

2. **Pages**: kebab-case with `.tsx` extension (e.g., `fortune-reading.tsx`)

3. **Library files**: camelCase with `.ts` extension (e.g., `geminiClient.ts`)

4. **Type definitions**: PascalCase with `.types.ts` suffix (e.g., `Fortune.types.ts`)

5. **Test files**: Match source file name with `.test.ts` suffix (e.g., `geminiClient.test.ts`)

6. **Style modules**: Match component name with `.module.css` suffix (e.g., `FortuneCard.module.css`)

Code Style Standards

TypeScript Configuration

React Component Guidelines

Import Order

Organize imports in this exact sequence:

1. React imports

2. Next.js imports

3. External library imports

4. Internal/relative imports

5. Style imports

Example:

```typescript

import { useState } from 'react';

import { useRouter } from 'next/router';

import axios from 'axios';

import { FortuneService } from '@/lib/fortuneService';

import styles from './Fortune.module.css';

```

Documentation Requirements

Components

Example:

```typescript

/**

* FortuneCard displays a fortune reading result

*

* @example

* <FortuneCard

* result="Your fortune shows great prosperity"

* timestamp={new Date()}

* />

*/

interface FortuneCardProps {

result: string;

timestamp: Date;

}

export function FortuneCard({ result, timestamp }: FortuneCardProps) {

// Implementation

}

```

Functions

Example:

```typescript

/**

* Fetches fortune prediction from Gemini API

*

* @param birthDate - User's birth date in ISO format

* @param question - Fortune telling question

* @returns Promise resolving to fortune reading text

* @throws Error if API call fails

*/

async function getFortune(birthDate: string, question: string): Promise<string> {

// Implementation

}

```

API Routes

Example:

```typescript

/**

* POST /api/fortune

*

* Request: { birthDate: string, question: string }

* Response: { fortune: string, timestamp: string }

*

* Errors:

* - 400: Invalid request payload

* - 500: Gemini API failure

*/

```

File Type Guidelines

Reference Files

This ruleset references external configuration files:

Ensure these files exist in your project if referenced by your tooling.

Key Principles

1. **Type Safety**: Leverage TypeScript's strict mode for maximum type safety

2. **Component Isolation**: Keep components small, focused, and reusable

3. **Documentation First**: Write documentation as you code, not after

4. **Consistent Naming**: Follow naming conventions without exception

5. **Structured Organization**: Maintain clear directory hierarchy

Usage Notes

This skill is optimized for:

When generating code, always validate against these rules and auto-format according to the specified conventions.