Habilidade de Atualização de Wiki
Atualize as seções de prosa escritas à mão das páginas wiki para refletir o estado atual do código fonte. Blocos de métricas/dados gerados são gerenciados pelo orquestrador e nunca devem ser tocados.
Quando Invocar
- O usuário digita
/update-wiki— atualiza todas as páginas com blocos de prosa - O usuário digita
/update-wiki Architecture— atualiza apenaswiki/Architecture.md - O usuário diz "atualizar prosa da wiki", "atualizar narrativa de onboarding", "reescrever documentos de arquitetura"
- Após uma refatoração significativa que altere a narrativa do design do sistema
O Que Esta Habilidade Faz (Passo a Passo)
-
Determinar escopo. Se um argumento com nome de página foi fornecido (ex.:
Architecture), resolva parawiki/{NomeDaPagina}.md. Caso contrário, enfileire todas as páginas com prosa listadas abaixo. -
Para cada página alvo: a. Leia o arquivo da página wiki. b. Identifique cada bloco
<!-- claude:prose -->...<!-- claude:prose:end -->. c. Leia os arquivos fonte relevantes listados no registro de páginas abaixo para construir contexto. d. Reescreva o conteúdo entre os marcadores para que ele reflita com precisão o estado atual do código fonte — mantenha a mesma estrutura geral (cabeçalhos, ordem dos parágrafos) a menos que esteja factualmente incorreta. e. Escreva o conteúdo atualizado de volta ao arquivo, preservando exatamente os marcadores. -
Nunca toque nos blocos gerados. Qualquer conteúdo dentro de
<!-- generated:start -->...<!-- generated:end -->deve permanecer idêntico byte por byte. Esses blocos são mantidos pelo script orquestrador da wiki. -
Log de Decisões de Arquitetura é totalmente gerenciado pelo Claude.
wiki/Architecture-Decision-Log.mdnão tem blocosgeneratednem marcadoresclaude:prose. O Claude mantém o arquivo inteiro. Ao atualizar, acrescente novas entradas de ADL para quaisquer decisões arquiteturais tomadas desde a última entrada registrada. Não modifique entradas existentes. -
Prompt de commit. Depois que todas as páginas forem atualizadas, lembre o usuário:
"Prosa da wiki atualizada. Execute
/commitpara salvar as alterações e então fazer push para o repositório remoto da wiki."
Páginas com Prosa e Seus Arquivos Fonte
wiki/Architecture.md
Propósito do bloco de prosa: Narrativa de design do sistema — explica responsabilidades dos módulos, fluxo de dados e como o site estático + agente de chat Lambda se encaixam.
Arquivos fonte relevantes para ler:
WebContent/js/main.jsWebContent/js/filter.jsWebContent/js/carousel.jsWebContent/js/utils.jslambda/lambda_function.pyindex.html(para contexto da estrutura da página)projects.html(para contexto da estrutura da página)
wiki/Lambda-Chat-Agent.md
Propósito do bloco de prosa: Fundamentação do design do agente — explica a arquitetura Lambda, carregamento da base de conhecimento, construção do prompt e tratamento de respostas.
Arquivos fonte relevantes para ler:
lambda/lambda_function.pylambda/context/(todos os arquivos.md, se presentes)
wiki/Contributing.md
Propósito do bloco de prosa: Narrativa de onboarding — explica o fluxo de trabalho de desenvolvimento, filosofia de teste e convenções do projeto para novos contribuidores.
Arquivos fonte relevantes para ler:
CLAUDE.mdMakefilepackage.jsonpyproject.toml.github/workflows/ci-cd.yml
wiki/Architecture-Decision-Log.md
Tratamento especial: Sem marcadores claude:prose. O Claude é dono do arquivo inteiro.
Acrescente novas entradas de ADL; nunca modifique as existentes.
Arquivos fonte relevantes para ler:
- Revise o log recente do git para alterações arquiteturais significativas
CLAUDE.mdpara decisões atuais de ferramentaslambda/lambda_function.pypara decisões de backend
Regras de Preservação de Marcadores
<!-- claude:prose -->
[Claude reescreve este conteúdo]
<!-- claude:prose:end -->
<!-- generated:start -->
[NUNCA TOQUE — dados gerenciados pelo orquestrador]
<!-- generated:end -->
- Os marcadores de abertura e fechamento devem aparecer em suas próprias linhas, inalterados.
- Não adicione linhas em branco extras imediatamente dentro dos marcadores.
- Não aninhe marcadores.
Aviso
NUNCA modifique blocos <!-- generated:start --> ... <!-- generated:end -->.
Esses blocos contêm métricas e tabelas geradas automaticamente pelo orquestrador
da wiki. Modificá-los fará com que a próxima execução do orquestrador produza
um conflito de mesclagem ou sobrescreva silenciosamente suas alterações.