Initial commit

2025-11-30 08:52:43 +08:00
commit 8a385c425d
8 changed files with 2102 additions and 0 deletions
--- a/skills/employment-application/references/workflow_guidelines.md
+++ b/skills/employment-application/references/workflow_guidelines.md
@@ -0,0 +1,443 @@
+# Employment Application Workflow Guidelines
+
+## Purpose
+
+This document outlines the systematic workflow for analyzing employment opportunities and creating tailored, compelling application documents (cover letters and CVs/resumes).
+
+---
+
+## Core Workflow Process
+
+### Phase 1: Employment Opportunity Analysis
+
+**Objective:** Thoroughly understand the position requirements and organizational expectations.
+
+#### Step 1.1: Advertisement Analysis
+Carefully analyze the provided employment opportunity advertisement, noting:
+
+1. **Position Details**
+   - Full position title and level
+   - Department/team structure
+   - Reporting relationships
+   - Employment type (full-time, contract, etc.)
+
+2. **Core Responsibilities**
+   - Primary duties and accountabilities
+   - Key deliverables expected
+   - Day-to-day activities
+   - Strategic vs. operational balance
+
+3. **Required Qualifications**
+   - Essential educational requirements
+   - Mandatory certifications or licenses
+   - Years of experience required
+   - Specific technical skills
+   - Industry-specific knowledge
+
+4. **Key Selection Criteria**
+   - Explicit criteria listed in advertisement
+   - Weighted or prioritized requirements
+   - "Nice to have" vs. "must have" distinctions
+   - Cultural fit indicators
+
+5. **Organizational Context**
+   - Company size and structure
+   - Industry sector
+   - Organizational values and culture
+   - Current challenges or initiatives mentioned
+
+#### Step 1.2: Requirements Mapping
+Create a structured mapping between:
+- Job requirements → Candidate qualifications (from CV-Collins-Robin-Enhanced.md)
+- Selection criteria → Supporting evidence and achievements
+- Skills gaps → Transferable skills or learning opportunities
+
+---
+
+### Phase 2: Cover Letter Development
+
+**Objective:** Craft a tailored, compelling cover letter that explicitly addresses each selection criterion.
+
+#### Step 2.1: Source Material Review
+Thoroughly review `CV-Collins-Robin-Enhanced.md` and related project documents to identify:
+- Relevant achievements that demonstrate required competencies
+- Quantifiable results that align with role expectations
+- Technical skills and certifications matching job requirements
+- Leadership examples and problem-solving scenarios
+- Industry experience and domain knowledge
+
+#### Step 2.2: Selection Criteria Addressing
+For each key selection criterion:
+
+1. **Explicit Acknowledgment**
+   - Directly reference the criterion
+   - Use similar language to the job advertisement
+   - Show understanding of why this criterion matters
+
+2. **Evidence-Based Response**
+   - Draw specific examples from CV-Collins-Robin-Enhanced.md
+   - Include quantifiable achievements where possible
+   - Demonstrate both breadth and depth of experience
+   - Show progression and growth
+
+3. **Value Proposition**
+   - Connect past achievements to future contributions
+   - Highlight unique qualifications or perspectives
+   - Demonstrate understanding of organizational needs
+
+#### Step 2.3: Cover Letter Structure
+
+**Opening Paragraph**
+- Position being applied for
+- Brief value proposition (2-3 sentences)
+- Enthusiasm for the opportunity
+- How candidate learned about position (if applicable)
+
+**Body Paragraphs (2-4 paragraphs)**
+- Each paragraph addresses 1-2 key selection criteria
+- Lead with criterion/requirement
+- Provide specific evidence from experience
+- Connect to organizational needs
+- Include quantifiable achievements
+- Demonstrate problem-solving and impact
+
+**Closing Paragraph**
+- Reiterate key strengths alignment
+- Express genuine interest in role and organization
+- Call to action (interview request)
+- Thank you for consideration
+- Contact information reference
+
+#### Step 2.4: Tone and Language Best Practices
+
+**Professional and Contemporary**
+- Confident without arrogance
+- Specific without being verbose
+- Achievement-focused without exaggeration
+- Personalized without being informal
+
+**Action-Oriented Language**
+- Use strong action verbs (led, implemented, achieved, drove, transformed)
+- Focus on results and outcomes
+- Demonstrate agency and initiative
+- Show continuous learning and adaptation
+
+**Avoid**
+- Generic platitudes ("I'm a hard worker," "team player")
+- Repetition of CV without adding context
+- Apologetic language or qualification hedging
+- Overly technical jargon without explanation
+- Desperate or presumptuous tones
+
+#### Step 2.5: Quality Assurance Checklist
+
+Before finalizing cover letter, verify:
+- [ ] Each key selection criterion explicitly addressed
+- [ ] Specific examples drawn from CV-Collins-Robin-Enhanced.md
+- [ ] Quantifiable achievements included where possible
+- [ ] Tone aligns with organizational culture (from advertisement analysis)
+- [ ] No grammatical errors or typos
+- [ ] Length appropriate (typically 3-4 paragraphs, 300-500 words)
+- [ ] Contact information matches CV
+- [ ] Personalized for specific role (no generic content)
+- [ ] Value proposition clear and compelling
+
+---
+
+### Phase 3: CV/Resume Update
+
+**Objective:** Ensure CV document aligns with advertised role and incorporates critical supporting information.
+
+#### Step 3.1: Gap Analysis
+Compare CV-Collins-Robin-EnhancedTemplateCondensed.docx against:
+- Information used in cover letter
+- Skills emphasized in job advertisement
+- Achievements highlighted in CV-Collins-Robin-Enhanced.md but missing from condensed CV
+
+#### Step 3.2: Content Enhancement
+Incorporate from CV-Collins-Robin-Enhanced.md:
+- Relevant achievements that strengthen alignment
+- Technical skills matching job requirements
+- Certifications or qualifications newly relevant
+- Project experience demonstrating required competencies
+- Leadership or problem-solving examples
+
+#### Step 3.3: Content Prioritization
+For roles with specific focus areas, consider:
+- Moving relevant sections higher in document
+- Expanding bullet points for directly relevant experience
+- Adding keywords from job advertisement (naturally)
+- Emphasizing transferable skills for career transitions
+
+#### Step 3.4: Styling Compliance
+**CRITICAL:** Ensure final CV conforms to explicit styling guide `CV_Styling_Guide.md`:
+
+**Required Style Elements:**
+- Font: Calibri throughout
+- Brand color: #11217B (professional navy blue)
+- Name: 33pt, bold, brand blue, left-aligned
+- Section headings: 14pt, bold, brand blue, with brand blue underline
+- Contact info: Clickable hyperlinks for email and GitHub
+- Job titles: Structured format (Title | Company | Location | Dates)
+- Project titles: Structured format (Project | Organization | Dates)
+- Body text: 10.5pt, justified alignment
+- Bullet lists: Standard bullet character with proper indentation
+
+**Formatting Validation:**
+- [ ] All styles from CV_Styling_Guide.md correctly applied
+- [ ] Brand blue color (#11217B) used consistently
+- [ ] Structured title formatting for all job/project entries
+- [ ] Clickable hyperlinks in contact information
+- [ ] Section heading underlines present
+- [ ] Proper spacing and indentation throughout
+- [ ] Margins: 1 inch on all sides
+- [ ] Professional, clean, scannable appearance
+
+#### Step 3.5: docx Library Implementation
+When generating or updating CV using docx library:
+
+1. **Required Imports**
+```javascript
+const {
+  Document,
+  Packer,
+  Paragraph,
+  TextRun,
+  AlignmentType,
+  LevelFormat,
+  BorderStyle,
+  ExternalHyperlink
+} = require('docx');
+const fs = require('fs');
+```
+
+2. **Style Definitions**
+Implement all styles from CV_Styling_Guide.md:
+- Name style
+- ContactInfo style
+- SectionHeading style (with bottom border)
+- JobTitle style
+- Body style
+- Bullet list configuration
+
+3. **Content Patterns**
+Follow exact formatting patterns from guide:
+- Job title: Bold blue title | Bold black company | Italic black location | Regular black dates
+- Project title: Bold blue project | Bold black organization | Italic black dates
+- Competency bullets: Bold label + regular description
+- Technical skills: Bold category + technology list
+
+---
+
+### Phase 4: Analysis and Evaluation
+
+**Objective:** Provide detailed assessment and actionable recommendations for improvement.
+
+#### Step 4.1: Cover Letter Analysis
+
+**Strengths Assessment**
+- How well does cover letter address each selection criterion?
+- Quality and relevance of supporting evidence
+- Clarity and persuasiveness of value proposition
+- Alignment with organizational culture and values
+- Professional tone and presentation quality
+
+**Gap Identification**
+- Selection criteria not fully addressed
+- Weak or generic evidence provided
+- Missing quantifiable achievements
+- Opportunities for stronger connections to role requirements
+- Areas where transferable skills could be better articulated
+
+**Competitive Positioning**
+- What makes this application stand out?
+- Unique qualifications or perspectives highlighted
+- Demonstration of understanding beyond job description
+- Evidence of research into organization
+- Alignment with strategic initiatives or challenges
+
+#### Step 4.2: CV/Resume Analysis
+
+**Content Effectiveness**
+- Relevance of featured experience to target role
+- Strength of achievement descriptions
+- Appropriate emphasis on key skills
+- Clarity and scannability for hiring managers/ATS
+- Completeness without unnecessary information
+
+**Formatting Compliance**
+- Adherence to CV_Styling_Guide.md specifications
+- Professional appearance and readability
+- Consistent styling throughout
+- Proper use of brand colors and typography
+- Clickable links and proper structure
+
+**ATS Optimization**
+- Keyword inclusion from job advertisement
+- Standard section headings
+- Simple formatting without tables or graphics
+- Clear job titles and dates
+- Technical skills clearly listed
+
+#### Step 4.3: Recommendations
+
+Provide specific, actionable recommendations in three categories:
+
+**High Priority (Must Address)**
+- Critical gaps in selection criteria coverage
+- Major formatting inconsistencies
+- Weak or missing evidence for key requirements
+- Tone or language issues
+
+**Medium Priority (Should Address)**
+- Opportunities to strengthen evidence
+- Additional relevant achievements to incorporate
+- Minor formatting improvements
+- Enhanced quantification of results
+
+**Low Priority (Nice to Have)**
+- Optional enhancements for differentiation
+- Additional context or detail
+- Stylistic refinements
+- Future application considerations
+
+#### Step 4.4: Evidence-Based Validation
+
+Support all recommendations with:
+- Specific references to job advertisement requirements
+- Examples from CV-Collins-Robin-Enhanced.md that could be used
+- Citations from cover letter or CV sections
+- Industry best practices or hiring manager perspectives
+- Comparison to selection criteria
+
+---
+
+## Output Deliverables
+
+### Required Outputs
+
+1. **Final Cover Letter**
+   - Tailored to specific employment opportunity
+   - Addresses all key selection criteria
+   - Professional tone and structure
+   - 300-500 words typically
+   - Contact information included
+
+2. **Updated CV Document**
+   - CV-Collins-Robin-EnhancedTemplateCondensed.docx updated
+   - Aligned with role requirements
+   - Fully compliant with CV_Styling_Guide.md
+   - Professional, scannable format
+   - Ready for submission
+
+3. **Analysis Report**
+   - Strengths identified
+   - Gaps highlighted
+   - Actionable recommendations provided
+   - Evidence-based validation included
+   - Prioritized improvement suggestions
+
+4. **Source Code Files**
+   - JavaScript files used for document generation
+   - Possible file names: `cover_letter.js`, `updated_cv.js`
+   - Reusable for future applications
+   - Well-commented for maintainability
+   - Following docx library best practices
+
+---
+
+## Best Practices Summary
+
+### Research and Preparation
+- Read job advertisement multiple times for deep understanding
+- Research organization's website, news, and recent initiatives
+- Review CV-Collins-Robin-Enhanced.md thoroughly
+- Map requirements to qualifications systematically
+
+### Writing Excellence
+- Be specific and concrete with examples
+- Quantify achievements whenever possible
+- Use active voice and strong action verbs
+- Demonstrate understanding beyond job description
+- Proofread meticulously
+
+### Technical Execution
+- Follow CV_Styling_Guide.md exactly
+- Use docx library correctly with all required imports
+- Implement consistent formatting patterns
+- Generate clean, professional documents
+- Test output for rendering and compatibility
+
+### Quality Assurance
+- Self-review against all criteria
+- Check for consistency across documents
+- Validate technical implementation
+- Ensure ATS compatibility
+- Verify contact information accuracy
+
+---
+
+## Common Pitfalls to Avoid
+
+1. **Generic Applications**
+   - Failing to tailor to specific role
+   - Using template language without customization
+   - Not addressing organization-specific needs
+
+2. **Poor Evidence**
+   - Vague or unquantified achievements
+   - Irrelevant examples
+   - Repetition without adding value
+
+3. **Formatting Issues**
+   - Inconsistent styling
+   - Non-compliance with CV_Styling_Guide.md
+   - Poor readability or scannability
+   - ATS-unfriendly formatting
+
+4. **Tone Problems**
+   - Too casual or too formal
+   - Arrogant or presumptuous
+   - Apologetic or uncertain
+   - Generic or impersonal
+
+5. **Technical Errors**
+   - Typos or grammatical mistakes
+   - Incorrect contact information
+   - Broken hyperlinks
+   - Formatting bugs in generated documents
+
+---
+
+## Success Criteria
+
+An excellent employment application demonstrates:
+
+1. **Complete Alignment**
+   - Every selection criterion addressed
+   - Evidence strongly supports qualifications
+   - Skills and experience clearly match requirements
+
+2. **Compelling Narrative**
+   - Clear value proposition
+   - Authentic enthusiasm and interest
+   - Demonstration of cultural fit
+   - Unique perspective or approach
+
+3. **Professional Excellence**
+   - Flawless presentation
+   - Appropriate tone and language
+   - Perfect formatting compliance
+   - Error-free execution
+
+4. **Strategic Positioning**
+   - Competitive differentiation
+   - Understanding of organizational context
+   - Forward-looking contribution focus
+   - Memorable and persuasive case
+
+---
+
+**Document Version:** 1.0
+**Last Updated:** 2025-01-18
+**Purpose:** Systematic workflow guide for employment application document creation