Communitygithub.com

tangshengming/personal_website

Implanta um site estático pessoal já gerado no GitHub Pages. Use quando o usuário pedir para implantar o site, publicar o site Astro gerado, configurar o GitHub Pages, explicar ou atualizar o fluxo de trabalho de implantação do GitHub Actions ou verificar se o site implantado funciona após o envio para o GitHub.

O que é personal_website?

Esta skill automatiza o processo de implantação de um site estático pessoal (construído com Astro) no GitHub Pages, assumindo que o site já foi gerado e está pronto para ser publicado. Ela fornece todas as instruções necessárias para verificar a prontidão do projeto, configurar o fluxo de trabalho do GitHub Actions, commitar e enviar as alterações, configurar as opções do GitHub Pages e verificar se a implantação foi bem-sucedida. A skill é projetada para ser usada com o Claude Code, Cursor ou Codex, e suporta sistemas Windows, macOS e Linux. Ela inclui dicas para lidar com problemas comuns, como avisos de fim de linha do Git, configuração de identidade do usuário e depuração de falhas no GitHub Actions. O fluxo de trabalho pressupõe que o site está em um repositório GitHub e que o usuário deseja implantá-lo usando GitHub Actions, com o caminho base do Astro ajustado automaticamente para builds locais e de produção.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tangshengming/personal_website/tree/HEAD/.codex/skills/deploy-website

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Implantar Site

Visão Geral

Use esta skill para orientar a implantação de um site já gerado no GitHub Pages. O projeto esperado é um site estático Astro armazenado em um repositório GitHub, com arquivos fonte commitados e a implantação gerenciada pelo GitHub Actions.

Esta skill presume que o site em si já existe. Não redesenhe o site a menos que o usuário peça.

Modelo de Implantação

Use esta configuração para o fluxo de trabalho atual do site pessoal:

  • Rastreie o código fonte no Git.
  • Ignore pastas geradas ou de dependência, como node_modules/, dist/, .astro/ e tmp/.
  • Compile o site com npm.cmd run build.
  • Implante do GitHub Actions para o GitHub Pages.
  • Mantenha o desenvolvimento local em http://localhost:4321/.
  • Use um caminho base do Astro apenas durante as compilações do GitHub Actions para URLs de projeto Pages, como https://USERNAME.github.io/REPOSITORY/.

Antes de Implantar

Verifique a prontidão com comandos leves:

git status
npm.cmd run build

Confirme que estes arquivos ou configurações existem:

  • package.json
  • astro.config.mjs
  • .gitignore
  • .github/workflows/deploy.yml
  • src/
  • public/

Para este projeto, astro.config.mjs deve suportar compilações locais e do GitHub Pages, por exemplo:

import { defineConfig } from "astro/config";

const isGithubPagesBuild = process.env.GITHUB_ACTIONS === "true";

export default defineConfig({
  site: "https://USERNAME.github.io",
  base: isGithubPagesBuild ? "/REPOSITORY" : "/",
});

Use auxiliares de URL em páginas/layouts Astro ao vincular a ativos públicos locais ou páginas internas:

const base = import.meta.env.BASE_URL;
const url = (path: string) => {
  const normalizedBase = base.endsWith("/") ? base : `${base}/`;
  const normalizedPath = path.replace(/^\/+/, "");

  return `${normalizedBase}${normalizedPath}`;
};

Fluxo de Trabalho do GitHub Actions

Use um fluxo de trabalho Pages como este:

name: Deploy to GitHub Pages

on:
  push:
    branches: [main]
  workflow_dispatch:

permissions:
  contents: read
  pages: write
  id-token: write

concurrency:
  group: pages
  cancel-in-progress: false

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v7
      - name: Build with Astro
        uses: withastro/action@v6

  deploy:
    needs: build
    runs-on: ubuntu-latest
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    steps:
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v5

Explique as ações de forma simples quando necessário:

  • actions/checkout@v7: baixa o repositório no executor do GitHub Actions.
  • withastro/action@v6: instala dependências, compila o site Astro e prepara o artefato Pages.
  • actions/deploy-pages@v5: publica o artefato compilado no GitHub Pages.

O sufixo @vN fixa uma versão principal da ação.

Repositório e Etapas de Commit

Oriente o usuário a commitar e enviar alterações prontas para implantação:

git status
git add .
git commit -m "Preparar implantação do site"
git push origin main

Se o Git relatar avisos de fim de linha, como LF will be replaced by CRLF, explique que este é um aviso de normalização de fim de linha do Windows e geralmente não bloqueia a implantação.

Se o Git relatar que nenhuma identidade de usuário foi configurada, configure a identidade do repositório ou global antes de commitar. Se a privacidade for importante, use o e-mail noreply do GitHub do usuário.

Configurações do GitHub Pages

Oriente o usuário no GitHub:

  1. Abra o repositório no GitHub.
  2. Vá para Settings.
  3. Vá para Pages.
  4. Em Build and deployment, defina Source como GitHub Actions.
  5. Salve se o GitHub mostrar um botão de salvar.
  6. Vá para a aba Actions e abra a execução de implantação mais recente.
  7. Aguarde até que o fluxo de trabalho seja bem-sucedido.
  8. Abra a URL Pages mostrada pelo GitHub.

Para um site de projeto, a URL esperada é geralmente:

https://USERNAME.github.io/REPOSITORY/

Verificação

Após a implantação, verifique:

  • A página inicial carrega.
  • Os links de navegação funcionam.
  • As imagens carregam.
  • Arquivos para download, como o PDF do currículo, abrem corretamente.
  • A URL do navegador inclui o caminho do repositório para Pages de projeto.
  • Nenhum caminho quebrado como /REPOSITORYprojects, /REPOSITORYprofile.jpg ou /REPOSITORYfile.pdf aparece no HTML gerado.

Se o site implantado estiver quebrado, mas a pré-visualização local funcionar, inspecione o tratamento do caminho base primeiro.

Se o GitHub Actions falhar, inspecione a etapa com falha:

  • Falha no checkout: problema de repositório ou permissão.
  • Falha na instalação/compilação: problema de dependência, Astro ou código fonte.
  • Falha na implantação: problema de fonte/permissão/configuração do GitHub Pages.

Critérios de Conclusão

Considere a tarefa de implantação concluída quando:

  • A compilação local passa.
  • As alterações no código fonte foram commitadas e enviadas.
  • A fonte do GitHub Pages está definida como GitHub Actions.
  • A execução de implantação do Actions é bem-sucedida.
  • A URL pública do Pages carrega o site corretamente.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Habilidades Relacionadas