opencode-skills-collection 3.0.2 → 3.0.4
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/README.md +1 -2
- package/bundled-skills/.antigravity-install-manifest.json +3 -1
- package/bundled-skills/20-andruia-niche-intelligence/SKILL.md +1 -1
- package/bundled-skills/advogado-criminal/SKILL.md +49 -49
- package/bundled-skills/advogado-especialista/SKILL.md +49 -49
- package/bundled-skills/agent-memory-systems/SKILL.md +1 -1
- package/bundled-skills/agents-v2-py/SKILL.md +1 -1
- package/bundled-skills/ai-product/SKILL.md +7 -7
- package/bundled-skills/amazon-alexa/SKILL.md +14 -14
- package/bundled-skills/andrej-karpathy/SKILL.md +12 -12
- package/bundled-skills/angular-best-practices/SKILL.md +0 -4
- package/bundled-skills/apify-actorization/SKILL.md +2 -2
- package/bundled-skills/audit-context-building/SKILL.md +8 -8
- package/bundled-skills/auri-core/SKILL.md +9 -9
- package/bundled-skills/autonomous-agents/SKILL.md +1 -1
- package/bundled-skills/azure-search-documents-py/SKILL.md +5 -5
- package/bundled-skills/backend-dev-guidelines/SKILL.md +13 -13
- package/bundled-skills/bill-gates/SKILL.md +2 -2
- package/bundled-skills/browser-automation/SKILL.md +14 -14
- package/bundled-skills/carrier-relationship-management/SKILL.md +1 -1
- package/bundled-skills/cc-skill-security-review/SKILL.md +1 -1
- package/bundled-skills/cred-omega/SKILL.md +21 -21
- package/bundled-skills/customs-trade-compliance/SKILL.md +1 -1
- package/bundled-skills/docker-expert/SKILL.md +1 -1
- package/bundled-skills/docs/integrations/jetski-cortex.md +3 -3
- package/bundled-skills/docs/integrations/jetski-gemini-loader/README.md +1 -1
- package/bundled-skills/docs/maintainers/repo-growth-seo.md +3 -3
- package/bundled-skills/docs/maintainers/skills-update-guide.md +1 -1
- package/bundled-skills/docs/users/bundles.md +1 -1
- package/bundled-skills/docs/users/claude-code-skills.md +1 -1
- package/bundled-skills/docs/users/gemini-cli-skills.md +1 -1
- package/bundled-skills/docs/users/getting-started.md +1 -1
- package/bundled-skills/docs/users/kiro-integration.md +1 -1
- package/bundled-skills/docs/users/usage.md +4 -4
- package/bundled-skills/docs/users/visual-guide.md +4 -4
- package/bundled-skills/elon-musk/SKILL.md +50 -50
- package/bundled-skills/email-systems/SKILL.md +18 -18
- package/bundled-skills/energy-procurement/SKILL.md +1 -1
- package/bundled-skills/evaluation/SKILL.md +1 -1
- package/bundled-skills/frontend-dev-guidelines/SKILL.md +16 -16
- package/bundled-skills/git-pr-review/SKILL.md +167 -0
- package/bundled-skills/hosted-agents/SKILL.md +1 -1
- package/bundled-skills/hosted-agents-v2-py/SKILL.md +1 -1
- package/bundled-skills/ilya-sutskever/SKILL.md +18 -18
- package/bundled-skills/image-studio/SKILL.md +6 -6
- package/bundled-skills/inventory-demand-planning/SKILL.md +1 -1
- package/bundled-skills/leiloeiro-edital/SKILL.md +4 -4
- package/bundled-skills/leiloeiro-juridico/SKILL.md +8 -8
- package/bundled-skills/leiloeiro-risco/SKILL.md +2 -2
- package/bundled-skills/linear-claude-skill/SKILL.md +0 -24
- package/bundled-skills/linkedin-cli/SKILL.md +1 -1
- package/bundled-skills/logistics-exception-management/SKILL.md +1 -1
- package/bundled-skills/matematico-tao/SKILL.md +6 -6
- package/bundled-skills/mental-health-analyzer/SKILL.md +1 -1
- package/bundled-skills/multi-advisor/SKILL.md +8 -8
- package/bundled-skills/nestjs-expert/SKILL.md +1 -1
- package/bundled-skills/nodejs-best-practices/SKILL.md +2 -2
- package/bundled-skills/postgres-best-practices/SKILL.md +1 -1
- package/bundled-skills/prisma-expert/SKILL.md +1 -1
- package/bundled-skills/product-inventor/SKILL.md +5 -5
- package/bundled-skills/production-scheduling/SKILL.md +1 -1
- package/bundled-skills/quality-nonconformance/SKILL.md +1 -1
- package/bundled-skills/react-best-practices/SKILL.md +1 -1
- package/bundled-skills/react-patterns/SKILL.md +8 -0
- package/bundled-skills/rehabilitation-analyzer/SKILL.md +1 -1
- package/bundled-skills/returns-reverse-logistics/SKILL.md +1 -1
- package/bundled-skills/skill-audit/SKILL.md +174 -0
- package/bundled-skills/skill-rails-upgrade/SKILL.md +2 -2
- package/bundled-skills/social-orchestrator/SKILL.md +4 -4
- package/bundled-skills/steve-jobs/SKILL.md +24 -24
- package/bundled-skills/telegram/SKILL.md +1 -1
- package/bundled-skills/typescript-expert/SKILL.md +1 -1
- package/bundled-skills/ui-ux-pro-max/SKILL.md +1 -1
- package/bundled-skills/verification-before-completion/SKILL.md +1 -1
- package/bundled-skills/voice-agents/SKILL.md +27 -27
- package/bundled-skills/warren-buffett/SKILL.md +2 -2
- package/bundled-skills/whatsapp-cloud-api/SKILL.md +1 -1
- package/bundled-skills/wiki-architect/SKILL.md +1 -1
- package/bundled-skills/wiki-changelog/SKILL.md +1 -1
- package/bundled-skills/wiki-onboarding/SKILL.md +1 -1
- package/bundled-skills/wiki-page-writer/SKILL.md +1 -1
- package/bundled-skills/wiki-qa/SKILL.md +1 -1
- package/bundled-skills/wiki-researcher/SKILL.md +1 -1
- package/bundled-skills/wiki-vitepress/SKILL.md +1 -1
- package/bundled-skills/workflow-automation/SKILL.md +10 -10
- package/bundled-skills/zapier-make-patterns/SKILL.md +10 -10
- package/package.json +1 -1
- package/skills_index.json +44 -0
|
@@ -108,7 +108,7 @@ A combinação que Karpathy representa é genuinamente rara:
|
|
|
108
108
|
|
|
109
109
|
---
|
|
110
110
|
|
|
111
|
-
|
|
111
|
+
### 2.1 — Software 2.0
|
|
112
112
|
|
|
113
113
|
Publicado no Medium em 2017, este é o ensaio mais original e influente de Karpathy.
|
|
114
114
|
A tese central mudou como a comunidade pensa sobre o que é programação:
|
|
@@ -147,7 +147,7 @@ the training data and curate the dataset. We are reprogramming computers with da
|
|
|
147
147
|
**Com LLMs (2023):** Dataset = internet inteira. Loss = cross-entropy no próximo token.
|
|
148
148
|
Emergência de capacidades que ninguém especificou explicitamente. Software 2.0 em escala máxima.
|
|
149
149
|
|
|
150
|
-
|
|
150
|
+
### 2.2 — Llms Como Sistema Operacional
|
|
151
151
|
|
|
152
152
|
Esta analogia, desenvolvida em 2023 (especialmente na palestra "State of GPT" no
|
|
153
153
|
Microsoft Build), reframeu como pensar em LLMs como plataforma:
|
|
@@ -182,7 +182,7 @@ entendem linguagem natural e podem executar tarefas complexas quando instruídos
|
|
|
182
182
|
em inglês, então inglês se tornou literalmente uma linguagem de programação —
|
|
183
183
|
uma que qualquer falante nativo já "sabe", sem precisar aprender sintaxe especial.
|
|
184
184
|
|
|
185
|
-
|
|
185
|
+
### 2.3 — Bottom-Up Learning (Filosofia Pedagógica Central)
|
|
186
186
|
|
|
187
187
|
A regra mais importante: construa do zero antes de usar a biblioteca. Entenda a
|
|
188
188
|
abstração antes de depender dela.
|
|
@@ -205,7 +205,7 @@ o estudante entende cada componente de qualquer LLM moderno.
|
|
|
205
205
|
**Citação:** "The library is just convenience; the math is the substance. Once you
|
|
206
206
|
understand how backprop works, you can use PyTorch with full confidence."
|
|
207
207
|
|
|
208
|
-
|
|
208
|
+
### 2.4 — Vibe Coding
|
|
209
209
|
|
|
210
210
|
Termo cunhado por Karpathy em fevereiro de 2025 em um tweet que viralizou na
|
|
211
211
|
comunidade de programação. Define uma nova modalidade de desenvolvimento de
|
|
@@ -243,7 +243,7 @@ pequenos e exploratórios: superpotência. Para engenharia séria: ainda precisa
|
|
|
243
243
|
pessoas que entendem o código. Mesmo "vibers" se beneficiam de fundamentos sólidos —
|
|
244
244
|
para reconhecer quando o LLM gerou algo incorreto.
|
|
245
245
|
|
|
246
|
-
|
|
246
|
+
### 2.5 — Scaling Laws E Emergência
|
|
247
247
|
|
|
248
248
|
**O que são scaling laws:** Relações empíricas mostrando que performance melhora
|
|
249
249
|
previsível e regularmente com mais parâmetros (N), mais dados (D), mais compute (C).
|
|
@@ -264,7 +264,7 @@ teoricamente melhor que não escala em hardware disponível.
|
|
|
264
264
|
|
|
265
265
|
---
|
|
266
266
|
|
|
267
|
-
|
|
267
|
+
### 3.1 — Contexto E Missão
|
|
268
268
|
|
|
269
269
|
Karpathy entrou na Tesla em junho de 2017 como Director of AI, assumindo
|
|
270
270
|
responsabilidade pela equipe de visão e machine learning do Autopilot.
|
|
@@ -276,7 +276,7 @@ faixa para uma arquitetura de visão end-to-end capaz de condução autônoma em
|
|
|
276
276
|
condições gerais. A stack construída foi a mais complexa e sofisticada de visão
|
|
277
277
|
computacional já deployada em escala de produção massiva.
|
|
278
278
|
|
|
279
|
-
|
|
279
|
+
### 3.2 — A Decisão Cameras-Only (Vs Lidar)
|
|
280
280
|
|
|
281
281
|
Este é talvez o debate técnico mais importante da carreira de Karpathy, e ele
|
|
282
282
|
articulou o argumento com precisão cirúrgica:
|
|
@@ -314,7 +314,7 @@ articulou o argumento com precisão cirúrgica:
|
|
|
314
314
|
- A abordagem cameras-only coloca peso enorme na rede neural — funciona se e
|
|
315
315
|
somente se a rede for suficientemente boa, o que é uma aposta high-stakes.
|
|
316
316
|
|
|
317
|
-
|
|
317
|
+
### 3.3 — Hydranet: Uma Rede Para Tudo
|
|
318
318
|
|
|
319
319
|
Apresentado no Tesla AI Day (agosto 2021), o HydraNet é a arquitetura central
|
|
320
320
|
de visão da Tesla descrita por Karpathy:
|
|
@@ -351,7 +351,7 @@ Backbone ──────────┼─── Head: Velocity Estimation (v
|
|
|
351
351
|
um espaço de features compartilhado — o modelo "vê" o mundo 360° como um único
|
|
352
352
|
volume de features, não como imagens separadas.
|
|
353
353
|
|
|
354
|
-
|
|
354
|
+
### 3.4 — A Data Engine: O Produto Real
|
|
355
355
|
|
|
356
356
|
O conceito mais sofisticado que Karpathy desenvolveu e articulou na Tesla.
|
|
357
357
|
Sua tese: o modelo de produção não é o produto. A data engine — o sistema de
|
|
@@ -392,7 +392,7 @@ loop fechado entre frota, anotação e treinamento — é o produto.
|
|
|
392
392
|
|
|
393
393
|
**Citação:** "The data engi
|
|
394
394
|
|
|
395
|
-
|
|
395
|
+
### 3.5 — Dojo: Supercomputador Para Visão
|
|
396
396
|
|
|
397
397
|
Anunciado no Tesla AI Day 2021, Dojo foi o supercomputador proprietário da Tesla
|
|
398
398
|
para treinamento de modelos de visão. Karpathy foi central na visão técnica:
|
|
@@ -403,7 +403,7 @@ para treinamento de modelos de visão. Karpathy foi central na visão técnica:
|
|
|
403
403
|
- A decisão de construir hardware próprio reflete a filosofia de controle da stack
|
|
404
404
|
que tanto Karpathy quanto Musk defendem
|
|
405
405
|
|
|
406
|
-
|
|
406
|
+
### 3.6 — O Que Karpathy Aprendeu Na Tesla
|
|
407
407
|
|
|
408
408
|
Em entrevistas e tweets após sair, Karpathy articulou as lições mais importantes:
|
|
409
409
|
|
|
@@ -424,7 +424,7 @@ Em entrevistas e tweets após sair, Karpathy articulou as lições mais importan
|
|
|
424
424
|
|
|
425
425
|
---
|
|
426
426
|
|
|
427
|
-
|
|
427
|
+
### 4.1 — Micrograd
|
|
428
428
|
|
|
429
429
|
**Repositório:** github.com/karpathy/micrograd
|
|
430
430
|
**Tamanho:** ~100 linhas de Python puro
|
|
@@ -557,10 +557,6 @@ export class Component implements OnInit, OnDestroy {
|
|
|
557
557
|
- [Zoneless Angular](https://angular.dev/guide/experimental/zoneless)
|
|
558
558
|
- [Angular SSR Guide](https://angular.dev/guide/ssr)
|
|
559
559
|
- [Change Detection Deep Dive](https://angular.dev/guide/change-detection)
|
|
560
|
-
|
|
561
|
-
## When to Use
|
|
562
|
-
This skill is applicable to execute the workflow or actions described in the overview.
|
|
563
|
-
|
|
564
560
|
## Limitations
|
|
565
561
|
- Use this skill only when the task clearly matches the scope described above.
|
|
566
562
|
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
|
|
@@ -115,7 +115,7 @@ See [schemas-and-output.md](references/schemas-and-output.md) for detailed confi
|
|
|
115
115
|
|
|
116
116
|
Validate schemas against `@apify/json_schemas` npm package.
|
|
117
117
|
|
|
118
|
-
## Step
|
|
118
|
+
## Step 4: Test Locally
|
|
119
119
|
|
|
120
120
|
Run the actor with inline input (for JS/TS and Python actors):
|
|
121
121
|
|
|
@@ -131,7 +131,7 @@ apify run --input-file ./test-input.json
|
|
|
131
131
|
|
|
132
132
|
**Important:** Always use `apify run`, not `npm start` or `python main.py`. The CLI sets up the proper environment and storage.
|
|
133
133
|
|
|
134
|
-
## Step
|
|
134
|
+
## Step 5: Deploy
|
|
135
135
|
|
|
136
136
|
```bash
|
|
137
137
|
apify push
|
|
@@ -37,7 +37,7 @@ Do **not** use for:
|
|
|
37
37
|
|
|
38
38
|
---
|
|
39
39
|
|
|
40
|
-
##
|
|
40
|
+
## 2. How This Skill Behaves
|
|
41
41
|
|
|
42
42
|
When active, Claude will:
|
|
43
43
|
- Default to **ultra-granular analysis** of each block and line.
|
|
@@ -64,7 +64,7 @@ Goal: **deep, accurate understanding**, not conclusions.
|
|
|
64
64
|
|
|
65
65
|
---
|
|
66
66
|
|
|
67
|
-
##
|
|
67
|
+
## 3. Phase 1 — Initial Orientation (Bottom-Up Scan)
|
|
68
68
|
|
|
69
69
|
Before deep analysis, Claude performs a minimal mapping:
|
|
70
70
|
|
|
@@ -78,7 +78,7 @@ This establishes anchors for detailed analysis.
|
|
|
78
78
|
|
|
79
79
|
---
|
|
80
80
|
|
|
81
|
-
##
|
|
81
|
+
## 4. Phase 2 — Ultra-Granular Function Analysis (Default Mode)
|
|
82
82
|
|
|
83
83
|
Every non-trivial function receives full micro analysis.
|
|
84
84
|
|
|
@@ -199,7 +199,7 @@ Analysis is complete when all checklist items are satisfied and no unresolved "u
|
|
|
199
199
|
|
|
200
200
|
---
|
|
201
201
|
|
|
202
|
-
##
|
|
202
|
+
## 5. Phase 3 — Global System Understanding
|
|
203
203
|
|
|
204
204
|
After sufficient micro-analysis:
|
|
205
205
|
|
|
@@ -227,7 +227,7 @@ These clusters help guide the vulnerability-hunting phase.
|
|
|
227
227
|
|
|
228
228
|
---
|
|
229
229
|
|
|
230
|
-
##
|
|
230
|
+
## 6. Stability & Consistency Rules
|
|
231
231
|
*(Anti-Hallucination, Anti-Contradiction)*
|
|
232
232
|
|
|
233
233
|
Claude must:
|
|
@@ -255,7 +255,7 @@ Claude must:
|
|
|
255
255
|
|
|
256
256
|
---
|
|
257
257
|
|
|
258
|
-
##
|
|
258
|
+
## 7. Subagent Usage
|
|
259
259
|
|
|
260
260
|
Claude may spawn subagents for:
|
|
261
261
|
- Dense or complex functions.
|
|
@@ -275,7 +275,7 @@ Subagents must:
|
|
|
275
275
|
|
|
276
276
|
---
|
|
277
277
|
|
|
278
|
-
##
|
|
278
|
+
## 8. Relationship to Other Phases
|
|
279
279
|
|
|
280
280
|
This skill runs **before**:
|
|
281
281
|
- Vulnerability discovery
|
|
@@ -291,7 +291,7 @@ It exists solely to build:
|
|
|
291
291
|
|
|
292
292
|
---
|
|
293
293
|
|
|
294
|
-
##
|
|
294
|
+
## 9. Non-Goals
|
|
295
295
|
|
|
296
296
|
While active, Claude should NOT:
|
|
297
297
|
- Identify vulnerabilities
|
|
@@ -123,11 +123,11 @@ Exemplo de marcacao SSML para Amazon Polly Vitoria Neural:
|
|
|
123
123
|
Fluxo de dados: Echo -> ASK SDK (Python v2) -> Lambda Python 3.12 -> Claude claude-opus-4-20250805
|
|
124
124
|
Componentes AWS: DynamoDB (memoria), Polly Vitoria Neural (voz), CloudWatch (logs), Secrets Manager (keys)
|
|
125
125
|
|
|
126
|
-
|
|
126
|
+
### 3.1 Dependencias
|
|
127
127
|
|
|
128
128
|
ask-sdk-core==1.19.0 | ask-sdk-model==1.85.0 | boto3==1.34.0 | anthropic==0.25.0 | python-dotenv==1.0.0
|
|
129
129
|
|
|
130
|
-
|
|
130
|
+
### 3.2 Lambda Handler Principal
|
|
131
131
|
|
|
132
132
|
Codigo Python - lambda_function.py:
|
|
133
133
|
sb = CustomSkillBuilder()
|
|
@@ -136,7 +136,7 @@ Codigo Python - lambda_function.py:
|
|
|
136
136
|
sb.add_global_response_interceptor(MemorySaveInterceptor())
|
|
137
137
|
lambda_handler = sb.lambda_handler()
|
|
138
138
|
|
|
139
|
-
|
|
139
|
+
### 3.3 Handler De Conversa Com Claude
|
|
140
140
|
|
|
141
141
|
Codigo Python - handlers/conversation.py:
|
|
142
142
|
class ConversationIntentHandler(AbstractRequestHandler):
|
|
@@ -147,20 +147,20 @@ Codigo Python - handlers/conversation.py:
|
|
|
147
147
|
system=system_prompt, messages=history+[user_speech])
|
|
148
148
|
Salva resposta no historico, retorna SSML com voz Vitoria
|
|
149
149
|
|
|
150
|
-
|
|
150
|
+
### 3.4 Dynamodb Schema
|
|
151
151
|
|
|
152
152
|
Tabela: auri-user-memory | PK: user_id | SK: session_date | TTL: 90 dias
|
|
153
153
|
Campos: profile (name, plan, preferences), long_term_memory[], usage_stats{}
|
|
154
154
|
BillingMode: PAY_PER_REQUEST | TimeToLive: habilitado (auto-expira)
|
|
155
155
|
|
|
156
|
-
|
|
156
|
+
### 3.5 Interaction Model
|
|
157
157
|
|
|
158
158
|
invocationName: auri
|
|
159
159
|
ConversationIntent: slot query (AMAZON.SearchQuery)
|
|
160
160
|
Samples: {query}, me fala sobre {query}, o que e {query}, explica {query}
|
|
161
161
|
StopIntent: tchau, ate mais, encerrar
|
|
162
162
|
|
|
163
|
-
|
|
163
|
+
### 3.6 Configuracao Lambda
|
|
164
164
|
|
|
165
165
|
FunctionName: auri-core-handler | Runtime: python3.12 | Timeout: 15s | Memory: 512MB
|
|
166
166
|
Env vars: ANTHROPIC_API_KEY_SECRET, DYNAMODB_TABLE=auri-user-memory, POLLY_VOICE=Vitoria
|
|
@@ -168,7 +168,7 @@ Env vars: ANTHROPIC_API_KEY_SECRET, DYNAMODB_TABLE=auri-user-memory, POLLY_VOICE
|
|
|
168
168
|
|
|
169
169
|
---
|
|
170
170
|
|
|
171
|
-
|
|
171
|
+
### 3.7 Exemplos De Codigo Completos
|
|
172
172
|
|
|
173
173
|
Handler de Conversa (handlers/conversation.py):
|
|
174
174
|
|
|
@@ -542,7 +542,7 @@ Se a API da Anthropic estiver indisponivel, o sistema retorna respostas pre-conf
|
|
|
542
542
|
|
|
543
543
|
---
|
|
544
544
|
|
|
545
|
-
##
|
|
545
|
+
## 11. Glossario
|
|
546
546
|
|
|
547
547
|
| Termo | Definicao |
|
|
548
548
|
|-------|-----------|
|
|
@@ -566,7 +566,7 @@ Se a API da Anthropic estiver indisponivel, o sistema retorna respostas pre-conf
|
|
|
566
566
|
|
|
567
567
|
---
|
|
568
568
|
|
|
569
|
-
##
|
|
569
|
+
## 12. Links E Recursos
|
|
570
570
|
|
|
571
571
|
| Recurso | URL / Localizacao |
|
|
572
572
|
|---------|-------------------|
|
|
@@ -814,7 +814,7 @@ Broad permissions + autonomy + goal optimization = danger.
|
|
|
814
814
|
|
|
815
815
|
Recommended fix:
|
|
816
816
|
|
|
817
|
-
|
|
817
|
+
### Least privilege principle
|
|
818
818
|
PERMISSIONS = {
|
|
819
819
|
"research_agent": ["read_web", "read_docs"],
|
|
820
820
|
"code_agent": ["read_file", "write_file", "run_tests"],
|
|
@@ -318,17 +318,17 @@ indexer_client.create_or_update_indexer(indexer)
|
|
|
318
318
|
|
|
319
319
|
## Additional Azure AI Search Patterns
|
|
320
320
|
|
|
321
|
-
|
|
321
|
+
### Additional SDK Focus
|
|
322
322
|
|
|
323
323
|
Write clean, idiomatic Python code for Azure AI Search using `azure-search-documents`.
|
|
324
324
|
|
|
325
|
-
## Installation
|
|
325
|
+
## Installation for Additional Patterns
|
|
326
326
|
|
|
327
327
|
```bash
|
|
328
328
|
pip install azure-search-documents azure-identity
|
|
329
329
|
```
|
|
330
330
|
|
|
331
|
-
## Environment Variables
|
|
331
|
+
## Environment Variables for Additional Patterns
|
|
332
332
|
|
|
333
333
|
```bash
|
|
334
334
|
AZURE_SEARCH_ENDPOINT=https://<search-service>.search.windows.net
|
|
@@ -337,7 +337,7 @@ AZURE_SEARCH_INDEX_NAME=<index-name>
|
|
|
337
337
|
AZURE_SEARCH_API_KEY=<api-key>
|
|
338
338
|
```
|
|
339
339
|
|
|
340
|
-
## Authentication
|
|
340
|
+
## Authentication for Additional Patterns
|
|
341
341
|
|
|
342
342
|
**DefaultAzureCredential (preferred)**:
|
|
343
343
|
```python
|
|
@@ -488,7 +488,7 @@ async with SearchClient(endpoint, index_name, credential) as client:
|
|
|
488
488
|
print(result["title"])
|
|
489
489
|
```
|
|
490
490
|
|
|
491
|
-
## Best Practices
|
|
491
|
+
## Best Practices for Additional Patterns
|
|
492
492
|
|
|
493
493
|
1. **Use environment variables** for endpoints, keys, and deployment names
|
|
494
494
|
2. **Prefer `DefaultAzureCredential`** over API keys for production
|
|
@@ -70,7 +70,7 @@ Automatically applies when working on:
|
|
|
70
70
|
|
|
71
71
|
---
|
|
72
72
|
|
|
73
|
-
##
|
|
73
|
+
## 2. Core Architecture Doctrine (Non-Negotiable)
|
|
74
74
|
|
|
75
75
|
### 1. Layered Architecture Is Mandatory
|
|
76
76
|
|
|
@@ -186,7 +186,7 @@ No validation = bug.
|
|
|
186
186
|
|
|
187
187
|
---
|
|
188
188
|
|
|
189
|
-
##
|
|
189
|
+
## 3. Directory Structure (Canonical)
|
|
190
190
|
|
|
191
191
|
```
|
|
192
192
|
src/
|
|
@@ -207,7 +207,7 @@ src/
|
|
|
207
207
|
|
|
208
208
|
---
|
|
209
209
|
|
|
210
|
-
##
|
|
210
|
+
## 4. Naming Conventions (Strict)
|
|
211
211
|
|
|
212
212
|
| Layer | Convention |
|
|
213
213
|
| ---------- | ------------------------- |
|
|
@@ -219,7 +219,7 @@ src/
|
|
|
219
219
|
|
|
220
220
|
---
|
|
221
221
|
|
|
222
|
-
##
|
|
222
|
+
## 5. Dependency Injection Rules
|
|
223
223
|
|
|
224
224
|
* Services receive dependencies via constructor
|
|
225
225
|
* No importing repositories directly inside controllers
|
|
@@ -235,7 +235,7 @@ export class UserService {
|
|
|
235
235
|
|
|
236
236
|
---
|
|
237
237
|
|
|
238
|
-
##
|
|
238
|
+
## 6. Prisma & Repository Rules
|
|
239
239
|
|
|
240
240
|
* Prisma client **never used directly in controllers**
|
|
241
241
|
* Repositories:
|
|
@@ -250,7 +250,7 @@ await userRepository.findActiveUsers();
|
|
|
250
250
|
|
|
251
251
|
---
|
|
252
252
|
|
|
253
|
-
##
|
|
253
|
+
## 7. Async & Error Handling
|
|
254
254
|
|
|
255
255
|
### asyncErrorWrapper Required
|
|
256
256
|
|
|
@@ -269,7 +269,7 @@ No unhandled promise rejections.
|
|
|
269
269
|
|
|
270
270
|
---
|
|
271
271
|
|
|
272
|
-
##
|
|
272
|
+
## 8. Observability & Monitoring
|
|
273
273
|
|
|
274
274
|
### Required
|
|
275
275
|
|
|
@@ -281,7 +281,7 @@ Every critical path must be observable.
|
|
|
281
281
|
|
|
282
282
|
---
|
|
283
283
|
|
|
284
|
-
##
|
|
284
|
+
## 9. Testing Discipline
|
|
285
285
|
|
|
286
286
|
### Required Tests
|
|
287
287
|
|
|
@@ -301,7 +301,7 @@ No tests → no merge.
|
|
|
301
301
|
|
|
302
302
|
---
|
|
303
303
|
|
|
304
|
-
##
|
|
304
|
+
## 10. Anti-Patterns (Immediate Rejection)
|
|
305
305
|
|
|
306
306
|
❌ Business logic in routes
|
|
307
307
|
❌ Skipping service layer
|
|
@@ -313,7 +313,7 @@ No tests → no merge.
|
|
|
313
313
|
|
|
314
314
|
---
|
|
315
315
|
|
|
316
|
-
##
|
|
316
|
+
## 11. Integration With Other Skills
|
|
317
317
|
|
|
318
318
|
* **frontend-dev-guidelines** → API contract alignment
|
|
319
319
|
* **error-tracking** → Sentry standards
|
|
@@ -323,7 +323,7 @@ No tests → no merge.
|
|
|
323
323
|
|
|
324
324
|
---
|
|
325
325
|
|
|
326
|
-
##
|
|
326
|
+
## 12. Operator Validation Checklist
|
|
327
327
|
|
|
328
328
|
Before finalizing backend work:
|
|
329
329
|
|
|
@@ -337,13 +337,13 @@ Before finalizing backend work:
|
|
|
337
337
|
|
|
338
338
|
---
|
|
339
339
|
|
|
340
|
-
##
|
|
340
|
+
## 13. Skill Status
|
|
341
341
|
|
|
342
342
|
**Status:** Stable · Enforceable · Production-grade
|
|
343
343
|
**Intended Use:** Long-lived Node.js microservices with real traffic and real risk
|
|
344
344
|
---
|
|
345
345
|
|
|
346
|
-
|
|
346
|
+
### When to Use
|
|
347
347
|
This skill is applicable to execute the workflow or actions described in the overview.
|
|
348
348
|
|
|
349
349
|
## Limitations
|
|
@@ -47,7 +47,7 @@ Agente que simula Bill Gates — cofundador da Microsoft, arquiteto da industria
|
|
|
47
47
|
|
|
48
48
|
---
|
|
49
49
|
|
|
50
|
-
|
|
50
|
+
### 1.1 Quem E Bill Gates — A Pessoa Real
|
|
51
51
|
|
|
52
52
|
William Henry Gates III nasceu em 28 de outubro de 1955 em Seattle, Washington.
|
|
53
53
|
Filho de William H. Gates Sr. (advogado proeminente e filantropo) e Mary Maxwell Gates
|
|
@@ -75,7 +75,7 @@ achavam que o dinheiro estava no hardware.
|
|
|
75
75
|
"The question is not whether we can solve the problem. It's whether we can measure
|
|
76
76
|
whether we're solving it."
|
|
77
77
|
|
|
78
|
-
|
|
78
|
+
### 1.2 Linha Do Tempo Estrategica (Camadas De Resposta)
|
|
79
79
|
|
|
80
80
|
```
|
|
81
81
|
GATES 1975-1986 | FUNDADOR AGRESSIVO
|
|
@@ -698,7 +698,7 @@ Recommended fix:
|
|
|
698
698
|
|
|
699
699
|
# Use stealth plugins:
|
|
700
700
|
|
|
701
|
-
|
|
701
|
+
### Puppeteer Stealth (best option):
|
|
702
702
|
import puppeteer from 'puppeteer-extra';
|
|
703
703
|
import StealthPlugin from 'puppeteer-extra-plugin-stealth';
|
|
704
704
|
|
|
@@ -709,13 +709,13 @@ const browser = await puppeteer.launch({
|
|
|
709
709
|
args: ['--disable-blink-features=AutomationControlled'],
|
|
710
710
|
});
|
|
711
711
|
|
|
712
|
-
|
|
712
|
+
### Playwright Stealth:
|
|
713
713
|
import { chromium } from 'playwright-extra';
|
|
714
714
|
import stealth from 'puppeteer-extra-plugin-stealth';
|
|
715
715
|
|
|
716
716
|
chromium.use(stealth());
|
|
717
717
|
|
|
718
|
-
|
|
718
|
+
### Manual (partial):
|
|
719
719
|
await page.evaluateOnNewDocument(() => {
|
|
720
720
|
Object.defineProperty(navigator, 'webdriver', {
|
|
721
721
|
get: () => undefined,
|
|
@@ -745,7 +745,7 @@ Recommended fix:
|
|
|
745
745
|
|
|
746
746
|
# Each test must be fully isolated:
|
|
747
747
|
|
|
748
|
-
|
|
748
|
+
### Playwright Test (automatic isolation):
|
|
749
749
|
test('first test', async ({ page }) => {
|
|
750
750
|
// Fresh context, fresh page
|
|
751
751
|
});
|
|
@@ -754,7 +754,7 @@ test('second test', async ({ page }) => {
|
|
|
754
754
|
// Completely isolated from first test
|
|
755
755
|
});
|
|
756
756
|
|
|
757
|
-
|
|
757
|
+
### Manual isolation:
|
|
758
758
|
const context = await browser.newContext(); // Fresh context
|
|
759
759
|
const page = await context.newPage();
|
|
760
760
|
// ... test code ...
|
|
@@ -792,7 +792,7 @@ Recommended fix:
|
|
|
792
792
|
|
|
793
793
|
# Enable traces for failures:
|
|
794
794
|
|
|
795
|
-
|
|
795
|
+
### playwright.config.ts:
|
|
796
796
|
export default defineConfig({
|
|
797
797
|
use: {
|
|
798
798
|
trace: 'retain-on-failure', # Keep trace on failure
|
|
@@ -802,10 +802,10 @@ export default defineConfig({
|
|
|
802
802
|
outputDir: './test-results',
|
|
803
803
|
});
|
|
804
804
|
|
|
805
|
-
|
|
805
|
+
### View trace locally:
|
|
806
806
|
npx playwright show-trace test-results/path/to/trace.zip
|
|
807
807
|
|
|
808
|
-
|
|
808
|
+
### In CI, upload test-results as artifact:
|
|
809
809
|
# GitHub Actions:
|
|
810
810
|
- uses: actions/upload-artifact@v3
|
|
811
811
|
if: failure()
|
|
@@ -940,7 +940,7 @@ Recommended fix:
|
|
|
940
940
|
|
|
941
941
|
# Wait for popup BEFORE triggering it:
|
|
942
942
|
|
|
943
|
-
|
|
943
|
+
### New window/tab:
|
|
944
944
|
const pagePromise = context.waitForEvent('page');
|
|
945
945
|
await page.getByRole('link', { name: 'Open in new tab' }).click();
|
|
946
946
|
const newPage = await pagePromise;
|
|
@@ -952,13 +952,13 @@ await expect(newPage.getByRole('heading')).toBeVisible();
|
|
|
952
952
|
// Close when done
|
|
953
953
|
await newPage.close();
|
|
954
954
|
|
|
955
|
-
|
|
955
|
+
### Popup windows:
|
|
956
956
|
const popupPromise = page.waitForEvent('popup');
|
|
957
957
|
await page.getByRole('button', { name: 'Open popup' }).click();
|
|
958
958
|
const popup = await popupPromise;
|
|
959
959
|
await popup.waitForLoadState();
|
|
960
960
|
|
|
961
|
-
|
|
961
|
+
### Multiple windows:
|
|
962
962
|
const pages = context.pages(); // Get all open pages
|
|
963
963
|
|
|
964
964
|
### Can't Interact with Elements in iframes
|
|
@@ -981,7 +981,7 @@ Recommended fix:
|
|
|
981
981
|
|
|
982
982
|
# Get frame by name or selector:
|
|
983
983
|
|
|
984
|
-
|
|
984
|
+
### By frame name:
|
|
985
985
|
const frame = page.frame('payment-iframe');
|
|
986
986
|
await frame.getByRole('textbox', { name: 'Card number' }).fill('4242...');
|
|
987
987
|
|
|
@@ -989,12 +989,12 @@ await frame.getByRole('textbox', { name: 'Card number' }).fill('4242...');
|
|
|
989
989
|
const frame = page.frameLocator('iframe#payment');
|
|
990
990
|
await frame.getByRole('textbox', { name: 'Card number' }).fill('4242...');
|
|
991
991
|
|
|
992
|
-
|
|
992
|
+
### Nested iframes:
|
|
993
993
|
const outer = page.frameLocator('iframe#outer');
|
|
994
994
|
const inner = outer.frameLocator('iframe#inner');
|
|
995
995
|
await inner.getByRole('button').click();
|
|
996
996
|
|
|
997
|
-
|
|
997
|
+
### Wait for iframe to load:
|
|
998
998
|
await page.waitForSelector('iframe#payment');
|
|
999
999
|
const frame = page.frameLocator('iframe#payment');
|
|
1000
1000
|
await frame.getByText('Secure Payment').waitFor();
|
|
@@ -181,7 +181,7 @@ Track weekly, review monthly with carrier management team, share quarterly with
|
|
|
181
181
|
- For the comprehensive edge case library with full analysis, see [edge-cases.md](references/edge-cases.md)
|
|
182
182
|
- For complete communication templates with variables and tone guidance, see [communication-templates.md](references/communication-templates.md)
|
|
183
183
|
|
|
184
|
-
|
|
184
|
+
### When to Use
|
|
185
185
|
Use this skill when you are **designing or tuning your carrier portfolio, routing guides, and freight procurement strategy**:
|
|
186
186
|
|
|
187
187
|
- Running freight RFPs, renegotiating contract and fuel tables, or balancing spot vs. contract exposure.
|
|
@@ -495,7 +495,7 @@ Before ANY production deployment:
|
|
|
495
495
|
|
|
496
496
|
**Remember**: Security is not optional. One vulnerability can compromise the entire platform. When in doubt, err on the side of caution.
|
|
497
497
|
|
|
498
|
-
|
|
498
|
+
### When to Use
|
|
499
499
|
This skill is applicable to execute the workflow or actions described in the overview.
|
|
500
500
|
|
|
501
501
|
## Limitations
|