abertanha/md-to-wiki-docs-skills

md-to-wiki — Roteador Fino (Fase 2)

Transforme arquivos de especificação em markdown em sites de documentação.

Gatilhos: "build wiki", "generate docs", "publish specs", "make a site", "wiki from markdown", "draw diagram", "flow chart", "architecture diagram", "state diagram", "sequence diagram"

Roteador de Fase

Analise a solicitação do usuário para determinar qual caminho seguir:

lower=$(echo "$1" | tr '[:upper:]' '[:lower:]')
case "$lower" in
  *"not sure"*|*"help"*|*"recommend"*)     ROUTE="onboarding" ;;
  *"html"*|*"site"*|*"mkdocs"*|*"material"*)  ROUTE="mkdocs" ;;
  *"swagger"*|*"openapi"*|*"api"*)          ROUTE="swagger" ;;
  *"github wiki"*|*"wiki tab"*)             ROUTE="github-wiki" ;;
  *"dokuwiki"*|*"doku"*)                    ROUTE="dokuwiki" ;;
  *"pdf"*|*"print"*|*"book"*)               ROUTE="pdf" ;;
  *"reference"*|*"issue"*|*"pr"*|*"pull"*)  ROUTE="references" ;;
  *"deploy"*|*"publish"*|*"go live"*)       ROUTE="deploy" ;;
  *)                                          ROUTE="onboarding" ;;
esac

Em seguida, lance o agente apropriado:

Rota	Agente	Descrição
onboarding	agents/onboarding.md	Entreviste o usuário, detecte o SO, configure SKILL_DIR
mkdocs	agents/format-mkdocs.md	Gere site MkDocs Material
swagger	agents/format-swagger.md	Gere OpenAPI 3.0 + Swagger UI
github-wiki	agents/format-github-wiki.md	Publique no GitHub Wiki
dokuwiki	agents/format-dokuwiki.md	Converta para formato DokuWiki
pdf	agents/format-pdf.md	Gere PDF via Pandoc
references	agents/references.md	Enriqueça a documentação com referências de issues/PRs do GitHub
deploy	agents/deploy.md	Implante a documentação gerada em um servidor de hospedagem

Fluxo de Execução

1. Onboarding → Faça perguntas: nome do projeto, diretórios fonte, público-alvo (desenvolvedor/interessado/geral), formato desejado. Detecte o SO uma vez, armazene SKILL_DIR, SCRIPT_EXT, SCRIPT_RUNNER.
2. Geração de formato → Carregue o agente de formato apropriado. Use scripts complementares de scripts/ com $SCRIPT_RUNNER.
3. Referências → Se o usuário quiser referências de issues/PRs, carregue references.md.
4. Implantação → Após a geração, carregue deploy.md para oferecer hospedagem.

Variáveis Globais (definidas uma vez durante o onboarding)

• SKILL_DIR — caminho resolvido para a pasta desta skill
• SCRIPT_EXT — .sh ou .ps1
• SCRIPT_RUNNER — "" ou "powershell -File"
• OS_TYPE — unix ou windows
• PROJECT_NAME — do usuário
• SOURCES — caminhos para arquivos de especificação
• AUDIENCE — developer, stakeholder ou general

Scripts Complementares

Todos aceitam argumentos posicionais de forma idêntica em .sh e .ps1:

Script	Propósito
discover-sources	Varre diretórios em busca de arquivos de especificação/projeto/código-base/rápidos
generate-mkdocs	Cria mkdocs.yml completo + estrutura de páginas
generate-index	Constrói página inicial adequada ao público-alvo
to-dokuwiki	Converte markdown → sintaxe DokuWiki
to-pdf	Concatena + converte para PDF via pandoc
fetch-issues	Armazena em cache metadados de issues/PRs do GitHub

Entrada com Múltiplos Diretórios

Mescle múltiplos diretórios fonte em merged-specs/ antes de executar:

mkdir -p merged-specs && cp -r .specs/* docs/* merged-specs/

Compartilhamento

Copie md-to-wiki/ para a pasta .config/opencode/skills/ ou .opencode/skills/ do colega. As dependências variam conforme o formato.