rdd-pattern-extractor
Extrai padrões reutilizáveis de retrospectivas de projetos e os documenta no `accumulation/patterns/` do pack ativo da organização (ex.: `packs/<pack-ativo>/accumulation/patterns/`). Acumula referências de múltiplos projetos no mesmo padrão. Atualiza INDEX.md automaticamente. Invocada por rdd-project-retrospective ou manualmente via "extrair padrões", "pattern library", "documentar padrão". Mantém staleness por item — coluna `data_ultima_revisao` (MP-03: validade temporal) e invalidação por contradição — `status: ativo | superado` + `superado_por` (P-05/MP-13: conflito invalida, idade não).
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-04
- Stars
- ★ 4
- Forks
- 1
01 前言 Front Matter
- name
- rdd-pattern-extractor
- description
- Extrai padrões reutilizáveis de retrospectivas de projetos e os documenta no `accumulation/patterns/` do pack ativo da organização (ex.: `packs/<pack-ativo>/accumulation/patterns/`). Acumula referências de múltiplos projetos no mesmo padrão. Atualiza INDEX.md automaticamente. Invocada por rdd-project-retrospective ou manualmente via "extrair padrões", "pattern library", "documentar padrão". Mantém staleness por item — coluna `data_ultima_revisao` (MP-03: validade temporal) e invalidação por contradição — `status: ativo | superado` + `superado_por` (P-05/MP-13: conflito invalida, idade não).
03 SKILL.md 正文
rdd-pattern-extractor — Extrator de Padrões
Extrai padrões reutilizáveis de retrospectivas de projetos e os
documenta na pattern library. Cada padrão é um documento em
accumulation/patterns/<tipo>/<slug>/PATTERN.md do pack ativo da organização
(ex.: packs/<pack-ativo>/accumulation/patterns/) que acumula referências de
múltiplos projetos. Tipos de padrão: processo | arquitetura | codigo | ui | teste | dados.
Fronteira com stack playbooks (evitar duplicação)
- Playbook (
rdd-stack-dotnet-csharp,rdd-stack-java-quarkus,rdd-stack-rust,rdd-stack-angular): convenções GERAIS da stack (estrutura, comandos, pitfalls) — valem sempre, lidas no dev. - Pattern: solução de um CENÁRIO específico, idealmente multi-stack — consultada sob demanda.
- Regra: se vale para a stack inteira, sempre → playbook; se é resposta a um cenário → pattern.
Resolução de destino (IMP-061/IMP-111)
Todos os accumulation/patterns/ referidos nesta skill são relativos ao
accumulation/ do pack ativo da organização (ex.: packs/<pack-ativo>/accumulation/
— resolução via packs: do client-profile), sinalizado pelo bloco
<!-- rdd-pack-accumulation --> do AGENTS.md global:
- Bloco presente (pack ativo configurado) → destino =
packs/<pack-ativo>/accumulation/patterns/. - Bloco ausente → pergunte ao usuário via
questionqual é o pack ativo (instalado empacks/<id>/) e sugira configurar o bloco. Nunca use~/.config/opencode/docs/como destino — a config do RDD é genérica/portável, sem conteúdo de negócio. - Exceção sandbox de eval: resolva os paths relativos à raiz do sandbox
(fixtures usam
docs/relativo).
Lê (upstream)
docs/projects/*/RETROSPECTIVE.md— fonte de padrõesaccumulation/patterns/INDEX.mddo pack ativo — índice atual de padrõesaccumulation/patterns/<tipo>/*/PATTERN.md— padrões existentes (para merge)~/.config/opencode/knowledge/knowledge-management/KNOWLEDGE.md— fundação do domínio (MP-03: staleness é atributo do ITEM, não da store)
Gera (downstream)
accumulation/patterns/<tipo>/<slug>/PATTERN.mddo pack ativo — novo padrão ou atualizaçãoaccumulation/patterns/INDEX.mddo pack ativo — índice atualizado
Nunca edita
- Retrospectivas (read-only)
- Código-fonte de projetos
Tools
read/glob/grep— ler retrospectivas e padrões existenteswrite— criar/atualizar padrões e índicequestion— perguntar ao usuário (padrão muito similar a existente; destino do acúmulo quando o pack ativo não estiver configurado — blocordd-pack-accumulationausente — IMP-061/IMP-111)
Workflow
Passo 1 — Ler retrospectivas
Leia todas as retrospectivas disponíveis:
docs/projects/*/RETROSPECTIVE.md
Para cada retrospectiva, extraia a seção "Padrões extraídos".
Passo 2 — Identificar padrões novos vs existentes
Para cada padrão extraído:
- Classifique o Tipo:
processo | arquitetura | codigo | ui | teste | dados - Normalizar o nome (slug:
kebab-case) - Verificar se
accumulation/patterns/<tipo>/<slug>/PATTERN.mddo pack ativo já existe - Detecção de conflito (P-05/MP-13 — invalidação por contradição): se o
padrão novo tem o MESMO domínio-problema/gatilho de um existente com
abordagem CONTRADITÓRIA, não crie duplicado nem sobrescreva: marque o
antigo
status: superado+superado_por: <novo padrão>no PATTERN.md e no INDEX, preservando arquivo/histórico (Zep:invalid_at, nunca delete). Idade >6m segue sendo apenas GATILHO DE REVISÃO — conflito é o que invalida, não o tempo. - Se existe (sem conflito): adicionar novo projeto de referência e
atualizar
data_ultima_revisaopara a data da revisão (AAAA-MM-DD) - Se não existe: criar novo padrão
Passo 3 — Criar/atualizar padrão
Template de padrão:
# <Nome do Padrão>
**Categoria:** <autenticação | paginação | erros | validação | multi-tenancy | data-model | api-design | testes | deployment | outros>
**Tipo:** <processo | arquitetura | codigo | ui | teste | dados>
**Projetos que usaram:** <lista com datas>
**Stacks aplicáveis:** <dotnet | java | rust | angular | all>
**Maturidade:** <novo | validado | consolidado>
**Última revisão:** <AAAA-MM-DD — preencher na criação; atualizar a cada revisão>
**Status:** <ativo | superado — ativo por padrão>
**Superado por:** <slug do padrão que o invalidou — `—` quando vazio (padrão)>
**Evidência:** <repo/PR/DEC-XXX onde foi aplicado — alimenta a maturidade>
## Cenário
<para Tipo codigo/ui/teste: o cenário específico que dispara o padrão ("quando o endpoint precisa ser idempotente...") — para Tipo processo, funde com a Descrição>
## Descrição
<quando usar este padrão, qual problema resolve>
## Implementação
<para Tipo codigo/ui/teste: código compilável por stack — OBRIGATÓRIO ao menos na stack principal onde surgiu>
### <Stack 1> (ex: .NET C#)
```csharp
// código exemplo
<Stack 2> (ex: Java/Quarkus)
// código exemplo
Quando NÃO usar
<anti-patterns, situações onde este padrão não se aplica>
Variações
<variações do padrão por contexto>
Referências
- Retrospectiva:
docs/projects/<projeto1>/RETROSPECTIVE.md - Retrospectiva:
docs/projects/<projeto2>/RETROSPECTIVE.md - Evidência de aplicação: repo/PR/DEC (obrigatório para promover maturidade)
- Links externos (se aplicável)
**`data_ultima_revisao` (MP-03 — validade temporal, padrão Zep):** staleness é
atributo do ITEM, não da store — preenchida na criação do padrão e atualizada
a cada revisão; nunca removida (merge incremental preserva entradas). É a
coluna que permite identificar no INDEX padrões sem revisão há mais de 6 meses.
**`status` / `superado_por` (P-05 — invalidação por contradição; MP-13):** a
verdade do padrão resolve-se por CONTRADIÇÃO, não por idade: padrão novo com
o mesmo domínio-problema/gatilho e abordagem contraditória marca o antigo
como `superado` apontando `superado_por: <novo>`, com arquivo e histórico
preservados (Zep: `invalid_at`, nunca delete). Idade >6m
(`data_ultima_revisao`) é apenas gatilho de revisão — nunca veredito de
verdade.
### Passo 4 — Classificar maturidade
| Projetos | Maturidade |
|----------|------------|
| 1 | `novo` |
| 2-3 | `validado` |
| 4+ | `consolidado` |
### Passo 5 — Atualizar INDEX.md
Gere/atualize `accumulation/patterns/INDEX.md` do pack ativo:
```markdown
# Pattern Library — <pack-ativo> (accumulation/patterns)
> Padrões reutilizados extraídos de retrospectivas de projetos.
> Atualizado automaticamente por `rdd-pattern-extractor`.
> Staleness (MP-03): idade (`data_ultima_revisao` > 6m) = GATILHO de revisão,
> nunca veredito de verdade (P-05). Verdade resolve-se por invalidação por
> contradição: conflito detectado marca o antigo `status: superado` +
> `superado_por` — histórico preservado, nunca delete (MP-13).
## Índice
| Padrão | Tipo | Categoria | Projetos | Maturidade | data_ultima_revisao | status |
|--------|------|-----------|----------|------------|---------------------|--------|
| [jwt-auth](codigo/jwt-auth/PATTERN.md) | codigo | autenticação | Arbor, Salon | consolidado | 2026-01-15 | ativo |
| [api-pagination](codigo/api-pagination/PATTERN.md) | codigo | api-design | Arbor | novo | 2026-02-01 | ativo |
| [adaptacao-produto-irmao](processo/adaptacao-produto-irmao/PATTERN.md) | processo | outros | Salon | novo | 2026-02-10 | ativo |
## Por Tipo
### Processo
- [adaptacao-produto-irmao](processo/adaptacao-produto-irmao/PATTERN.md) — reaproveitar design de produto-irmão (revisão: 2026-02-10)
- <padrão invalidado> — <descrição> (revisão: AAAA-MM-DD) [superado por <novo-padrão>]
### Arquitetura
- <padrão> — <descrição> (revisão: AAAA-MM-DD)
### Código
- [jwt-auth](codigo/jwt-auth/PATTERN.md) — JWT com refresh token (revisão: 2026-01-15)
### UI
- <padrão> — <descrição> (revisão: AAAA-MM-DD)
### Teste
- <padrão> — <descrição> (revisão: AAAA-MM-DD)
### Dados
- [api-pagination](codigo/api-pagination/PATTERN.md) — Paginação offset/cursor (revisão: 2026-02-01)
Convenção de invalidação no INDEX: a coluna status da tabela principal
registra ativo | superado; as listagens Por Tipo e Por Categoria marcam o
padrão invalidado com o sufixo [superado por <slug>] quando aplicável — o
arquivo do padrão superado é preservado (nunca delete).
Passo 6 — Reportar
Exiba resumo:
══ rdd-pattern-extractor ═══
padrões analisados: N
novos padrões: N
padrões atualizados: N
total na library: N
stale (>6m sem revisão): N
superados (conflito): N
Modo de erro
warn — falhas parciais não abortam a execução: entram no resumo final
como ⚠️ com orientação. Só é strict na escrita: sem destino resolvido
(pack ativo não configurado — bloco rdd-pack-accumulation ausente — e
operador não informou o pack) ou sem permissão de escrita em
accumulation/patterns/, a skill termina com falha clara
e nada é gravado.
Casos de Borda
- Retrospectiva sem seção "Padrões extraídos": pule, avise
- Padrão com nome muito similar a existente: pergunte ao usuário se é o mesmo padrão ou um novo
- Padrão muito específico de um projeto: classifique como
novo, espere confirmação de outros projetos para promover - Padrão obsoleto (nenhum projeto recente usa): sinalize como candidato
a revisão no relatório —
statussó registraativo | superado(invalidação por contradição); idade não muda status - Padrão novo contradiz existente (mesmo domínio-problema, abordagem
oposta): marque o antigo
status: superado+superado_por: <novo>(Passo 2.4); pergunte ao usuário apenas se a contradição for duvidosa - Padrão sem revisão há mais de 6 meses: identifique pela coluna
data_ultima_revisaodo INDEX e sinalize como candidato a revisão no relatório (Passo 6); nunca delete — merge incremental preserva entradas
Formato de commit
docs(patterns): add <nome-do-padrao> — extraído de <projeto>
04 同仓库更多 Skills
rdd-wiki-lint
Audita integridade dos artefatos RDD: contradições entre seções, artefatos órfãos, referências cruzadas quebradas, links internos inválidos e drift de estrutura. Complementa rdd-validate (que valida a DAG de RNs → downstreams) e rdd-decision-audit (que valida DECISIONS.md) com foco em integridade documental dos artefatos individualmente. Use quando o usuário pedir "lint dos documentos", "verificar integridade dos artefatos", "wiki lint", "contradições nos docs" ou "validar estrutura".
rdd-vps-troubleshoot
Diagnóstico guiado por sintoma para VPS da organização já configurada — container unhealthy / healthcheck expirando, GHCR denied/unauthorized no pull, git "could not read Username for 'https://github.com'", GitHub Actions (appleboy/ssh-action) falhando SSH (handshake failed, ParsePrivateKey), services systemd duplicados do cloudflared em activating (auto-restart), requisições caindo no servidor errado (tunnel compartilhado), porta ocupada, logs (journalctl / docker logs), conectividade (curl local vs público, ss, nc) e banco vazio / migrations não aplicadas. Base de conhecimento: runbook.md nesta pasta (sintomas genéricos de deploy em VPS; lições de produção da organização no pack `rules/<pack-da-organizacao>.md` — IMP-105). Modo guiado — sugere comandos com explicação; o operador executa na VPS. Use quando o usuário reportar "container unhealthy", "deploy falhou", "ssh action erro", "ghcr denied", "tunnel não responde", "banco vazio", "sem tabelas", "service duplicado", "vps com problema" ou pedir troubleshooting de deploy.
rdd-vps-setup
Wizard guiado de setup de VPS nova (OS do perfil — ex.: Amazon Linux) para hospedar uma API — atualização do sistema, Docker + Compose + buildx, permissões de arquivos, autenticação no registry do perfil (ex.: ghcr.io), git via SSH (deploy keys), chave SSH dedicada do GitHub Actions (appleboy/ssh-action), tunnel Cloudflare EXCLUSIVO por servidor + route DNS (domínio do perfil), tunnels como serviço systemd (autostart), logging do cloudflared com rotação, pipeline completo de deploy (push main → build → registry → ssh-action → deploy.sh) e backup automatizado (RClone + cronie + canal de alerta do perfil). Base de conhecimento validada: pack da organização em `rules/<pack-da-organizacao>.md` §infra-vps-setup (IMP-105). Modo guiado — sugere comandos com explicação; o operador executa na VPS. Use quando o usuário pedir "setup de VPS", "configurar VPS nova", "preparar servidor para deploy", "tunnel cloudflare", "ghcr", "deploy key", "backup rclone", "docker compose na vps" ou "pipeline de deploy na VPS".
rdd-validate
Percorre o grafo de documentos do projeto e valida integridade: RN sem downstream esperado, ID quebrado, CR aprovado sem reflexo. Gera relatório VALIDATION_REPORT.md. Suporta flag --fix para auto-correção. Use quando o usuário pedir "validar integridade", "checar a DAG", "validar referências cruzadas" ou "validação do módulo".
rdd-ui-spec
Gera UI_SPEC.md a partir das RNs em REQUIREMENTS.md. Descreve telas, componentes, fluxos de navegação, validações de frontend e regras de exibição condicional. Use quando o usuário pedir "especificação de UI", "spec de telas", "layout de formulários" ou "fluxo de navegação".
rdd-ui-capture
Captura evidência visual em runtime do sistema legado para migração (golden master de UI) via MCP Playwright — screenshots por rota/estado, requisições de rede observadas e erros de console, gravados em reverse/ui/ com manifesto reverse/UI_CAPTURE.md e candidatas visuais na fila reverse/CANDIDATES.md. Complemento runtime da engenharia reversa estática (IMP-144). Use quando o usuário pedir "captura visual", "golden master de UI", "screenshots do legado", "captura de UI" ou "ui capture".