@daoquadrado/skills 0.0.0-stage → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +122 -0
- package/README.md +126 -2
- package/bin/cli.js +268 -0
- package/package.json +33 -4
- package/skills/bug/SKILL.md +83 -0
- package/skills/bug/references/bug-template.md +116 -0
- package/skills/execute/SKILL.md +79 -0
- package/skills/metricas-heart-produto/SKILL.md +85 -0
- package/skills/metricas-heart-produto/agents/openai.yaml +5 -0
- package/skills/metricas-heart-produto/assets/base-metricas.xlsx +0 -0
- package/skills/metricas-heart-produto/references/catalogo-metricas.md +1904 -0
- package/skills/metricas-heart-produto/references/cuidados-formulas.md +30 -0
- package/skills/metricas-heart-produto/references/dashboard-preview.md +21 -0
- package/skills/metricas-heart-produto/references/modelo-heart.md +19 -0
- package/skills/metricas-heart-produto/scripts/atualizar_catalogo.py +89 -0
- package/skills/one-pager-produto/SKILL.md +54 -0
- package/skills/one-pager-produto/agents/openai.yaml +4 -0
- package/skills/one-pager-produto/references/one-pager-template.md +35 -0
- package/skills/plan/SKILL.md +72 -0
- package/skills/plan/references/plan-template.md +173 -0
- package/skills/prd-ux/SKILL.md +54 -0
- package/skills/prd-ux/agents/openai.yaml +4 -0
- package/skills/prd-ux/references/lovable-template.md +40 -0
- package/skills/prd-ux/references/prd-template.md +31 -0
- package/skills/prd-ux/references/quality-checklist.md +13 -0
- package/skills/roadmap-lean-inception/SKILL.md +66 -0
- package/skills/roadmap-lean-inception/agents/openai.yaml +4 -0
- package/skills/roadmap-lean-inception/references/regras-ondas.md +33 -0
- package/skills/roadmap-lean-inception/references/roadmap-template.md +39 -0
- package/skills/roadmap-lean-inception/scripts/planejar_ondas.py +113 -0
- package/skills/spec/SKILL.md +63 -0
- package/skills/spec/references/spec-template.md +147 -0
- package/skills/story/SKILL.md +130 -0
- package/skills/story/references/story-template.md +102 -0
- package/skills/validar-prototipo-persona/SKILL.md +60 -0
- package/skills/validar-prototipo-persona/agents/openai.yaml +4 -0
- package/skills/validar-prototipo-persona/references/relatorio-template.md +61 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
LICENÇA DE USO — D² [do Discovery ao Delivery] — Skills de Produto
|
|
2
|
+
Copyright (c) 2026 Bruna Fonseca. Todos os direitos reservados.
|
|
3
|
+
|
|
4
|
+
Este software e conteúdo (as "Skills", incluindo SKILL.md, referências, scripts,
|
|
5
|
+
assets e o instalador "daoquadrado") é propriedade de Bruna Fonseca (a
|
|
6
|
+
"Titular"). Ele NÃO é software livre nem de código aberto. Sua disponibilidade
|
|
7
|
+
pública (GitHub, npm) não concede, por si só, nenhum direito de uso.
|
|
8
|
+
|
|
9
|
+
1. QUEM PODE USAR
|
|
10
|
+
Somente a pessoa física que adquiriu o treinamento D² [do Discovery ao
|
|
11
|
+
Delivery] (o "Aluno"). A licença é pessoal e intransferível: não se estende
|
|
12
|
+
à empresa do Aluno, a colegas de equipe, clientes ou terceiros. Cada pessoa
|
|
13
|
+
que queira usar precisa ter adquirido o treinamento.
|
|
14
|
+
|
|
15
|
+
2. O QUE É PERMITIDO
|
|
16
|
+
Ao Aluno é concedida licença limitada, não exclusiva, revogável e
|
|
17
|
+
intransferível para:
|
|
18
|
+
a) instalar e executar as Skills em suas próprias ferramentas de IA;
|
|
19
|
+
b) usá-las no seu trabalho e em seus projetos, inclusive comerciais, e usar
|
|
20
|
+
os resultados que elas produzirem (documentos, histórias, planos etc.);
|
|
21
|
+
c) modificar as Skills para uso próprio.
|
|
22
|
+
|
|
23
|
+
3. O QUE É PROIBIDO SEM AUTORIZAÇÃO ESCRITA DA TITULAR
|
|
24
|
+
a) vender, revender, alugar, licenciar ou sublicenciar as Skills;
|
|
25
|
+
b) redistribuir, publicar ou compartilhar as Skills, em original ou
|
|
26
|
+
modificadas, em repositórios, marketplaces, pacotes, cursos, comunidades
|
|
27
|
+
ou qualquer outro meio, de forma gratuita ou paga;
|
|
28
|
+
c) incluí-las em produto, serviço, curso, treinamento ou consultoria
|
|
29
|
+
oferecidos a terceiros;
|
|
30
|
+
d) oferecê-las como serviço (SaaS) ou disponibilizá-las a terceiros por
|
|
31
|
+
acesso remoto;
|
|
32
|
+
e) compartilhar o acesso com quem não adquiriu o treinamento;
|
|
33
|
+
f) remover avisos de direitos autorais ou desta licença.
|
|
34
|
+
|
|
35
|
+
4. AUTORIZAÇÕES
|
|
36
|
+
Pedidos de autorização para qualquer uso proibido devem ser feitos à Titular
|
|
37
|
+
por meio do site www.daoquadrado.com.br. Nenhuma autorização vale se não
|
|
38
|
+
for dada por escrito.
|
|
39
|
+
|
|
40
|
+
5. TITULARIDADE
|
|
41
|
+
Todos os direitos não concedidos expressamente ficam reservados à Titular.
|
|
42
|
+
Modificações feitas pelo Aluno não transferem a ele a titularidade do
|
|
43
|
+
conteúdo original.
|
|
44
|
+
|
|
45
|
+
6. RESULTADOS GERADOS
|
|
46
|
+
O conteúdo que o Aluno produzir ao usar as Skills pertence ao Aluno, sem
|
|
47
|
+
prejuízo da titularidade da Titular sobre as Skills em si.
|
|
48
|
+
|
|
49
|
+
7. SEM GARANTIA
|
|
50
|
+
AS SKILLS SÃO FORNECIDAS "NO ESTADO EM QUE SE ENCONTRAM", SEM GARANTIA DE
|
|
51
|
+
QUALQUER TIPO, EXPRESSA OU IMPLÍCITA. A TITULAR NÃO RESPONDE POR DANOS
|
|
52
|
+
DECORRENTES DO USO, NA MÁXIMA EXTENSÃO PERMITIDA PELA LEI.
|
|
53
|
+
|
|
54
|
+
8. VIGÊNCIA E RESCISÃO
|
|
55
|
+
Esta licença vigora por prazo indeterminado e termina automaticamente se o
|
|
56
|
+
Aluno descumprir qualquer condição acima. Com o término, o Aluno deve
|
|
57
|
+
deixar de usar as Skills e apagar as cópias que possuir.
|
|
58
|
+
|
|
59
|
+
9. LEI APLICÁVEL
|
|
60
|
+
Esta licença é regida pelas leis da República Federativa do Brasil.
|
|
61
|
+
|
|
62
|
+
------------------------------------------------------------------------------
|
|
63
|
+
|
|
64
|
+
LICENSE — D² [do Discovery ao Delivery] — Product Skills
|
|
65
|
+
Copyright (c) 2026 Bruna Fonseca. All rights reserved.
|
|
66
|
+
|
|
67
|
+
This software and content (the "Skills", including SKILL.md files, references,
|
|
68
|
+
scripts, assets and the "daoquadrado" installer) is owned by Bruna Fonseca (the
|
|
69
|
+
"Owner"). It is NOT free or open-source software. Public availability (GitHub,
|
|
70
|
+
npm) does not by itself grant any right of use.
|
|
71
|
+
|
|
72
|
+
1. WHO MAY USE IT
|
|
73
|
+
Only the individual who purchased the D² [do Discovery ao Delivery] training
|
|
74
|
+
(the "Student"). The license is personal and non-transferable: it does not
|
|
75
|
+
extend to the Student's employer, teammates, clients or any third party.
|
|
76
|
+
Each person who wants to use the Skills must have purchased the training.
|
|
77
|
+
|
|
78
|
+
2. PERMITTED USE
|
|
79
|
+
The Student is granted a limited, non-exclusive, revocable, non-transferable
|
|
80
|
+
license to:
|
|
81
|
+
a) install and run the Skills in their own AI tools;
|
|
82
|
+
b) use them in their work and projects, including commercial ones, and use
|
|
83
|
+
the output they produce (documents, user stories, plans, etc.);
|
|
84
|
+
c) modify the Skills for their own use.
|
|
85
|
+
|
|
86
|
+
3. PROHIBITED WITHOUT THE OWNER'S WRITTEN PERMISSION
|
|
87
|
+
a) selling, reselling, renting, licensing or sublicensing the Skills;
|
|
88
|
+
b) redistributing, publishing or sharing the Skills, original or modified,
|
|
89
|
+
in repositories, marketplaces, packages, courses, communities or any
|
|
90
|
+
other medium, free of charge or paid;
|
|
91
|
+
c) including them in any product, service, course, training or consulting
|
|
92
|
+
offered to third parties;
|
|
93
|
+
d) offering them as a service (SaaS) or making them available to third
|
|
94
|
+
parties through remote access;
|
|
95
|
+
e) sharing access with anyone who has not purchased the training;
|
|
96
|
+
f) removing copyright or license notices.
|
|
97
|
+
|
|
98
|
+
4. PERMISSIONS
|
|
99
|
+
Requests for permission for any prohibited use must be made to the Owner
|
|
100
|
+
through www.daoquadrado.com.br. No permission is valid unless given in
|
|
101
|
+
writing.
|
|
102
|
+
|
|
103
|
+
5. OWNERSHIP
|
|
104
|
+
All rights not expressly granted are reserved by the Owner. Modifications
|
|
105
|
+
made by the Student do not transfer ownership of the original content.
|
|
106
|
+
|
|
107
|
+
6. GENERATED OUTPUT
|
|
108
|
+
Content the Student produces by using the Skills belongs to the Student,
|
|
109
|
+
without prejudice to the Owner's ownership of the Skills themselves.
|
|
110
|
+
|
|
111
|
+
7. NO WARRANTY
|
|
112
|
+
THE SKILLS ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
113
|
+
IMPLIED. THE OWNER IS NOT LIABLE FOR ANY DAMAGES ARISING FROM USE, TO THE
|
|
114
|
+
FULLEST EXTENT PERMITTED BY LAW.
|
|
115
|
+
|
|
116
|
+
8. TERM AND TERMINATION
|
|
117
|
+
This license lasts indefinitely and terminates automatically if the Student
|
|
118
|
+
breaches any condition above. Upon termination the Student must stop using
|
|
119
|
+
the Skills and delete all copies.
|
|
120
|
+
|
|
121
|
+
9. GOVERNING LAW
|
|
122
|
+
This license is governed by the laws of the Federative Republic of Brazil.
|
package/README.md
CHANGED
|
@@ -1,3 +1,127 @@
|
|
|
1
|
-
#
|
|
1
|
+
# D² [do Discovery ao Delivery] — Skills de Produto
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Coleção unificada de 10 Skills de IA da **Bruna Fonseca | b-a.BA Educação Corporativa**, para cobrir o caminho do Discovery ao Delivery.
|
|
4
|
+
|
|
5
|
+
## Skills incluídas
|
|
6
|
+
|
|
7
|
+
| Skill (pasta em `skills/`) | O que faz |
|
|
8
|
+
|---|---|
|
|
9
|
+
| `one-pager-produto` | Entrevista guiada que entrega um One-Pager de Produto em Markdown |
|
|
10
|
+
| `metricas-heart-produto` | Matriz de métricas com o framework HEART, fórmulas explicadas e preview opcional de dashboard |
|
|
11
|
+
| `story` | Entrevista para criar histórias de usuário com critérios de aceite |
|
|
12
|
+
| `spec` | Especificação técnica de um card |
|
|
13
|
+
| `plan` | Plano de execução técnico de um card |
|
|
14
|
+
| `execute` | Implementa o plano técnico aprovado |
|
|
15
|
+
| `bug` | Entrevista para documentar bugs reproduzíveis |
|
|
16
|
+
|
|
17
|
+
> `story`, `spec`, `plan`, `execute` e `bug` seguem o fluxo de entrega do Base Sender (GitHub Issues/Projects e `gh`). Os artefatos de spec e plano são gravados em `artefatos/<card_id>/`.
|
|
18
|
+
|
|
19
|
+
## Pré-requisitos
|
|
20
|
+
|
|
21
|
+
- Uma IA com suporte a Skills (formato `SKILL.md`): **Claude Code**, **GitHub Copilot** (VS Code, CLI ou cloud agent), **Antigravity**, **Codex**, **Gemini CLI**, **Cursor**, **OpenCode** ou **Windsurf**.
|
|
22
|
+
- **Opção A (recomendada):** Node.js 16+ para usar o `npx`.
|
|
23
|
+
- **Opção B (manual):** Node.js 16+ para baixar o pacote com `npm pack`.
|
|
24
|
+
|
|
25
|
+
## 1. Instalar com `npx` (recomendado)
|
|
26
|
+
|
|
27
|
+
Um comando, sem clonar o repositório:
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
npx @daoquadrado/skills
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
O instalador pergunta em quais ferramentas instalar (pode marcar várias, ex.: `1,2,4`) e o escopo (todos os projetos ou só o atual). Para pular as perguntas, use flags:
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
npx @daoquadrado/skills -t claude -g # Claude Code, todos os projetos
|
|
37
|
+
npx @daoquadrado/skills -t claude,copilot,antigravity -g # várias ferramentas de uma vez
|
|
38
|
+
npx @daoquadrado/skills -t all -p # todas as ferramentas, só neste projeto
|
|
39
|
+
npx @daoquadrado/skills -t claude -g -s story,spec,plan # só algumas Skills
|
|
40
|
+
npx @daoquadrado/skills list # lista as Skills do pacote
|
|
41
|
+
npx @daoquadrado/skills uninstall -t claude -g # remove as Skills do D²
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
| Opção | O que faz |
|
|
45
|
+
|---|---|
|
|
46
|
+
| `-t, --target <lista>` | Ferramentas separadas por vírgula, ou `all` |
|
|
47
|
+
| `-g, --global` / `-p, --project` | Escopo: pasta do usuário ou pasta atual |
|
|
48
|
+
| `-s, --skills <a,b,c>` | Instala só as Skills indicadas |
|
|
49
|
+
| `-f, --force` | Sobrescreve Skills já instaladas sem perguntar |
|
|
50
|
+
| `-y, --yes` | Não pergunta nada (padrão: Claude Code, global) |
|
|
51
|
+
|
|
52
|
+
### Onde cada ferramenta lê as Skills
|
|
53
|
+
|
|
54
|
+
| Ferramenta (`-t`) | Só neste projeto (`-p`) | Para todos os projetos (`-g`) |
|
|
55
|
+
|---|---|---|
|
|
56
|
+
| Claude Code (`claude`) | `.claude/skills/` | `~/.claude/skills/` |
|
|
57
|
+
| GitHub Copilot (`copilot`) | `.github/skills/` | `~/.copilot/skills/` |
|
|
58
|
+
| Antigravity (`antigravity`) | `.agents/skills/` | `~/.gemini/antigravity/skills/` |
|
|
59
|
+
| Codex (`codex`) | `.agents/skills/` | `~/.agents/skills/` |
|
|
60
|
+
| Gemini CLI (`gemini`) | `.gemini/skills/` | `~/.gemini/skills/` |
|
|
61
|
+
| Cursor (`cursor`) | `.cursor/skills/` | `~/.cursor/skills/` |
|
|
62
|
+
| OpenCode (`opencode`) | `.opencode/skills/` | `~/.config/opencode/skills/` |
|
|
63
|
+
| Windsurf (`windsurf`) | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
|
|
64
|
+
|
|
65
|
+
`~` é a sua pasta de usuário (no Windows, `C:\Users\SEU_USUARIO`). Quando duas ferramentas compartilham a mesma pasta (Codex e Antigravity no projeto), a instalação acontece uma vez só.
|
|
66
|
+
|
|
67
|
+
> Os caminhos seguem a documentação de cada ferramenta e podem mudar entre versões. Se a sua IA usar outra pasta, use a instalação manual abaixo apontando para ela.
|
|
68
|
+
|
|
69
|
+
## 2. Instalar manualmente (alternativa)
|
|
70
|
+
|
|
71
|
+
Cada Skill é uma pasta dentro de `skills/`. Instalar é copiar essas pastas para o diretório de Skills da sua IA (tabela acima).
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
npm pack @daoquadrado/skills
|
|
75
|
+
tar -xzf daoquadrado-skills-*.tgz
|
|
76
|
+
cd package
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
macOS / Linux / Git Bash (exemplo com Claude Code):
|
|
80
|
+
|
|
81
|
+
```bash
|
|
82
|
+
mkdir -p ~/.claude/skills
|
|
83
|
+
cp -r skills/* ~/.claude/skills/
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
Windows (PowerShell):
|
|
87
|
+
|
|
88
|
+
```powershell
|
|
89
|
+
New-Item -ItemType Directory -Force "$HOME\.claude\skills"
|
|
90
|
+
Copy-Item -Recurse -Force .\skills\* "$HOME\.claude\skills\"
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
Troque `.claude/skills` pelo caminho da sua ferramenta. Para instalar só algumas Skills, copie apenas as pastas que quiser (`cp -r skills/story ~/.claude/skills/`).
|
|
94
|
+
|
|
95
|
+
> A pasta da Skill deve ser copiada **inteira** (com `SKILL.md`, `references/`, `scripts/`, `assets/`). Não copie só o `SKILL.md`.
|
|
96
|
+
|
|
97
|
+
Depois de instalar, reabra a ferramenta. Invoque pelo nome: `/story` no Claude Code, Copilot, Gemini CLI e Cursor; `$story` no Codex. No Antigravity, OpenCode e Windsurf, cite a Skill pelo nome no pedido.
|
|
98
|
+
|
|
99
|
+
## 3. Conferir se funcionou
|
|
100
|
+
|
|
101
|
+
Peça à IA: *"Quais Skills você tem disponíveis?"*. Os nomes da tabela acima devem aparecer. Se não aparecerem, confira se a pasta copiada contém um `SKILL.md` direto dentro dela (`.../skills/NOME/SKILL.md`) e reabra a ferramenta.
|
|
102
|
+
|
|
103
|
+
## 4. Exemplos para começar
|
|
104
|
+
|
|
105
|
+
- `/one-pager-produto` — "Quero um one-pager da minha ideia de produto."
|
|
106
|
+
- `/prd-ux` — "Quero transformar minha ideia em PRD e protótipo no Lovable."
|
|
107
|
+
- `/metricas-heart-produto` — "Defina as métricas do meu produto com HEART."
|
|
108
|
+
- `/roadmap-lean-inception` — "Monte meu roadmap a partir destes épicos."
|
|
109
|
+
- `/validar-prototipo-persona` — "Valide este protótipo com a persona do arquivo persona.md."
|
|
110
|
+
|
|
111
|
+
## Observações
|
|
112
|
+
|
|
113
|
+
- `metricas-heart-produto` inclui a planilha `assets/base-metricas.xlsx`. Ela é pública se o repositório for público.
|
|
114
|
+
- `validar-prototipo-persona` precisa de uma ferramenta de navegação (browser) disponível na sua IA.
|
|
115
|
+
- `metricas-heart-produto` e `roadmap-lean-inception` trazem scripts Python opcionais; as Skills funcionam sem executá-los.
|
|
116
|
+
|
|
117
|
+
## Licença e uso
|
|
118
|
+
|
|
119
|
+
© 2026 Bruna Fonseca. Todos os direitos reservados. Este material **não é open source**.
|
|
120
|
+
|
|
121
|
+
- **Quem pode usar:** somente quem adquiriu o treinamento D² [do Discovery ao Delivery]. A licença é pessoal e não se estende à empresa, ao time ou a terceiros.
|
|
122
|
+
- **Permitido:** usar as Skills no seu trabalho e em projetos (inclusive comerciais) e adaptá-las para uso próprio.
|
|
123
|
+
- **Proibido sem autorização por escrito:** vender, redistribuir, publicar, compartilhar ou incluir as Skills em cursos, produtos ou serviços de terceiros.
|
|
124
|
+
|
|
125
|
+
Para pedir autorização, fale pelo site [www.daoquadrado.com.br](http://www.daoquadrado.com.br). Texto completo em [LICENSE](LICENSE).
|
|
126
|
+
|
|
127
|
+
Conheça o D² [do Discovery ao Delivery]: [www.daoquadrado.com.br](http://www.daoquadrado.com.br)
|
package/bin/cli.js
ADDED
|
@@ -0,0 +1,268 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
'use strict';
|
|
3
|
+
|
|
4
|
+
const fs = require('fs');
|
|
5
|
+
const os = require('os');
|
|
6
|
+
const path = require('path');
|
|
7
|
+
const readline = require('readline');
|
|
8
|
+
|
|
9
|
+
const SKILLS_DIR = path.join(__dirname, '..', 'skills');
|
|
10
|
+
|
|
11
|
+
// project: relativo à pasta atual; global: relativo à pasta do usuário.
|
|
12
|
+
// Ferramentas com o mesmo caminho (ex.: Codex e Antigravity no projeto) são instaladas uma vez só.
|
|
13
|
+
const TARGETS = {
|
|
14
|
+
claude: { label: 'Claude Code', project: '.claude/skills', global: '.claude/skills', invoke: '/' },
|
|
15
|
+
copilot: { label: 'GitHub Copilot', project: '.github/skills', global: '.copilot/skills', invoke: '/' },
|
|
16
|
+
codex: { label: 'Codex', project: '.agents/skills', global: '.agents/skills', invoke: '$' },
|
|
17
|
+
antigravity: { label: 'Antigravity', project: '.agents/skills', global: '.gemini/antigravity/skills', invoke: '' },
|
|
18
|
+
gemini: { label: 'Gemini CLI', project: '.gemini/skills', global: '.gemini/skills', invoke: '/' },
|
|
19
|
+
cursor: { label: 'Cursor', project: '.cursor/skills', global: '.cursor/skills', invoke: '/' },
|
|
20
|
+
opencode: { label: 'OpenCode', project: '.opencode/skills', global: '.config/opencode/skills', invoke: '' },
|
|
21
|
+
windsurf: { label: 'Windsurf', project: '.windsurf/skills', global: '.codeium/windsurf/skills', invoke: '' },
|
|
22
|
+
};
|
|
23
|
+
|
|
24
|
+
const HELP = `
|
|
25
|
+
D² [do Discovery ao Delivery] — instalador de Skills
|
|
26
|
+
|
|
27
|
+
Uso:
|
|
28
|
+
npx @daoquadrado/skills [comando] [opções]
|
|
29
|
+
|
|
30
|
+
Comandos:
|
|
31
|
+
install Instala as Skills (padrão)
|
|
32
|
+
list Lista as Skills disponíveis
|
|
33
|
+
uninstall Remove as Skills do D² já instaladas
|
|
34
|
+
|
|
35
|
+
Opções:
|
|
36
|
+
-t, --target <lista> Ferramentas, separadas por vírgula: claude, copilot,
|
|
37
|
+
codex, antigravity, gemini, cursor, opencode,
|
|
38
|
+
windsurf ou all (padrão: pergunta)
|
|
39
|
+
-g, --global Instala para todos os projetos (pasta do usuário)
|
|
40
|
+
-p, --project Instala só no projeto atual (pasta atual)
|
|
41
|
+
-s, --skills <a,b,c> Instala só estas Skills (padrão: todas)
|
|
42
|
+
-f, --force Sobrescreve Skills já existentes sem perguntar
|
|
43
|
+
-y, --yes Não pergunta nada; usa padrões (claude, global)
|
|
44
|
+
-h, --help Mostra esta ajuda
|
|
45
|
+
|
|
46
|
+
Exemplos:
|
|
47
|
+
npx @daoquadrado/skills
|
|
48
|
+
npx @daoquadrado/skills --target claude --global
|
|
49
|
+
npx @daoquadrado/skills -t claude,copilot,antigravity -g
|
|
50
|
+
npx @daoquadrado/skills -t all -p -s story,spec,plan
|
|
51
|
+
npx @daoquadrado/skills uninstall -t claude -g
|
|
52
|
+
`;
|
|
53
|
+
|
|
54
|
+
function parseArgs(argv) {
|
|
55
|
+
const opts = { command: 'install', skills: null };
|
|
56
|
+
const args = argv.slice();
|
|
57
|
+
if (args[0] && !args[0].startsWith('-')) opts.command = args.shift();
|
|
58
|
+
while (args.length) {
|
|
59
|
+
const a = args.shift();
|
|
60
|
+
switch (a) {
|
|
61
|
+
case '-t': case '--target': opts.target = args.shift(); break;
|
|
62
|
+
case '-g': case '--global': opts.scope = 'global'; break;
|
|
63
|
+
case '-p': case '--project': opts.scope = 'project'; break;
|
|
64
|
+
case '-s': case '--skills': opts.skills = (args.shift() || '').split(',').map((s) => s.trim()).filter(Boolean); break;
|
|
65
|
+
case '-f': case '--force': opts.force = true; break;
|
|
66
|
+
case '-y': case '--yes': opts.yes = true; break;
|
|
67
|
+
case '-h': case '--help': opts.help = true; break;
|
|
68
|
+
default: fail(`Opção desconhecida: ${a}\n${HELP}`);
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
return opts;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
function fail(msg) {
|
|
75
|
+
console.error(msg);
|
|
76
|
+
process.exit(1);
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
function availableSkills() {
|
|
80
|
+
if (!fs.existsSync(SKILLS_DIR)) fail('Pasta de Skills não encontrada no pacote.');
|
|
81
|
+
return fs.readdirSync(SKILLS_DIR, { withFileTypes: true })
|
|
82
|
+
.filter((e) => e.isDirectory() && fs.existsSync(path.join(SKILLS_DIR, e.name, 'SKILL.md')))
|
|
83
|
+
.map((e) => ({ name: e.name, description: readDescription(path.join(SKILLS_DIR, e.name, 'SKILL.md')) }))
|
|
84
|
+
.sort((a, b) => a.name.localeCompare(b.name));
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
function readDescription(file) {
|
|
88
|
+
const text = fs.readFileSync(file, 'utf8');
|
|
89
|
+
const fm = text.match(/^---\r?\n([\s\S]*?)\r?\n---/);
|
|
90
|
+
if (!fm) return '';
|
|
91
|
+
const m = fm[1].match(/^description:\s*(.*)$/m);
|
|
92
|
+
if (!m) return '';
|
|
93
|
+
return m[1].trim().replace(/^["']|["']$/g, '');
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
function ask(rl, question) {
|
|
97
|
+
return new Promise((resolve) => rl.question(question, (a) => resolve(a.trim())));
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
async function choose(rl, question, options, defaultIdx = 0) {
|
|
101
|
+
console.log(`\n${question}`);
|
|
102
|
+
options.forEach((o, i) => console.log(` ${i + 1}) ${o.label}${i === defaultIdx ? ' (padrão)' : ''}`));
|
|
103
|
+
for (;;) {
|
|
104
|
+
const a = await ask(rl, `Escolha [${defaultIdx + 1}]: `);
|
|
105
|
+
if (!a) return options[defaultIdx].value;
|
|
106
|
+
const n = Number(a);
|
|
107
|
+
if (Number.isInteger(n) && n >= 1 && n <= options.length) return options[n - 1].value;
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
function resolveTargets(value) {
|
|
112
|
+
const names = value === 'all' ? Object.keys(TARGETS) : value.split(',').map((v) => v.trim().toLowerCase()).filter(Boolean);
|
|
113
|
+
const bad = names.filter((n) => !TARGETS[n]);
|
|
114
|
+
if (bad.length || !names.length) fail(`Destino inválido: "${bad.join(', ') || value}". Use: ${Object.keys(TARGETS).join(', ')} ou all.`);
|
|
115
|
+
return names;
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
function destDir(target, scope) {
|
|
119
|
+
const base = scope === 'global' ? os.homedir() : process.cwd();
|
|
120
|
+
return path.join(base, ...TARGETS[target][scope].split('/'));
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
// Agrupa as ferramentas que compartilham a mesma pasta de destino.
|
|
124
|
+
function destinations(targets, scope) {
|
|
125
|
+
const map = new Map();
|
|
126
|
+
for (const t of targets) {
|
|
127
|
+
const dir = destDir(t, scope);
|
|
128
|
+
if (!map.has(dir)) map.set(dir, []);
|
|
129
|
+
map.get(dir).push(TARGETS[t].label);
|
|
130
|
+
}
|
|
131
|
+
return [...map].map(([dir, labels]) => ({ dir, label: labels.join(' / ') }));
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
function copyDir(src, dest) {
|
|
135
|
+
fs.mkdirSync(dest, { recursive: true });
|
|
136
|
+
for (const e of fs.readdirSync(src, { withFileTypes: true })) {
|
|
137
|
+
const s = path.join(src, e.name);
|
|
138
|
+
const d = path.join(dest, e.name);
|
|
139
|
+
if (e.isDirectory()) copyDir(s, d);
|
|
140
|
+
else fs.copyFileSync(s, d);
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
async function chooseTargets(rl) {
|
|
145
|
+
const keys = Object.keys(TARGETS);
|
|
146
|
+
console.log('\nOnde instalar as Skills? (varias separadas por virgula, ex.: 1,2)');
|
|
147
|
+
keys.forEach((k, i) => console.log(` ${i + 1}) ${TARGETS[k].label}`));
|
|
148
|
+
console.log(` ${keys.length + 1}) Todas`);
|
|
149
|
+
for (;;) {
|
|
150
|
+
const a = await ask(rl, 'Escolha [1]: ');
|
|
151
|
+
if (!a) return keys[0];
|
|
152
|
+
const nums = a.split(',').map((n) => Number(n.trim()));
|
|
153
|
+
if (nums.includes(keys.length + 1)) return 'all';
|
|
154
|
+
if (nums.every((n) => Number.isInteger(n) && n >= 1 && n <= keys.length)) return nums.map((n) => keys[n - 1]).join(',');
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
async function resolveOptions(opts) {
|
|
159
|
+
const interactive = !opts.yes && process.stdin.isTTY && (!opts.target || !opts.scope);
|
|
160
|
+
let rl;
|
|
161
|
+
if (interactive) rl = readline.createInterface({ input: process.stdin, output: process.stdout });
|
|
162
|
+
try {
|
|
163
|
+
if (!opts.target) {
|
|
164
|
+
opts.target = interactive ? await chooseTargets(rl) : 'claude';
|
|
165
|
+
}
|
|
166
|
+
if (!opts.scope) {
|
|
167
|
+
opts.scope = interactive
|
|
168
|
+
? await choose(rl, 'Para qual escopo?', [
|
|
169
|
+
{ label: 'Todos os projetos (pasta do usuário)', value: 'global' },
|
|
170
|
+
{ label: 'Somente este projeto (pasta atual)', value: 'project' },
|
|
171
|
+
])
|
|
172
|
+
: 'global';
|
|
173
|
+
}
|
|
174
|
+
} finally {
|
|
175
|
+
if (rl) rl.close();
|
|
176
|
+
}
|
|
177
|
+
return opts;
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
async function confirmOverwrite(name, dest) {
|
|
181
|
+
if (!process.stdin.isTTY) return false;
|
|
182
|
+
const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
|
|
183
|
+
const a = await ask(rl, ` "${name}" já existe em ${dest}. Sobrescrever? [s/N] `);
|
|
184
|
+
rl.close();
|
|
185
|
+
return /^s(im)?$|^y(es)?$/i.test(a);
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
function selectSkills(all, wanted) {
|
|
189
|
+
if (!wanted || !wanted.length) return all;
|
|
190
|
+
const names = new Set(all.map((s) => s.name));
|
|
191
|
+
const unknown = wanted.filter((w) => !names.has(w));
|
|
192
|
+
if (unknown.length) fail(`Skill(s) não encontrada(s): ${unknown.join(', ')}\nDisponíveis: ${[...names].join(', ')}`);
|
|
193
|
+
return all.filter((s) => wanted.includes(s.name));
|
|
194
|
+
}
|
|
195
|
+
|
|
196
|
+
async function install(opts) {
|
|
197
|
+
const skills = selectSkills(availableSkills(), opts.skills);
|
|
198
|
+
await resolveOptions(opts);
|
|
199
|
+
const targets = resolveTargets(opts.target);
|
|
200
|
+
let installed = 0;
|
|
201
|
+
let skipped = 0;
|
|
202
|
+
|
|
203
|
+
for (const { dir: base, label } of destinations(targets, opts.scope)) {
|
|
204
|
+
console.log(`\n${label} → ${base}`);
|
|
205
|
+
fs.mkdirSync(base, { recursive: true });
|
|
206
|
+
for (const s of skills) {
|
|
207
|
+
const dest = path.join(base, s.name);
|
|
208
|
+
if (fs.existsSync(dest) && !opts.force) {
|
|
209
|
+
if (!(await confirmOverwrite(s.name, base))) {
|
|
210
|
+
console.log(` - ${s.name} (ignorada)`);
|
|
211
|
+
skipped++;
|
|
212
|
+
continue;
|
|
213
|
+
}
|
|
214
|
+
}
|
|
215
|
+
fs.rmSync(dest, { recursive: true, force: true });
|
|
216
|
+
copyDir(path.join(SKILLS_DIR, s.name), dest);
|
|
217
|
+
console.log(` ✓ ${s.name}`);
|
|
218
|
+
installed++;
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
|
|
222
|
+
console.log(`\n${installed} Skill(s) instalada(s)${skipped ? `, ${skipped} ignorada(s)` : ''}.`);
|
|
223
|
+
if (installed) {
|
|
224
|
+
console.log('Reabra a ferramenta e invoque pelo nome:');
|
|
225
|
+
for (const t of targets) console.log(` ${TARGETS[t].label}: ${TARGETS[t].invoke}${skills[0].name}`.trimEnd());
|
|
226
|
+
}
|
|
227
|
+
}
|
|
228
|
+
|
|
229
|
+
function uninstall(opts) {
|
|
230
|
+
const skills = selectSkills(availableSkills(), opts.skills);
|
|
231
|
+
const target = opts.target || 'claude';
|
|
232
|
+
const scope = opts.scope || 'global';
|
|
233
|
+
let removed = 0;
|
|
234
|
+
for (const { dir: base } of destinations(resolveTargets(target), scope)) {
|
|
235
|
+
for (const s of skills) {
|
|
236
|
+
const dest = path.join(base, s.name);
|
|
237
|
+
if (!fs.existsSync(dest)) continue;
|
|
238
|
+
fs.rmSync(dest, { recursive: true, force: true });
|
|
239
|
+
console.log(` ✓ removida ${s.name} de ${base}`);
|
|
240
|
+
removed++;
|
|
241
|
+
}
|
|
242
|
+
}
|
|
243
|
+
console.log(`\n${removed} Skill(s) removida(s).`);
|
|
244
|
+
}
|
|
245
|
+
|
|
246
|
+
function list() {
|
|
247
|
+
const skills = availableSkills();
|
|
248
|
+
console.log(`\nSkills do D² [do Discovery ao Delivery] (${skills.length}):\n`);
|
|
249
|
+
const width = Math.max(...skills.map((s) => s.name.length));
|
|
250
|
+
for (const s of skills) {
|
|
251
|
+
const desc = s.description.length > 90 ? `${s.description.slice(0, 87)}...` : s.description;
|
|
252
|
+
console.log(` ${s.name.padEnd(width)} ${desc}`);
|
|
253
|
+
}
|
|
254
|
+
console.log('');
|
|
255
|
+
}
|
|
256
|
+
|
|
257
|
+
async function main() {
|
|
258
|
+
const opts = parseArgs(process.argv.slice(2));
|
|
259
|
+
if (opts.help || opts.command === 'help') return console.log(HELP);
|
|
260
|
+
switch (opts.command) {
|
|
261
|
+
case 'install': return install(opts);
|
|
262
|
+
case 'list': return list();
|
|
263
|
+
case 'uninstall': return uninstall(opts);
|
|
264
|
+
default: return fail(`Comando desconhecido: ${opts.command}\n${HELP}`);
|
|
265
|
+
}
|
|
266
|
+
}
|
|
267
|
+
|
|
268
|
+
main().catch((err) => fail(`Erro: ${err.message}`));
|
package/package.json
CHANGED
|
@@ -1,6 +1,35 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@daoquadrado/skills",
|
|
3
|
-
"version": "
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "1.0.1",
|
|
4
|
+
"description": "D² [do Discovery ao Delivery] — instala o pack de Skills de Produto no Claude Code e no Codex",
|
|
5
|
+
"bin": {
|
|
6
|
+
"daoquadrado": "bin/cli.js"
|
|
7
|
+
},
|
|
8
|
+
"files": [
|
|
9
|
+
"bin",
|
|
10
|
+
"skills",
|
|
11
|
+
"LICENSE"
|
|
12
|
+
],
|
|
13
|
+
"keywords": [
|
|
14
|
+
"claude-code",
|
|
15
|
+
"codex",
|
|
16
|
+
"skills",
|
|
17
|
+
"agent-skills",
|
|
18
|
+
"product-management",
|
|
19
|
+
"discovery",
|
|
20
|
+
"delivery"
|
|
21
|
+
],
|
|
22
|
+
"author": "Bruna Fonseca | b-a.BA Educação Corporativa",
|
|
23
|
+
"license": "SEE LICENSE IN LICENSE",
|
|
24
|
+
"repository": {
|
|
25
|
+
"type": "git",
|
|
26
|
+
"url": "git+https://github.com/pedropagotto/daoquadrado-skills.git"
|
|
27
|
+
},
|
|
28
|
+
"engines": {
|
|
29
|
+
"node": ">=16"
|
|
30
|
+
},
|
|
31
|
+
"publishConfig": {
|
|
32
|
+
"access": "public"
|
|
33
|
+
},
|
|
34
|
+
"homepage": "https://www.daoquadrado.com.br"
|
|
35
|
+
}
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: bug
|
|
3
|
+
description: Entrevista interativa para documentar bugs completos e reproduzíveis, com classificação de prioridade e card pronto para o board. Use ao registrar um erro, comportamento inesperado ou falha reportada por usuário.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# /bug — Assistente de Registro de Bug (Bug Wizard)
|
|
7
|
+
|
|
8
|
+
Alvo (card/relato/argumentos): **$ARGUMENTS**
|
|
9
|
+
|
|
10
|
+
Você atua de forma interativa e empática com a Product Manager (PM), ajudando-a a documentar bugs de forma completa e estruturada, sem exigir conhecimento técnico profundo. O objetivo é capturar tudo o que é necessário para reproduzir e corrigir o problema sem sobrecarregar a PM.
|
|
11
|
+
|
|
12
|
+
> **Regra do Card**: o card (Issue no GitHub) contém **somente o relato do bug**. Se a correção exigir Spec ou Plano, eles são gerados pelas skills `/spec` e `/plan`, nunca escritos no card.
|
|
13
|
+
|
|
14
|
+
O template oficial está em `references/bug-template.md`. **Siga-o sempre**, sem inventar estrutura própria.
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## 1. Condução e boas práticas
|
|
19
|
+
|
|
20
|
+
- **Perguntas passo a passo**: nunca envie todas as perguntas de uma vez. Faça uma pergunta simples por vez, espere a resposta e avance.
|
|
21
|
+
- **Termos acessíveis**: fale de telas, botões, mensagens de erro e fluxos visuais.
|
|
22
|
+
- **Tom empático**: a PM provavelmente reporta algo que frustrou um usuário ou ela mesma. Reconheça isso antes de perguntar.
|
|
23
|
+
- **Modo Detetive**: se a PM não souber descrever o comportamento esperado ou o contexto técnico, ative o passo 3.
|
|
24
|
+
|
|
25
|
+
## 2. Roteiro de perguntas
|
|
26
|
+
|
|
27
|
+
Guie a PM pelas etapas para preencher o template:
|
|
28
|
+
|
|
29
|
+
1. **Título e localização**: *"Qual é o problema em uma frase? E em qual parte do sistema ele ocorre? (ex: listagem de WABAs, cadastro de usuário, meu perfil)"*
|
|
30
|
+
2. **Passos para reproduzir**: *"Me conta o caminho que você (ou o usuário) fazia quando o problema apareceu. Quais ações, na ordem?"*
|
|
31
|
+
3. **Esperado vs. obtido**: *"O que deveria ter acontecido? E o que aconteceu de fato?"*
|
|
32
|
+
4. **Evidências**: *"Tem print ou vídeo do momento do erro? Se houver mensagem de erro na tela, pode copiar o texto aqui?"* Se necessário: *"Se conseguir abrir o navegador e apertar F12, aparece algo em vermelho na aba 'Console'?"*
|
|
33
|
+
5. **Ambiente e contexto**: *"Está em produção ou sandbox? Qual navegador?"*
|
|
34
|
+
6. **Perfil do usuário**: *"Com qual perfil você estava logada — Admin, Gestor ou Operador? Acontece com os outros perfis também?"*
|
|
35
|
+
7. **Impacto**: *"Quantos usuários ou processos isso afeta? Bloqueia o uso do sistema ou dá para contornar por enquanto?"*
|
|
36
|
+
8. **Frequência**: *"Acontece toda vez ou de vez em quando, sem motivo claro?"*
|
|
37
|
+
9. **Critério de resolução**: *"Como você vai saber que o bug foi corrigido? O que precisa funcionar para validar a correção?"*
|
|
38
|
+
|
|
39
|
+
## 3. Modo Detetive (análise do sistema existente)
|
|
40
|
+
|
|
41
|
+
Se a PM não souber descrever o comportamento correto ou o contexto técnico:
|
|
42
|
+
|
|
43
|
+
1. **Pesquise as especificações existentes** (pasta `specs/` do repositório de documentação) para identificar o comportamento esperado da funcionalidade relatada.
|
|
44
|
+
2. **Analise o código local**: com a confirmação da PM sobre o repositório, investigue o `base-sender-core`:
|
|
45
|
+
- **Frontend**: `src/client/src/Pages/` e `src/client/src/Components/` para entender o fluxo visual da tela.
|
|
46
|
+
- **Backend**: `src/BaseSender.Api/Features/{Área}/` para encontrar regras de negócio, validações FluentValidation e pontos de falha.
|
|
47
|
+
- **Integrações**: se envolver WABA ou números, considere que Meta, Pontal e Sisbratel são sistemas externos; o comportamento pode vir de lá, e não do Base Sender.
|
|
48
|
+
3. **Hipótese de causa**: formule hipóteses simples e valide com a PM: *"Pelo que você descreve, parece que o problema acontece quando [situação]. Faz sentido com o que você vê?"*
|
|
49
|
+
|
|
50
|
+
## 4. Determinação de prioridade
|
|
51
|
+
|
|
52
|
+
| Prioridade | Critério |
|
|
53
|
+
|---|---|
|
|
54
|
+
| 🔴 **Crítico** | Funcionalidade principal bloqueada para todos os usuários. Correção imediata. |
|
|
55
|
+
| 🟠 **Alto** | Funcionalidade comprometida para um grupo de usuários ou cenários específicos. Correção na próxima sprint. |
|
|
56
|
+
| 🟡 **Médio** | Comportamento incorreto sem bloqueio do fluxo principal. Pode ser agendado. |
|
|
57
|
+
| 🟢 **Baixo** | Problema cosmético ou de baixo impacto. Vai para o backlog. |
|
|
58
|
+
|
|
59
|
+
Pergunte: *"Você classificaria esse bug como crítico, alto, médio ou baixo? Posso sugerir se quiser."*
|
|
60
|
+
|
|
61
|
+
## 5. Geração e gravação do card (somente o relato do bug)
|
|
62
|
+
|
|
63
|
+
1. Formate o bug completo conforme `references/bug-template.md`.
|
|
64
|
+
2. Apresente o bug formatado no chat e peça aprovação explícita antes de criar o card.
|
|
65
|
+
3. **Antes de criar, verifique se já existe um card equivalente** (evite duplicar): liste as Issues/cards do board (`gh issue list` ou o quadro do GitHub Projects).
|
|
66
|
+
4. Se a PM autorizar, o card contém **apenas** o relato formatado. Título no formato `[Módulo] Título curto do bug`. Exemplo:
|
|
67
|
+
```
|
|
68
|
+
gh issue create --repo <org>/docs --title "[Módulo] Título curto do bug" --body-file bug.md
|
|
69
|
+
```
|
|
70
|
+
5. Se a PM pedir para ajustar um card existente, edite-o (`gh issue edit`), nunca crie duplicado.
|
|
71
|
+
6. **Posicione o card na coluna de bugs** (`BUGS`) do quadro de projetos.
|
|
72
|
+
7. **Não salve rascunho local** por padrão; só se a PM pedir (`bug_draft_{titulo}.md`).
|
|
73
|
+
8. Apresente o resultado:
|
|
74
|
+
- ✅ Bug documentado e formatado.
|
|
75
|
+
- ✅ Card criado/atualizado (número do card).
|
|
76
|
+
- ✅ Rascunho salvo localmente (somente se solicitado).
|
|
77
|
+
|
|
78
|
+
## 6. Dicas para uma boa documentação de bug
|
|
79
|
+
|
|
80
|
+
- **Seja específico**: "Não salvou" é vago. "Ao clicar em Salvar, a tela exibiu 'Erro inesperado' e o formulário voltou vazio" é útil.
|
|
81
|
+
- **Um bug por card**: se a PM reportar dois bugs, crie dois cards.
|
|
82
|
+
- **Bug versus melhoria**: se o comportamento nunca foi definido (não é erro, só poderia ser melhor), o correto é criar uma história com `/story`.
|
|
83
|
+
- **Sensível ou urgente?**: se envolver dados incorretos exibidos a clientes, vazamento entre empresas (falha de isolamento multi-tenant) ou falha de segurança, marque como Crítico e avise o time imediatamente.
|