Skip to content

Latest commit

 

History

History
729 lines (485 loc) · 22.8 KB

INSTALL.pt-BR.md

File metadata and controls

729 lines (485 loc) · 22.8 KB

Como instalar

Antigravity (agy)

Instalar

agy plugin install https://github.com/ayghri/i-have-adhd

Verificar

agy plugin list

Atualizar

agy plugin uninstall i-have-adhd
agy plugin install https://github.com/ayghri/i-have-adhd

Desinstalar

agy plugin uninstall i-have-adhd

Ou mantenha instalado e desative: agy plugin disable i-have-adhd.

Sempre ativo (opcional)

Adicione ao ~/.gemini/GEMINI.md:

## Estilo de resposta

A pessoa que lê tem TDAH. Estruture cada resposta para que ela possa agir:

1. Comece pela resposta ou próxima ação: comando, caminho ou trecho de código primeiro.
2. Numere trabalhos com várias etapas; uma ação bem delimitada por etapa.
3. Termine com uma próxima ação que possa ser feita em menos de dois minutos.
4. Conclua o problema atual antes de levantar outro.
5. Reafirme o progresso a cada turno ("etapa 3 de 5 concluída").
6. Dê estimativas de tempo em unidades concretas, nunca "um pouco".
7. Após uma alteração, mostre o que agora funciona.
8. Erros: informe local, causa e correção, sem drama.
9. Limite listas a 5 itens.
10. Sem preâmbulo, recapitulação ou despedida.

Exceções: explique por completo quando pedirem. Confirme antes de ações destrutivas. Após três tentativas de correção sem sucesso, pare e identifique a suposição duvidosa. Se o pedido for ambíguo, faça uma pergunta curta.
Claude Code

Instalar

claude plugin marketplace add ayghri/i-have-adhd
claude plugin install i-have-adhd@i-have-adhd

Digite /i-have-adhd.

Verificar

claude plugin list

Atualizar

claude plugin marketplace update i-have-adhd
claude plugin update i-have-adhd@i-have-adhd

Desinstalar

claude plugin uninstall i-have-adhd
claude plugin marketplace remove i-have-adhd

Ou mantenha instalado e desative: claude plugin disable i-have-adhd.

Sempre ativo (opcional)

Um hook SessionStart carrega todas as regras no início de cada sessão; não é preciso usar /i-have-adhd:

touch ~/.claude/.i-have-adhd-always

Se você usa um diretório de configuração personalizado do Claude, crie o arquivo de sinalização nele:

touch "$CLAUDE_CONFIG_DIR/.i-have-adhd-always"

Para voltar ao modo sob demanda:

rm ~/.claude/.i-have-adhd-always

O hook só é executado quando o arquivo de sinalização existe, portanto instalar o plugin não muda nada por si só. "stop adhd mode" ainda o desativa na sessão atual.

Codex

Instalar

codex plugin marketplace add ayghri/i-have-adhd --ref main
codex plugin add i-have-adhd@i-have-adhd

Ative a skill explicitamente digitando $i-have-adhd. O Codex não a invoca automaticamente.

Verificar

codex plugin list

Atualizar

codex plugin marketplace upgrade i-have-adhd
codex plugin remove i-have-adhd
codex plugin add i-have-adhd@i-have-adhd

Desinstalar

codex plugin remove i-have-adhd
codex plugin marketplace remove i-have-adhd

Sempre ativo (opcional)

Adicione ao ~/.codex/AGENTS.md:

## Estilo de resposta

A pessoa que lê tem TDAH. Estruture cada resposta para que ela possa agir:

1. Comece pela resposta ou próxima ação: comando, caminho ou trecho de código primeiro.
2. Numere trabalhos com várias etapas; uma ação bem delimitada por etapa.
3. Termine com uma próxima ação que possa ser feita em menos de dois minutos.
4. Conclua o problema atual antes de levantar outro.
5. Reafirme o progresso a cada turno ("etapa 3 de 5 concluída").
6. Dê estimativas de tempo em unidades concretas, nunca "um pouco".
7. Após uma alteração, mostre o que agora funciona.
8. Erros: informe local, causa e correção, sem drama.
9. Limite listas a 5 itens.
10. Sem preâmbulo, recapitulação ou despedida.

Exceções: explique por completo quando pedirem. Confirme antes de ações destrutivas. Após três tentativas de correção sem sucesso, pare e identifique a suposição duvidosa. Se o pedido for ambíguo, faça uma pergunta curta.
Gemini CLI

O Gemini CLI não tem marketplace de plugins, então há duas opções nativas: um comando personalizado (opt-in, desativado até ser invocado) ou uma extensão (sempre ativa após a instalação). O comando corresponde ao comportamento padrão desta skill; escolha-o, a menos que queira as regras em todas as sessões.

Instalar (command, opt-in)

mkdir -p ~/.gemini/commands
curl -fsSL https://raw.githubusercontent.com/ayghri/i-have-adhd/main/skills/i-have-adhd/agents/gemini.toml \
  -o ~/.gemini/commands/i-have-adhd.toml

Inicie uma nova sessão e digite /i-have-adhd. A skill permanecerá ativa durante essa sessão.

Instalar (extension, always-on)

gemini extensions install https://github.com/ayghri/i-have-adhd

A extensão carrega GEMINI.md, que importa a skill completa; assim, as regras valem desde a primeira mensagem. O git precisa estar instalado.

Verificar

gemini extensions list          # via extensão
ls ~/.gemini/commands           # command route: i-have-adhd.toml present

Ou digite / em uma sessão e confirme que i-have-adhd aparece na lista.

Atualizar

gemini extensions update i-have-adhd    # via extensão
# via comando: execute novamente o curl acima

Desinstalar

gemini extensions uninstall i-have-adhd    # via extensão
rm ~/.gemini/commands/i-have-adhd.toml     # command route
GitHub Copilot (VS Code and Copilot CLI)

O Copilot lê Agent Skills nativamente: usa o mesmo SKILL.md, sem conversão. No projeto, ele verifica .github/skills/, .claude/skills/ e .agents/skills/; globalmente, ~/.copilot/skills/, ~/.claude/skills/ e ~/.agents/skills/.

Instalar

npx skills add ayghri/i-have-adhd -a github-copilot        # este projeto
npx skills add ayghri/i-have-adhd -a github-copilot -g     # todos os projetos

Sem a CLI, copie a pasta da skill para qualquer diretório verificado pelo Copilot:

git clone https://github.com/ayghri/i-have-adhd
mkdir -p ~/.copilot/skills
cp -R i-have-adhd/skills/i-have-adhd ~/.copilot/skills/

Verificar

Digite / no campo de chat e confirme que i-have-adhd aparece. Ou:

npx skills list
npx skills ls -g    # se instalado globalmente

Atualizar

npx skills update i-have-adhd

Ou copie a pasta novamente após git pull.

Desinstalar

npx skills remove i-have-adhd

Ou exclua a pasta i-have-adhd do diretório de skills onde ela foi instalada.

Observação sobre ativação

O Copilot respeita disable-model-invocation: nada é aplicado até você invocar a skill, como no Claude Code (testado no #60).

Sempre ativo (opcional)

Adicione o bloco abaixo ao .github/copilot-instructions.md do projeto (o Copilot o lê em todo chat):

## Estilo de resposta

A pessoa que lê tem TDAH. Estruture cada resposta para que ela possa agir:

1. Comece pela resposta ou próxima ação: comando, caminho ou trecho de código primeiro.
2. Numere trabalhos com várias etapas; uma ação bem delimitada por etapa.
3. Termine com uma próxima ação que possa ser feita em menos de dois minutos.
4. Conclua o problema atual antes de levantar outro.
5. Reafirme o progresso a cada turno ("etapa 3 de 5 concluída").
6. Dê estimativas de tempo em unidades concretas, nunca "um pouco".
7. Após uma alteração, mostre o que agora funciona.
8. Erros: informe local, causa e correção, sem drama.
9. Limite listas a 5 itens.
10. Sem preâmbulo, recapitulação ou despedida.

Exceções: explique por completo quando pedirem. Confirme antes de ações destrutivas. Após três tentativas de correção sem sucesso, pare e identifique a suposição duvidosa. Se o pedido for ambíguo, faça uma pergunta curta.
Hermes

Instalar

hermes skills install ayghri/i-have-adhd/skills/i-have-adhd

Digite /i-have-adhd. The skill installs into ~/.hermes/skills/ and is exposed as a slash command at the next session start.

Prefere explorar primeiro? Adicione este repositório como fonte de skills (um "tap"), depois pesquise e instale:

hermes skills tap add ayghri/i-have-adhd
hermes skills search adhd
hermes skills install ayghri/i-have-adhd/skills/i-have-adhd

Verificar

hermes skills list

Atualizar

hermes skills update i-have-adhd

Desinstalar

hermes skills uninstall i-have-adhd

Ou remova também o tap: hermes skills tap remove ayghri/i-have-adhd.

Sempre ativo (opcional)

Adicione ao AGENTS.md do diretório de trabalho (o Hermes o carrega por diretório) ou ao SOUL.md da sua persona para todas as sessões:

## Estilo de resposta

A pessoa que lê tem TDAH. Estruture cada resposta para que ela possa agir:

1. Comece pela resposta ou próxima ação: comando, caminho ou trecho de código primeiro.
2. Numere trabalhos com várias etapas; uma ação bem delimitada por etapa.
3. Termine com uma próxima ação que possa ser feita em menos de dois minutos.
4. Conclua o problema atual antes de levantar outro.
5. Reafirme o progresso a cada turno ("etapa 3 de 5 concluída").
6. Dê estimativas de tempo em unidades concretas, nunca "um pouco".
7. Após uma alteração, mostre o que agora funciona.
8. Erros: informe local, causa e correção, sem drama.
9. Limite listas a 5 itens.
10. Sem preâmbulo, recapitulação ou despedida.

Exceções: explique por completo quando pedirem. Confirme antes de ações destrutivas. Após três tentativas de correção sem sucesso, pare e identifique a suposição duvidosa. Se o pedido for ambíguo, faça uma pergunta curta.
Kimi Code CLI

Instalar

Inicie uma sessão do Kimi Code e:

  1. Execute /plugins.
  2. Selecione Custom.
  3. Cole https://github.com/ayghri/i-have-adhd e pressione Enter.
  4. Selecione Trust and install.

Use o comando slash /skill:i-have-adhd para invocar a skill explicitamente.

Atualizar

Em uma sessão do Kimi Code, execute /plugins, posicione o cursor em I Have ADHD e pressione R.

Desinstalar

Em uma sessão do Kimi Code, execute /plugins, posicione o cursor em I Have ADHD e pressione D.

OpenCode

O plugin suporta OpenCode V1 1.18.29 ou superior e V2. Registra a skill e o comando /i-have-adhd e oferece o modo sempre ativo opcional. Versões anteriores do V1 precisam ser atualizadas ou usar o plugin da versão anterior da skill.

Instalação

Para usar em todos os projetos:

git clone https://github.com/ayghri/i-have-adhd ~/.config/opencode/vendor/i-have-adhd
mkdir -p ~/.config/opencode/plugins
cat > ~/.config/opencode/plugins/i-have-adhd.js <<'EOF'
export { default } from '../vendor/i-have-adhd/.opencode/plugins/i-have-adhd.mjs';
EOF

Para uma instalação V1 existente, mantenha a entrada plugin em opencode.json. Se mudar para o carregador acima, remova essa entrada.

Inicie uma nova sessão e digite /i-have-adhd. As regras permanecem até você dizer stop adhd mode ou normal mode.

Apenas skill e comando (sem modo sempre ativo)

Como alternativa, copie a skill e o comando do repositório para os diretórios globais do OpenCode:

mkdir -p ~/.config/opencode/skills/i-have-adhd ~/.config/opencode/commands
cp skills/i-have-adhd/SKILL.md ~/.config/opencode/skills/i-have-adhd/SKILL.md
cp .opencode/command/i-have-adhd.md ~/.config/opencode/commands/i-have-adhd.md

Verificação

Inicie o OpenCode, digite / e confirme que i-have-adhd aparece na lista de comandos.

Atualização

git -C ~/.config/opencode/vendor/i-have-adhd pull

Na instalação por cópia, atualize o repositório e copie novamente os dois arquivos.

Desinstalação

Remova ~/.config/opencode/plugins/i-have-adhd.js. Na instalação por cópia, remova ~/.config/opencode/skills/i-have-adhd/ e ~/.config/opencode/commands/i-have-adhd.md. Para uma instalação V1 já configurada, remova a entrada plugin correspondente.

Sempre ativo (opcional)

Requer o plugin. Criar o arquivo de sinalização adiciona todas as regras ao prompt do sistema em cada turno:

touch ~/.config/opencode/.i-have-adhd-always

stop adhd mode ou normal mode pede ao agente que volte ao estilo padrão na sessão atual. Remova o arquivo para interromper a inclusão automática:

rm ~/.config/opencode/.i-have-adhd-always

Se XDG_CONFIG_HOME estiver definido, substitua ~/.config nesses caminhos por esse diretório.

Pi

O Pi implementa o padrão Agent Skills, portanto o mesmo SKILL.md é carregado diretamente, sem conversão. A invocação no Pi é diferente: as skills são chamadas como /skill:<name>.

Instalar

npx skills add ayghri/i-have-adhd -a pi -y

Prefere usar o sistema de arquivos? O Pi encontra skills em ~/.pi/agent/skills/ e ~/.agents/skills/ (global), e em .pi/skills/ e .agents/skills/ (projeto):

git clone https://github.com/ayghri/i-have-adhd
mkdir -p ~/.pi/agent/skills
cp -R i-have-adhd/skills/i-have-adhd ~/.pi/agent/skills/

Ative os comandos de barra de skills no settings.json do Pi:

{ "enableSkillCommands": true }

Inicie uma nova sessão e digite /skill:i-have-adhd.

Verificar

npx skills list

Ou digite /skill: em uma sessão e confirme que i-have-adhd aparece na lista.

Atualizar

npx skills update i-have-adhd

Ou copie a pasta novamente após git pull.

Desinstalar

npx skills remove i-have-adhd

Ou exclua ~/.pi/agent/skills/i-have-adhd.

Sempre ativo (opcional)

Adicione ao AGENTS.md do projeto:

## Estilo de resposta

A pessoa que lê tem TDAH. Estruture cada resposta para que ela possa agir:

1. Comece pela resposta ou próxima ação: comando, caminho ou trecho de código primeiro.
2. Numere trabalhos com várias etapas; uma ação bem delimitada por etapa.
3. Termine com uma próxima ação que possa ser feita em menos de dois minutos.
4. Conclua o problema atual antes de levantar outro.
5. Reafirme o progresso a cada turno ("etapa 3 de 5 concluída").
6. Dê estimativas de tempo em unidades concretas, nunca "um pouco".
7. Após uma alteração, mostre o que agora funciona.
8. Erros: informe local, causa e correção, sem drama.
9. Limite listas a 5 itens.
10. Sem preâmbulo, recapitulação ou despedida.

Exceções: explique por completo quando pedirem. Confirme antes de ações destrutivas. Após três tentativas de correção sem sucesso, pare e identifique a suposição duvidosa. Se o pedido for ambíguo, faça uma pergunta curta.
Qwen Code

Instalar

qwen extensions install ayghri/i-have-adhd

O Qwen Code aceita a forma abreviada do GitHub e instala o repositório como extensão nativa. A extensão encontra a skill em skills/.

Digite /i-have-adhd para invocar a skill explicitamente. Instalar a extensão não altera a saída até que a skill seja invocada.

Verificar

qwen extensions list

Depois, inicie uma nova sessão do Qwen Code e execute:

/skills

Confirme que i-have-adhd aparece na lista.

Atualizar

qwen extensions update i-have-adhd

Desinstalar

qwen extensions uninstall i-have-adhd
Zed

O Agent do Zed lê Agent Skills nativamente: usa o mesmo SKILL.md, sem conversão. (As antigas "Rules" do Zed foram substituídas por Skills e instruções em AGENTS.md.)

Instalar

No Agent Panel, abra o gerenciador de Skills, escolha Create skill from URL (também disponível na paleta como agent: create skill from url) e cole:

https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md

Salve no escopo User para todos os projetos ou Project para apenas um. Depois, digite /i-have-adhd no Agent Panel.

Prefere o sistema de arquivos? Clone o repositório e coloque a pasta da skill no diretório de skills do usuário:

git clone https://github.com/ayghri/i-have-adhd
mkdir -p ~/.agents/skills
cp -R i-have-adhd/skills/i-have-adhd ~/.agents/skills/

Verificar

Abra o gerenciador de Skills no Agent Panel e confirme que i-have-adhd aparece. Ou digite / e confira.

Atualizar

Importe novamente pela mesma URL (sobrescreve) ou copie a pasta de novo após git pull.

Desinstalar

Remova i-have-adhd do gerenciador de Skills ou exclua ~/.agents/skills/i-have-adhd.

Sempre ativo (opcional)

Adicione ao seu ~/.config/zed/AGENTS.md pessoal:

## Estilo de resposta

A pessoa que lê tem TDAH. Estruture cada resposta para que ela possa agir:

1. Comece pela resposta ou próxima ação: comando, caminho ou trecho de código primeiro.
2. Numere trabalhos com várias etapas; uma ação bem delimitada por etapa.
3. Termine com uma próxima ação que possa ser feita em menos de dois minutos.
4. Conclua o problema atual antes de levantar outro.
5. Reafirme o progresso a cada turno ("etapa 3 de 5 concluída").
6. Dê estimativas de tempo em unidades concretas, nunca "um pouco".
7. Após uma alteração, mostre o que agora funciona.
8. Erros: informe local, causa e correção, sem drama.
9. Limite listas a 5 itens.
10. Sem preâmbulo, recapitulação ou despedida.

Exceções: explique por completo quando pedirem. Confirme antes de ações destrutivas. Após três tentativas de correção sem sucesso, pare e identifique a suposição duvidosa. Se o pedido for ambíguo, faça uma pergunta curta.
Cursor, Amp e qualquer outro ambiente compatível com agent-skills

Funciona com qualquer ambiente que leia Agent Skills. Troque -a <agent> pelo seu.

Instalar

npx skills add ayghri/i-have-adhd                  # this workspace
npx skills add ayghri/i-have-adhd -g               # todos os projetos
npx skills add ayghri/i-have-adhd -a cursor -y     # one agent only
npx skills add ayghri/i-have-adhd -a opencode -y

Abra um novo chat do agente e digite /i-have-adhd.

Sem a CLI, copie a pasta da skill para o caminho verificado pelo seu agente:

git clone https://github.com/ayghri/i-have-adhd
mkdir -p ~/.cursor/skills     # Cursor. Use .agents/skills no OpenCode ou o caminho próprio do agente
cp -R i-have-adhd/skills/i-have-adhd ~/.cursor/skills/

Verificar

npx skills list
npx skills ls -g    # se instalado globalmente

Atualizar

npx skills update i-have-adhd
npx skills update -g    # se instalado globalmente

Desinstalar

npx skills remove i-have-adhd
npx skills remove i-have-adhd -g    # se instalado globalmente

Sempre ativo (opcional)

Cole isto no arquivo de regras persistentes do agente. Cursor: Settings → Rules → User Rules, ou uma regra de projeto em .cursor/rules/ com alwaysApply: true. OpenCode: ~/.config/opencode/AGENTS.md.

## Estilo de resposta

A pessoa que lê tem TDAH. Estruture cada resposta para que ela possa agir:

1. Comece pela resposta ou próxima ação: comando, caminho ou trecho de código primeiro.
2. Numere trabalhos com várias etapas; uma ação bem delimitada por etapa.
3. Termine com uma próxima ação que possa ser feita em menos de dois minutos.
4. Conclua o problema atual antes de levantar outro.
5. Reafirme o progresso a cada turno ("etapa 3 de 5 concluída").
6. Dê estimativas de tempo em unidades concretas, nunca "um pouco".
7. Após uma alteração, mostre o que agora funciona.
8. Erros: informe local, causa e correção, sem drama.
9. Limite listas a 5 itens.
10. Sem preâmbulo, recapitulação ou despedida.

Exceções: explique por completo quando pedirem. Confirme antes de ações destrutivas. Após três tentativas de correção sem sucesso, pare e identifique a suposição duvidosa. Se o pedido for ambíguo, faça uma pergunta curta.

Como a ativação funciona

  1. Instalada, mas não invocada. No Claude Code, Qwen Code e Codex, nada acontece até que você invoque a skill explicitamente. Claude Code e Qwen Code respeitam disable-model-invocation: true em SKILL.md; o Codex respeita policy.allow_implicit_invocation: false em agents/openai.yaml. Outros ambientes podem carregar a descrição de cada skill na inicialização e ativá-la por conta própria.
  2. Você a invoca explicitamente. Digite /i-have-adhd no Claude Code ou Qwen Code, ou $i-have-adhd no Codex. As regras ficam ativas nessa sessão. "stop adhd mode" ou "normal mode" as desativa.
  3. Você cria ~/.claude/.i-have-adhd-always (Claude Code). Um hook SessionStart carrega todas as regras desde a primeira mensagem, em toda sessão.
  4. Você adiciona o trecho sempre ativo acima (outros ambientes). Isso mantém as regras principais no contexto persistente do agente.

No Claude Code, Qwen Code e Codex não há meio-termo: se você não ativou, está desativado.

Solução de problemas

/i-have-adhd não aparece no preenchimento automático. Reinicie o agente. O índice de plugins é lido na inicialização.

A flag de sempre ativo não funciona. Atualize o plugin (claude plugin marketplace update i-have-adhd e depois claude plugin update i-have-adhd@i-have-adhd) e reinicie. Hooks são lidos na inicialização, e a flag exige a versão que inclui hooks/hooks.json.

claude plugin marketplace add falha. Use o formato owner/repo. Um caminho local deve apontar para a raiz do repositório, não para .claude-plugin/.

Instalada, mas as respostas ainda têm preâmbulo. Abra uma nova sessão. Se continuar desviando, torne mais rigoroso o texto em skills/i-have-adhd/SKILL.md.

Quer regras diferentes. Faça um fork, edite skills/i-have-adhd/SKILL.md e troque pela sua cópia:

claude plugin uninstall i-have-adhd            # remova primeiro a cópia upstream:
claude plugin marketplace remove i-have-adhd   # o fork e o upstream usam o mesmo nome
claude plugin marketplace add <your-username>/i-have-adhd
claude plugin install i-have-adhd@i-have-adhd

Reinicie e invoque /i-have-adhd novamente.

A skill não aparece após npx skills add. Abra um novo chat do agente. Skills são indexadas no início da sessão. Confirme que a pasta foi instalada onde o agente procura (~/.cursor/skills/ no Cursor, .agents/skills/ no OpenCode) e que o name no frontmatter corresponde ao nome da pasta.