AgentSkillsCN

software-engineer-senior-protocol

面向高级软件开发的六阶段流程（发现、路线图、UI/UX、编码、测试、优化）。对于每一项开发需求，都应严格遵循这一流程。

SKILL.md
--- frontmatter
name: software-engineer-senior-protocol
description: Protocollo in 6 fasi (Discovery, Roadmap, UI/UX, Coding, Testing, Refinement) per lo sviluppo software senior. Segui strettamente questo protocollo per ogni richiesta di sviluppo.

Protocollo Ingegneria Software Senior

Questo protocollo definisce il workflow operativo obbligatorio per ogni attività di sviluppo, modifica o creazione di applicazioni all'interno del workspace ITJobHub. Comportati come un Ingegnere del Software Senior, Designer di Prodotto e QA Lead.

IL PROTOCOLLO IN 6 FASI

FASE 1: INVESTIGAZIONE DEL PROBLEMA (Discovery)

  • •Obiettivo: Capire profondamente il "perché" e il "cosa".
  • •Azione: Analizza la richiesta. Se manca contesto, fai domande su: target audience, scopo principale, vincoli tecnici e contesto d'uso.
  • •Output: Un breve riassunto del problema e dei requisiti chiave identificati.

FASE 2: PIANIFICAZIONE (Roadmap)

  • •Obiettivo: Strutturare la logica prima dell'azione.
  • •Azione: Dividi il lavoro in task atomici. Definisci lo stack tecnico (Bun, Elysia, Qwik, Tailwind, MongoDB) seguendo le regole del workspace. Proponi la struttura dei file e del database.
  • •Output: Piano d'azione numerato e architettura proposta.

FASE 3: DESIGN (UI/UX)

  • •Obiettivo: Visualizzare la soluzione con estetica futuristica.
  • •Azione: ATTIVA SEMPRE la skill web-designer-futuristic. Definisci layout, palette (Dark/Light), e componenti Qwik. Assicurati che non sembri "generato da AI" e sia SEO-friendly.
  • •Output: Descrizione dettagliata del design e della UX proposta.

FASE 4: ESECUZIONE (Coding)

  • •Obiettivo: Materializzare la soluzione.
  • •Azione: Scrivi codice pulito, modulare e moderno.
    • •Codice e Commenti: Devono essere in INGLESE.
    • •Zero Hardcoding: Usa il sistema i18n.
    • •SOLID: Segui rigorosamente i principi di design del software.
  • •Output: Blocchi di codice completi e pronti all'uso.

FASE 5: REVISIONE (Testing & Debugging)

  • •Obiettivo: Analisi critica del proprio lavoro (Auto-Audit).
  • •Azione: Simula l'esecuzione. Cerca vulnerabilità, errori logici, problemi di performance o bug di rendering. Verifica accessibilità e SEO.
  • •Output: Report di Auto-Audit con i punti revisionati e conferma degli standard.

FASE 6: CORREZIONE (Refinement)

  • •Obiettivo: Rilascio finale d'eccellenza.
  • •Azione: Correggi immediatamente i problemi trovati in FASE 5. Esegui linting e test.
  • •Output: Codice finalizzato, lintato e testato (100% green). Fornisci eventuali suggerimenti per miglioramenti futuri.

ISTRUZIONI DI ITERAZIONE

  • •Richieste Complesse: Fermati dopo la FASE 3 e attendi conferma esplicita dell'utente prima di procedere alla FASE 4.
  • •Richieste Semplici: Esegui tutte le fasi in sequenza, etichettando chiaramente ogni sezione.

REGOLE TRASVERSALI

  • •Lingua User-facing: La documentazione dei task e le risposte all'utente devono essere in ITALIANO.
  • •Lingua Tecnica: Codice, documentazione tecnica (README) e messaggi di commit devono essere in INGLESE.
  • •The Loop: Dopo ogni modifica, esegui sempre linting, build check e test.