[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6C0WC6Y81XRVBJQSTKA96XQ":3,"skill-same:01M6C0WC6Y81XRVBJQSTKA96XQ":53},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":27,"linkOnly":28,"markdownContent":29,"markdownBody":30,"frontMatter":31,"refName":32,"commitSha":33,"skillDirectory":34,"forksCount":14,"repositoryHtmlUrl":35,"repositoryHomepageUrl":6,"ownerHtmlUrl":36,"ownerBlogUrl":6,"ownerDescription":37,"updatedAt":38,"install":39,"resources":52},"01M6C0WC6Y81XRVBJQSTKA96XQ","subagent-development",null,"Orquestra subagents no AS v2 — decompõe a tarefa em domínios independentes, paraleliza e revisa em 2 estágios. Use ao delegar exploração, implementação ou validação cross-arquivo para acelerar o trabalho e poupar o contexto principal.","matheusnorjosa\u002Faprender_sistema","matheusnorjosa","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F117673804?v=4","01M6C0S19FG12BDFBTRWY9TTEQ","Matheus Norjosa","01M6C0S1DF0YB17TKGEYC70GSP",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fmatheusnorjosa\u002Faprender_sistema\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fsubagent-development\u002FSKILL.md",[],[19,20,21,22,23,24,25,26],"development","subagent","subagent development","para","subagents","use","ao","as","2026-11-10 10:12:30",false,"---\nname: subagent-development\ndescription: Orquestra subagents no AS v2 — decompõe a tarefa em domínios independentes, paraleliza e revisa em 2 estágios. Use ao delegar exploração, implementação ou validação cross-arquivo para acelerar o trabalho e poupar o contexto principal.\n---\n\n# Subagent Development\n\nOrquestrar subagents especializados (delegar, paralelizar, revisar) para acelerar\ntrabalho cross-arquivo e poupar o contexto principal.\n\n> **SSOT**: a política de delegação do projeto vive na seção **\"Delegação a subagents\"**\n> do `.claude\u002FCLAUDE.md`. Esta skill é o *como operacional*; não duplique a política — linke.\n\n## Agent types disponíveis\n\nUse exatamente estes `subagent_type` (não invente outros):\n\n- **Explore** — busca\u002Fvarredura\u002Finvestigação cross-arquivo (read-only).\n- **Plan** — arquitetar antes de implementar.\n- **general-purpose** — multi-step (implementar, rodar testes, validar).\n- **Workflow** — fan-out por cluster\u002Ffinding em auditorias, migrações e revisões grandes.\n\n## When to Use\n\n- Feature complexa com múltiplos workstreams independentes.\n- Tarefa que se beneficia de foco especializado.\n- Trabalho que envolve **ler muitos arquivos** → delegue e fique só com a conclusão.\n\n### NÃO paralelize quando\n\n- Falhas estão relacionadas (mesma root cause).\n- Requer entendimento do sistema completo \u002F estado compartilhado.\n- Mudanças podem conflitar entre si.\n\n## Process\n\n### 1. Decompor por domínio independente\n\nQuebre a feature em unidades que **não compartilham contexto**:\n\n- **Exploração** — análise de codebase, descoberta de padrões.\n- **Implementação** — escrever código, testes.\n- **Validação** — type check, lint, rodar testes.\n\nAgrupe pelo que está quebrado\u002Fisolado:\n\n```\nExemplo: 6 testes falhando\n├── test_availability.py (3 falhas) → Domínio: Disponibilidade (RD-01~08)\n├── test_approval.py    (2 falhas) → Domínio: Aprovação (PA-01~07)\n└── test_gcal.py        (1 falha)  → Domínio: Google Calendar\n```\n\n### 2. Spawn subagents\n\nUse a Task tool com o agent type adequado. Lance agents independentes\n**em paralelo** (uma mensagem, vários tool calls):\n\n```\nTask(subagent_type=\"Explore\", prompt=\"Find all places where X pattern is used\")\nTask(subagent_type=\"Plan\", prompt=\"Design the architecture for feature Y\")\nTask(subagent_type=\"general-purpose\", prompt=\"Run the test suite for module Z and report failures\")\n```\n\nCada agent precisa de:\n\n- **Escopo específico** — apenas seu domínio (arquivos nomeados).\n- **Goal claro** — o que significa \"done\".\n- **Constraints** — o que NÃO fazer.\n- **Output esperado** — formato do deliverable.\n\n#### Prompt BOM (paralelizar correção de testes)\n\n```\nFix os testes em test_availability.py.\n\nContexto:\n- 3 testes falhando: test_check_overlap, test_block_total, test_buffer\n- Erro comum: \"AssertionError: timezone mismatch\"\n- Causa provável: datetime.now() vs America\u002FFortaleza\n\nConstraints:\n- NÃO altere código de produção (apps\u002Fcore\u002Fservices\u002F)\n- NÃO altere outros arquivos de teste\n- USE freezegun para fixar tempo\n\nDeliverable:\n- Testes passando (docker exec aprender_dev-web-1 pytest ...)\n```\n\n#### Prompt RUIM\n\n```\nFix all tests.\n```\n\nSem escopo, sem contexto, sem constraints, sem deliverable — o agent adivinha.\n\n### 3. Two-Stage Review\n\n**Stage 1 — Subagent Completion**\nQuando o subagent retorna:\n- Leia o output completo.\n- Verifique que as claims batem com a evidência.\n- Anote gaps ou ressalvas.\n\n**Stage 2 — Integration Review**\nAntes de apresentar ao usuário:\n- Cross-check dos outputs por consistência.\n- Verifique que os fixes paralelos não conflitam.\n- Rode validação de integração (testes todos juntos, type check).\n\n### 4. Synthesize Results\n\nCombine os outputs em uma resposta coerente:\n- Resuma os achados-chave (não despeje o dump do subagent).\n- Apresente plano\u002Fimplementação unificada.\n- Sinalize conflitos não resolvidos.\n\n## Pitfalls Comuns\n\nPrompt fraco (escopo\u002Fcontexto\u002Fconstraints\u002Fdeliverable) → ver checklist em\n[2. Spawn subagents](#2-spawn-subagents). Os demais riscos:\n\n| Pitfall | Solução |\n|---------|---------|\n| Blind trust | Sempre verificar as claims do subagent |\n| Over-spawning | Não criar agent para tarefa trivial |\n| Missing synthesis | Não despejar output bruto no usuário |\n| Sequential quando podia ser parallel | Lançar tasks independentes juntas |\n\n## Example\n\n```\nUser: \"Add authentication to the API\"\n\n1. Spawn em paralelo (uma mensagem):\n   - Explore: \"Find current auth patterns in codebase\"\n   - Explore: \"List all unprotected endpoints\"\n   - Plan: \"Design session-based auth flow\"\n\n2. Stage 1: revisar cada output; Stage 2: sintetizar plano\n\n3. Spawn implementação:\n   - general-purpose: \"Implement auth middleware\"\n   - general-purpose: \"Add auth tests\"\n\n4. Integration review + rodar suite completa\n```\n\n## Integração com Outras Skills\n\n- `verification-gate` antes de declarar sucesso.\n- `debugging-and-error-recovery` se um subagent reporta problema.\n- `test-driven-development` para o ciclo de implementação delegada.\n","# Subagent Development\n\nOrquestrar subagents especializados (delegar, paralelizar, revisar) para acelerar\ntrabalho cross-arquivo e poupar o contexto principal.\n\n> **SSOT**: a política de delegação do projeto vive na seção **\"Delegação a subagents\"**\n> do `.claude\u002FCLAUDE.md`. Esta skill é o *como operacional*; não duplique a política — linke.\n\n## Agent types disponíveis\n\nUse exatamente estes `subagent_type` (não invente outros):\n\n- **Explore** — busca\u002Fvarredura\u002Finvestigação cross-arquivo (read-only).\n- **Plan** — arquitetar antes de implementar.\n- **general-purpose** — multi-step (implementar, rodar testes, validar).\n- **Workflow** — fan-out por cluster\u002Ffinding em auditorias, migrações e revisões grandes.\n\n## When to Use\n\n- Feature complexa com múltiplos workstreams independentes.\n- Tarefa que se beneficia de foco especializado.\n- Trabalho que envolve **ler muitos arquivos** → delegue e fique só com a conclusão.\n\n### NÃO paralelize quando\n\n- Falhas estão relacionadas (mesma root cause).\n- Requer entendimento do sistema completo \u002F estado compartilhado.\n- Mudanças podem conflitar entre si.\n\n## Process\n\n### 1. Decompor por domínio independente\n\nQuebre a feature em unidades que **não compartilham contexto**:\n\n- **Exploração** — análise de codebase, descoberta de padrões.\n- **Implementação** — escrever código, testes.\n- **Validação** — type check, lint, rodar testes.\n\nAgrupe pelo que está quebrado\u002Fisolado:\n\n```\nExemplo: 6 testes falhando\n├── test_availability.py (3 falhas) → Domínio: Disponibilidade (RD-01~08)\n├── test_approval.py    (2 falhas) → Domínio: Aprovação (PA-01~07)\n└── test_gcal.py        (1 falha)  → Domínio: Google Calendar\n```\n\n### 2. Spawn subagents\n\nUse a Task tool com o agent type adequado. Lance agents independentes\n**em paralelo** (uma mensagem, vários tool calls):\n\n```\nTask(subagent_type=\"Explore\", prompt=\"Find all places where X pattern is used\")\nTask(subagent_type=\"Plan\", prompt=\"Design the architecture for feature Y\")\nTask(subagent_type=\"general-purpose\", prompt=\"Run the test suite for module Z and report failures\")\n```\n\nCada agent precisa de:\n\n- **Escopo específico** — apenas seu domínio (arquivos nomeados).\n- **Goal claro** — o que significa \"done\".\n- **Constraints** — o que NÃO fazer.\n- **Output esperado** — formato do deliverable.\n\n#### Prompt BOM (paralelizar correção de testes)\n\n```\nFix os testes em test_availability.py.\n\nContexto:\n- 3 testes falhando: test_check_overlap, test_block_total, test_buffer\n- Erro comum: \"AssertionError: timezone mismatch\"\n- Causa provável: datetime.now() vs America\u002FFortaleza\n\nConstraints:\n- NÃO altere código de produção (apps\u002Fcore\u002Fservices\u002F)\n- NÃO altere outros arquivos de teste\n- USE freezegun para fixar tempo\n\nDeliverable:\n- Testes passando (docker exec aprender_dev-web-1 pytest ...)\n```\n\n#### Prompt RUIM\n\n```\nFix all tests.\n```\n\nSem escopo, sem contexto, sem constraints, sem deliverable — o agent adivinha.\n\n### 3. Two-Stage Review\n\n**Stage 1 — Subagent Completion**\nQuando o subagent retorna:\n- Leia o output completo.\n- Verifique que as claims batem com a evidência.\n- Anote gaps ou ressalvas.\n\n**Stage 2 — Integration Review**\nAntes de apresentar ao usuário:\n- Cross-check dos outputs por consistência.\n- Verifique que os fixes paralelos não conflitam.\n- Rode validação de integração (testes todos juntos, type check).\n\n### 4. Synthesize Results\n\nCombine os outputs em uma resposta coerente:\n- Resuma os achados-chave (não despeje o dump do subagent).\n- Apresente plano\u002Fimplementação unificada.\n- Sinalize conflitos não resolvidos.\n\n## Pitfalls Comuns\n\nPrompt fraco (escopo\u002Fcontexto\u002Fconstraints\u002Fdeliverable) → ver checklist em\n[2. Spawn subagents](#2-spawn-subagents). Os demais riscos:\n\n| Pitfall | Solução |\n|---------|---------|\n| Blind trust | Sempre verificar as claims do subagent |\n| Over-spawning | Não criar agent para tarefa trivial |\n| Missing synthesis | Não despejar output bruto no usuário |\n| Sequential quando podia ser parallel | Lançar tasks independentes juntas |\n\n## Example\n\n```\nUser: \"Add authentication to the API\"\n\n1. Spawn em paralelo (uma mensagem):\n   - Explore: \"Find current auth patterns in codebase\"\n   - Explore: \"List all unprotected endpoints\"\n   - Plan: \"Design session-based auth flow\"\n\n2. Stage 1: revisar cada output; Stage 2: sintetizar plano\n\n3. Spawn implementação:\n   - general-purpose: \"Implement auth middleware\"\n   - general-purpose: \"Add auth tests\"\n\n4. Integration review + rodar suite completa\n```\n\n## Integração com Outras Skills\n\n- `verification-gate` antes de declarar sucesso.\n- `debugging-and-error-recovery` se um subagent reporta problema.\n- `test-driven-development` para o ciclo de implementação delegada.\n",{"name":5,"description":7},"main","9e3a882d83e0853bdc570ae9d89c02d2a53bed82",".claude\u002Fskills\u002Fsubagent-development","https:\u002F\u002Fgithub.com\u002Fmatheusnorjosa\u002Faprender_sistema","https:\u002F\u002Fgithub.com\u002Fmatheusnorjosa","Dev Python | IA | Automation | HTML | CSS | Data | Process | Projects","2026-11-11 08:34:26",{"source":8,"skillName":5,"commands":40,"prompt":50,"zipAvailable":51},[41,44,47],{"tool":42,"command":43},"npx","npx skills add matheusnorjosa\u002Faprender_sistema --skill subagent-development",{"tool":45,"command":46},"bunx","bunx skills add matheusnorjosa\u002Faprender_sistema --skill subagent-development",{"tool":48,"command":49},"pnpm","pnpm dlx skills add matheusnorjosa\u002Faprender_sistema --skill subagent-development","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmatheusnorjosa\u002Faprender_sistema\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fsubagent-development\u002FSKILL.md",true,[],[54,92,115,136,168,196],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":70,"publishedAt":27},"01M6C0WHSP7S2QMJGGMQRXJ6PD","writing-standards","Apply AS v2 technical-writing standards (clarity, brevity, active voice, Python\u002FDjango conventions). Use when writing a README, a docstring (PEP 257), a commit message, a PR description, an error message, or any technical doc.","https:\u002F\u002Fgithub.com\u002Fmatheusnorjosa\u002Faprender_sistema\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fwriting-standards\u002FSKILL.md",[60,65],{"categoryNo":61,"categoryName":62,"taxonomyType":63,"taxonomyTypeDesc":64},"01JBSEEDCAT000000000000018","写作与文案","SCENARIO","使用场景",{"categoryNo":66,"categoryName":67,"taxonomyType":68,"taxonomyTypeDesc":69},"01JBSEEDCAT000000000000036","内容创作者","PROFESSION","适用职业",[71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,26,87,88,89,90,91],"writing","writing standards","standards","python","commit","pr","pr description","commit message","doc","voice","clarity","django","technical","README","message","active","error","technical-writing","brevity","docstring","when",{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":27},"01M6C0WG2SBP9PJG1YQFGGVJAR","verification-gate","Verify before claiming success. Use when about to say something works\u002Fis done, after implementing a feature, after a bugfix, or before pushing — run the proof command and confirm output first.","https:\u002F\u002Fgithub.com\u002Fmatheusnorjosa\u002Faprender_sistema\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fverification-gate\u002FSKILL.md",[],[99,100,101,102,103,104,105,24,106,107,108,109,110,111,112,113,114,91],"verification","verification gate","gate","run","first","verify","command","verify before claiming","say","done","feature","proof","bugfix","output","about","implementing",{"skillNo":116,"name":117,"nameZh":6,"description":118,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":119,"categories":120,"keywords":124,"publishedAt":27},"01M6C0WE010G12KH45YZW6M7K5","test-driven-development","Write the failing test before the implementation in AS v2 (pytest + Django\u002FDRF). Use when implementing a feature or fixing a bug, before any production code is written.","https:\u002F\u002Fgithub.com\u002Fmatheusnorjosa\u002Faprender_sistema\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Ftest-driven-development\u002FSKILL.md",[121],{"categoryNo":122,"categoryName":123,"taxonomyType":63,"taxonomyTypeDesc":64},"01JBSEEDCAT000000000000008","测试与质量",[125,126,19,127,128,129,82,130,24,131,132,133,109,26,134,114,91,135],"test","test driven development","driven","code","Production","write","bug","implementation","pytest","drf","failing",{"skillNo":137,"name":138,"nameZh":6,"description":139,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":140,"categories":141,"keywords":142,"publishedAt":27},"01M6C0W9W8D6JJWXW28Q7ZHAC9","security-scan","Automated security scanning for AS v2. Use before commits or when reviewing changes for vulnerabilities. Runs dependency audit (pip-audit, npm audit), secret detection (grep patterns), and code pattern scanning (SQL injection, XSS, eval, pickle, hardcoded secrets). Integrates with project hooks system.","https:\u002F\u002Fgithub.com\u002Fmatheusnorjosa\u002Faprender_sistema\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fsecurity-scan\u002FSKILL.md",[],[143,144,145,146,147,128,148,149,150,151,152,153,154,155,156,157,158,159,24,160,161,162,26,163,164,165,166,167,91],"security","security scan","scan","vulnerabilities","sql","npm","audit","dependency audit","detection","injection","xss","secrets","pip-audit","commits","system","grep","eval","hooks","security scanning","project","with","true","pip","for","changes",{"skillNo":169,"name":170,"nameZh":6,"description":171,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":172,"categories":173,"keywords":177,"publishedAt":27},"01M6C0W7RE3G3C2852YXQKR5J9","resume-handoff","Resume work from a saved handoff document, validating its state against the current codebase before continuing. Use when resuming work from a saved handoff after a context clear or in a new session (path, session name, or GitHub issue).","https:\u002F\u002Fgithub.com\u002Fmatheusnorjosa\u002Faprender_sistema\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fresume-handoff\u002FSKILL.md",[174],{"categoryNo":175,"categoryName":176,"taxonomyType":68,"taxonomyTypeDesc":69},"01JBSEEDCAT000000000000038","人力资源",[178,179,180,181,182,183,184,185,186,24,187,188,189,190,191,192,193,194,91,195],"handoff","resume handoff","resume","github","state","new session","work","context","session","github issue","issue","document","clear","name","saved","codebase","resuming","new",{"skillNo":197,"name":198,"nameZh":6,"description":199,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":200,"categories":201,"keywords":208,"publishedAt":27},"01M6C0W5E0DSP680Z75AAKSKEQ","receiving-code-review","Triage and respond to code review feedback for AS v2. Use when a PR has review comments, the user shares feedback, CI\u002Flinting flags issues, or after \u002Freview-staged or \u002Freview-enhanced runs.","https:\u002F\u002Fgithub.com\u002Fmatheusnorjosa\u002Faprender_sistema\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Freceiving-code-review\u002FSKILL.md",[202,205],{"categoryNo":203,"categoryName":204,"taxonomyType":63,"taxonomyTypeDesc":64},"01JBSEEDCAT000000000000007","代码审查",{"categoryNo":206,"categoryName":207,"taxonomyType":68,"taxonomyTypeDesc":69},"01JBSEEDCAT000000000000030","开发工程师",[209,210,211,128,212,76,213,214,215,216,217,24,218,26,219,220,221,166,222,223,91],"code review","review","receiving code review","triage","issues","ci","feedback","code review feedback","user","flags","linting","respond","comments","staged","review feedback"]