resume-optimizer

这段内容是审核时保存的快照。外部来源才是完整且最新的版本。

---
name: resume-optimizer
description: Professional resume builder with PDF export, ATS optimization, and analysis capabilities. Use when users need to (1) Create new resumes from scratch, (2) Customize/tailor existing resumes for specific roles, (3) Analyze resumes and provide improvement recommendations, (4) Convert resumes to ATS-friendly PDF format. Supports chronological, functional, and combination resume formats.
---

# Resume Optimizer

Build professional, ATS-optimized resumes with PDF export capabilities.

## Capabilities

1. **Create Resumes** - Build new resumes from user information with professional formatting
2. **Customize Resumes** - Tailor existing resumes for specific roles or per user requests
3. **Analyze Resumes** - Review resumes and provide actionable improvement recommendations
4. **Export to PDF** - Generate downloadable, ATS-friendly PDF documents

## Workflow Decision Tree

### Creating a New Resume
1. Gather user information (experience, education, skills, target role)
2. Select appropriate format (see format selection guide below)
3. Read `references/templates.md` for the chosen template
4. Build resume content following `references/best-practices.md`
5. Generate PDF using `scripts/generate_resume_pdf.py`

### Customizing an Existing Resume
1. Review the provided resume content
2. Understand the target role/changes requested
3. Read `references/ats-optimization.md` for keyword integration
4. Apply modifications following best practices
5. Generate updated PDF

### Analyzing a Resume
1. Parse the resume content
2. Check against criteria in `references/analysis-checklist.md`
3. Identify strengths and improvement areas
4. Provide specific, actionable recommendations
5. Optionally offer to implement changes

## Format Selection Guide

**Chronological (Most Common)**
- Use for: Consistent work history in same field, clear career progression
- Best for: Most professionals staying in their field
- Read: `references/templates.md` → Chronological Template section

**Functional**
- Use for: Career changers, employment gaps, emphasizing transferable skills
- Best for: Returning to workforce, diverse experience across fields
- Read: `references/templates.md` → Functional Template section

**Combination**
- Use for: Mid-career professionals balancing skills and progression
- Best for: Diverse skill sets, career changers with relevant experience
- Read: `references/templates.md` → Combination Template section

## PDF Generation

Use the provided script to create professional PDFs:

```bash
python3 scripts/generate_resume_pdf.py \
  --input resume_content.json \
  --output resume.pdf \
  --format chronological
```

The script uses reportlab to create clean, ATS-compatible PDFs with:
- Professional typography (Helvetica)
- Proper margins and spacing (0.75" all sides)
- Clean section headers
- Bullet point formatting
- Consistent visual hierarchy

## Essential References

Before creating any resume, read:
1. `references/best-practices.md` - Core resume writing principles
2. `references/ats-optimization.md` - ATS compatibility requirements
3. `references/templates.md` - Format-specific templates

Before analyzing a resume, read:
1. `references/analysis-checklist.md` - Evaluation criteria and scoring

## Quick Start Examples

**Creating a resume:**
```
User: "Help me build a resume. I have 5 years in marketing."

Steps:
1. Gather: Current role, key achievements, education, certifications
2. Format: Chronological (clear progression in same field)
3. Build: Use template from references/templates.md
4. Keywords: Integrate from job description per ats-optimization.md
5. Export: Generate PDF to /mnt/user-data/outputs/
```

**Tailoring for a role:**
```
User: "Tailor my resume for this job [job description]"

Steps:
1. Parse job description for required skills/keywords
2. Identify gaps between resume and requirements
3. Reorder bullets to lead with relevant achievements
4. Integrate keywords naturally throughout
5. Updat