dsh-plugin-guide

<div align="center">

<picture>

<source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-plugin-guide-hero-en-dark.webp">

<img src="docs/assets/dsh-plugin-guide-hero-en-light.webp" width="100%" alt="dsh-plugin-guide: ENTRY / FLOW / BOOST question lists; the verdict belongs to dsh-standards">

</picture>

dsh-plugin-guide

Faça a pergunta certa antes de construir: esclareça as camadas ENTRY / FLOW / BOOST de um plugin DSH e deixe o veredito para a ferramenta que executa as verificações.

A camada de guia para plugins DSH: explica o que verificar, por que importa e qual ferramenta é dona do veredito; não certifica, não pontua e não classifica, apenas encaminha as verificações para o dsh-standards.

[Instalar](#instalação-em-três-passos) · [Configuração](#configuração) · [FAQ](#faq) · [简体中文](README.md) · [English](README.en.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)









dsh plugin --profile web add dsh-plugin-guide

</div>

_{Guia da comunidade, sem vínculo com a DeepSeek; não é certificação, nem ranking, nem auditoria de segurança. Repositório canônico: <https://github.com/PerryLink/dsh-plugin-guide> (o Gitee é um snapshot somente leitura).}

O que é

dsh-plugin-guide é a camada de guia para plugins DSH: explica o que verificar, por que importa e qual ferramenta é dona do veredito. Ao ser instalado, registra uma skill de agente carregada sob demanda cujo corpo é o SKILL.md; as referências relativas desse corpo (./docs/...) resolvem dentro do pacote por meio de um resourceBase de diretório. Não certifica, não pontua e não classifica: as verificações ficam no dsh-standards, o texto das regras no dsh-plugin-spec e a construção/andaime no dsh-primer.

Pacote · Papel

dsh-plugin-guide · Este pacote: a guia em prosa, o mapa de três camadas e a skill de agente

dsh-standards · O guarda-chuva de execução: verificações ENTRY/FLOW, auditoria dsh-levels e os arquivos de especificação

dsh-plugin-spec · O texto de regras de baixo nível e a fonte das cláusulas

dsh-primer · A skill e CLI legadas de construção/andaime (antigo dsh-plugin-guide 0.3.x)

<picture>

<source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-plugin-guide-flow-v4-dark.svg">

<img src="docs/assets/dsh-plugin-guide-flow-v4-light.svg" width="100%" alt="dsh-plugin-guide assembly and routing: cordis.patch.yml → index.js → SKILL.md → docs/levels.md → dsh-standards">

</picture>

Instalação em três passos

1. Instalar (escolha um canal):

   # canal git (main mais recente)
   dsh plugin --profile web add github:PerryLink/dsh-plugin-guide
   # canal npm (versões publicadas)
   dsh plugin --profile web add dsh-plugin-guide
   # canal tarball: após npm pack neste repositório
   dsh plugin --profile web add ./dsh-plugin-guide-<version>.tgz

Sem etapa de build: index.js é o artefato publicado, e SKILL.md mais docs/ são o corpo da skill.

2. Pedir a skill uma vez (as skills carregam sob demanda, nunca como prompt residente):

   > Use dsh-plugin-guide para revisar ./my-plugin: primeiro o veredito ENTRY e depois quais camadas estão not-run.

3. Verificar que entrou em vigor:

   dsh --profile web --dump-config | grep -A2 'id: dsh-plugin-guide'

O catálogo de skills da sessão deve listar dsh-plugin-guide, e o corpo carregado deve apontar para docs/levels.md (a forma de aceitação registrada em package.json#dshWorkshop.capability.expected).

Desinstalar: dsh plugin --profile web remove dsh-plugin-guide (ou apague a linha do patch do perfil). O registro é um efeito do Cordis, então descarregar o plugin o remove sem deixar resíduo.

Capacidades principais

• Mapa de três camadas — ENTRY pergunta «dá para reconhecer, instalar e iniciar?», FLOW pergunta «o usuário consegue instalar, configurar, usar, atualizar e remover?» e BOOST pergunta «usa o Cordis bem?». Três trilhas, não três notas; juntas não somam pontuação nem certificado.
• Roteamento de verificações — este pacote apenas explica e encaminha: verificações de conformidade vão para o dsh-standards, o texto de regras está no dsh-plugin-spec e construir um plugin é trabalho do dsh-primer (a antiga CLI dsh-plugin-dev vive lá, não aqui).
• Regras de evidência — static ≠ runtime, recognized ≠ pass, not-run ≠ pass; um PASS exige comando, artefato, ambiente e data; se faltar algo, escreva not-run, not-measured ou incomplete.
• Skill sob demanda — index.js lê o SKILL.md, remove o frontmatter YAML e o registra com source: bundled e um resourceBase de diretório; a skill entra no context

…(truncated)