Lar
ghe-checkpoint
Emasoft/ghe-marketplace
PUBLIQUE um ponto de verificação de progresso na thread ATUALMENTE ATIVA. Salva o estado do trabalho sem alterar as fases. Requer um thread em andamento já reivindicado. USE ESTA HABILIDADE QUANDO: - O usuário disser “postar um ponto de verificação” ou “salvar meu progresso” - O usuário disser “atualizar a tarefa” ou “registrar o estado atual”- O usuário diz “ponto de verificação” ou “salvar ponto de verificação” - O usuário concluiu um marco e deseja registrá-lo - O usuário encontrou um bloqueador e deseja documentá-lo - O usuário está prestes a fazer uma pausa e deseja salvar o estado - Estado significativo
...Expandir tudoSobre o ghe-checkpoint
A habilidade `ghe-checkpoint` permite que os usuários salvem seu progresso atual em um tópico de issue ativo no GitHub sem avançar as fases do projeto. Ela foi projetada para oferecer uma maneira integrada de registrar o estado do trabalho, marcos e obstáculos, garantindo que o trabalho em andamento seja preservado mesmo que o usuário precise fazer uma pausa ou dar um tempo. Essa habilidade resolve o desafio de perder o controle do progresso incremental durante o desenvolvimento ou o gerenciamento de projetos, facilitando a manutenção de registros precisos do trabalho em tempo real.
Os principais recursos dessa habilidade incluem publicar um ponto de verificação de progresso no tópico ativo no momento, registrar marcos, documentar obstáculos e preservar mudanças significativas de estado. Ela exige estritamente um tópico em andamento já reivindicado e respeita as configurações locais, como `.claude/ghe.local.md`. A habilidade não altera a fase do projeto nem inicia novas tarefas, concentrando-se exclusivamente em capturar o estado atual do trabalho. Além disso, ela segue regras rígidas de relatório, garantindo que todas as atualizações sejam salvas tanto no tópico de issue do GitHub quanto no diretório local `GHE_REPORTS` para total rastreabilidade.
O `ghe-checkpoint` destina-se principalmente a desenvolvedores, gerentes de projeto e equipes técnicas que utilizam o GitHub para acompanhamento de issues e gerenciamento de tarefas. Casos de uso típicos incluem salvar o progresso durante sessões de desenvolvimento, documentar a conclusão de marcos, registrar obstáculos que exigem atenção e manter registros atualizados antes de interromper o trabalho. É especialmente útil em ambientes colaborativos, nos quais vários membros da equipe precisam ter visibilidade do trabalho em andamento e onde manter um histórico preciso do projeto é fundamental.
Perguntas frequentes
Quando devo usar a habilidade `ghe-checkpoint`?
Use essa habilidade sempre que quiser salvar o progresso em um tópico ativo, documentar marcos, registrar bloqueios ou preservar mudanças significativas de estado durante o trabalho. Ela também é útil antes de fazer uma pausa para garantir que o estado do trabalho seja salvo.
Posso usar `ghe-checkpoint` sem um tópico ativo?
Não, a habilidade requer um thread em andamento já reivindicado. Se não houver nenhum thread ativo, você deve primeiro usar a habilidade `ghe-claim` para reivindicar um.
O `ghe-checkpoint` altera a fase do projeto?
Não, essa habilidade apenas salva o estado atual do trabalho sem avançar as fases do projeto. Para passar para a próxima fase, você deve usar a habilidade `ghe-transition`.
Como o `ghe-checkpoint` lida com os relatórios?
Todos os pontos de verificação são publicados tanto no tópico de issues do GitHub quanto salvos localmente no diretório `GHE_REPORTS/` como uma estrutura plana. Os relatórios incluem o texto completo do ponto de verificação, não apenas links.
Posso desativar a criação de pontos de verificação ou a sincronização com bancos de memória?
Sim, a skill respeita as configurações locais em `.claude/ghe.local.md`. Se `enabled` estiver definido como `false`, os pontos de verificação são ignorados; e se `serena_sync` estiver definido como `false`, as atualizações no banco de memória SERENA são ignoradas.
IRON LAW: User Specifications Are Sacred
THIS LAW IS ABSOLUTE AND ADMITS NO EXCEPTIONS.
- Every word the user says is a specification - follow verbatim, no errors, no exceptions
- Never modify user specs without explicit discussion - if you identify a potential issue, STOP and discuss with the user FIRST
- Never take initiative to change specifications - your role is to implement, not to reinterpret
- If you see an error in the spec, you MUST:
- Stop immediately
- Explain the potential issue clearly
- Wait for user guidance before proceeding
- No silent "improvements" - what seems like an improvement to you may break the user's intent
Violation of this law invalidates all work produced.
Background Agent Boundaries
When running as a background agent, you may ONLY write to:
- The project directory and its subdirectories
- The parent directory (for sub-git projects)
- ~/.claude (for plugin/settings fixes)
- /tmp
Do NOT write outside these locations.
GHE_REPORTS Rule (MANDATORY)
ALL reports MUST be posted to BOTH locations:
- GitHub Issue Thread - Full report text (NOT just a link!)
- GHE_REPORTS/ - Same full report text (FLAT structure, no subfolders!)
Report naming: <TIMESTAMP>_<title or description>_(<AGENT>).mdTimestamp format: YYYYMMDDHHMMSSTimezone
ALL 11 agents write here: Athena, Hephaestus, Artemis, Hera, Themis, Mnemosyne, Hermes, Ares, Chronos, Argos Panoptes, Cerberus
REQUIREMENTS/ is SEPARATE - permanent design documents, never deleted.
Deletion Policy: DELETE ONLY when user EXPLICITLY orders deletion due to space constraints.
Settings Awareness
Respects .claude/ghe.local.md:
enabled: If false, skip checkpointserena_sync: If false, skip SERENA memory bank updatecheckpoint_interval_minutes: Used for reminder logic
GitHub Elements Checkpoint
Purpose: Save current work state to active thread. Does NOT change phases.
Precondition
- Must have an active (claimed, in-progress) thread
- If no active thread, use
ghe-claimfirst
When to Use
- Save progress during work
- Document milestones
- Record blockers
- Before ending session
- At meaningful state changes
How to Execute
Step 1: Find active thread
Check for issues assigned to @me with "in-progress" label.
If no active thread found:
- Inform user
- Suggest using
ghe-claimto start work
Step 2: Gather current state
Collect:
- Work log (what was done since last checkpoint)
- Completed tasks
- In-progress tasks
- Pending tasks
- Files changed
- Commits made
- Current branch
- Blockers (if any)
- Next action
Step 3: Post checkpoint
Spawn appropriate thread manager based on thread type:
dev→ dev-thread-managertest→ test-thread-managerreview→ review-thread-manager
The thread manager will post formatted checkpoint to issue.
Step 4: Sync memory
Spawn memory-sync agent to update activeContext.md.
Checkpoint Format
## [<TYPE> Session N] DATE TIME UTC - @me### Work Log- [HH:MM] Action 1- [HH:MM] Action 2### State Snapshot#### Thread Type<dev | test | review>#### Completed- [x] Task 1#### In Progress- [ ] Task 2 (N% complete)#### Pending- [ ] Task 3#### Files Changed| File | Changes |#### Commits| Hash | Message |#### Branch`feature/branch-name`#### Blockers[None | List]#### Next Action[Specific next step]### Scope Reminder[Phase-specific abilities and limits]
Output
Confirmation that:
- Checkpoint posted to issue
- Memory bank updated
Key Differentiator
This skill SAVES progress without changing phases. To COMPLETE current phase and MOVE to next, use ghe-transition instead.
Instalar ghe-checkpoint
Baixe e descompacte os arquivos de habilidades no diretório .claude/skills/.
Baixar ZIPClone o repositório e copie os arquivos da habilidade para o seu projeto.
git clone https://github.com/Emasoft/ghe-marketplace/blob/main/plugins/ghe/skills/ghe-checkpoint/SKILL.md # Copy SKILL.md to your .claude/skills/ directory
Copiar
