Communitygithub.com

Análise de Tarefas de Especialista e Design de Capacidades

Aplique análise cognitiva de tarefas ao trabalho de especialistas que depende de pistas perceptuais, julgamento de ramificação e loops de monitoramento recorrentes. Use ao decompor a capacidade de um especialista em estrutura de agente, design de simulação ou entrevistas de validação. NÃO para captura comum de SOP passo a passo ou pipelines simples sem camada tácita de pistas.

O que é Análise de Tarefas de Especialista e Design de Capacidades?

Esta skill capacita agentes de IA e engenheiros de software a projetar arquiteturas de agentes, simuladores ou ambientes de treinamento que capturem a verdadeira essência do desempenho de especialistas humanos — especialmente as pistas perceptuais, loops de monitoramento e heurísticas de julgamento que vão além de procedimentos explícitos. Ela se baseia em modelos mentais como a separação entre camada científica (declarativa) e camada artística (perceptual), a importância de pistas críticas como entradas reais para decisões, hierarquias de metas com regras de seleção e loops de monitoramento recorrentes. A skill fornece um fluxo de decisão (incluindo um diagrama Mermaid) para orientar a decomposição, métodos de elicitação de conhecimento (como Critical Decision Method) e decisões de simulação. Ela também identifica modos de falha comuns, como captura de lista de verificação plana, simulação sem pistas, fragilidade de canal único, ponto cego de um especialista e arquitetura sequencial apenas. Inclui exemplos práticos, portões de qualidade e arquivos de referência detalhados, sendo ideal para plataformas como Claude Code, Cursor, Codex ou qualquer ambiente de desenvolvimento de agentes onde a modelagem de tarefas de especialista seja necessária.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/curiositech/windags-skills/tree/HEAD/skills/a-task-analysis-of-pier-side-ship-handli

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Análise de Tarefas de Especialista e Design de Capacidades faz?

Use esta skill quando um modelo de tarefa parecer proceduralmente completo, mas ainda perder os gatilhos perceptuais, loops de monitoramento e hábitos de uso de ferramentas que separam o desempenho de um especialista de uma lista de verificação.

Quando Usar

  • Você precisa transformar o desempenho de um especialista em uma arquitetura de agente, simulador ou ambiente de treinamento.
  • Um SOP escrito explica os passos, mas não como os especialistas sabem qual ramo seguir.
  • O sistema funciona em casos normais e falha em casos extremos que dependem de julgamento situacional.
  • Você está entrevistando especialistas no assunto e precisa de um método para extrair conhecimento tácito, em vez de apenas procedimento narrado.
  • Um DAG ou árvore de orquestração precisa de loops de monitoramento recorrentes em vez de apenas nós sequenciais únicos.

NÃO para Limites

Esta skill não é a ferramenta primária correta para:

  • Fluxos de trabalho simples e determinísticos onde procedimentos explícitos já capturam toda a tarefa.
  • Automação de baixo risco que não depende de reconhecimento de padrões perceptuais.
  • Exercícios de documentação posteriores que não precisam de validação contra o desempenho real do especialista.
  • Simulações onde o realismo visual é mais importante que a fidelidade das pistas para a tomada de decisão.

Modelos Mentais Centrais

Camada Científica vs. Camada Artística

O desempenho do especialista tem uma camada declarativa que os especialistas geralmente conseguem explicar e uma camada perceptual que muitas vezes aparece apenas quando são pressionados sobre pontos de ramificação. GOMS captura a primeira. Inventários de Pistas Críticas e entrevistas do Método de Decisão Crítica são como você recupera a segunda.

Pistas São Estruturais

Padrões de esteira, tensão de linha, uma mudança de som ou uma relação posicional sutil não são detalhes decorativos. Eles são as entradas reais para a escolha do especialista. Se o sistema não consegue ver as pistas, ele não pode reproduzir a função de decisão do especialista.

Hierarquia com Regras de Seleção

O trabalho do especialista é uma hierarquia de metas aninhadas com condições de ramificação locais, não uma lista plana de passos. A estrutura importante não é apenas o que é feito, mas quais condições selecionam o método A em vez do método B.

Loops de Monitoramento Recorrentes

Muitas tarefas de especialistas dependem de metas de avaliação contínuas que ocorrem paralelamente à ação sequencial. Um fluxo de trabalho que modela apenas nós únicos perde a antecipação e transforma a expertise em reação.

Lacuna de Validação

Modelos de tarefa de um único especialista são previsivelmente incompletos porque ferramentas rotineiras e comportamentos de configuração desaparecem da consciência. A validação não é um polimento opcional; é como a estrutura de tarefa ausente se torna visível.

Pontos de Decisão

Veja o fluxo de modelagem em diagrams/01_flowchart_decision-points.md.

flowchart TD
  A[Precisa de modelo de capacidade de especialista] --> B[Decompor metas e métodos]
  B --> C{Ponto de ramificação explicado proceduralmente?}
  C -->|Sim| D[Registrar regra de seleção explícita]
  C -->|Não| E[Sondar por pistas perceptuais]
  D --> F{Monitoramento recorrente necessário?}
  E --> F
  F -->|Sim| G[Modelar loop de monitoramento e sensoriamento redundante]
  F -->|Não| H[Manter submeta sequencial]
  G --> I[Validar com mais especialistas ou rastros]
  H --> I

1. Decida o Grão Correto de Decomposição

  • Pare no nível onde uma escolha de método significativa aparece pela primeira vez.
  • Se uma condição de ramificação ainda estiver oculta, decomponha mais profundamente e investigue a pista que seleciona a ramificação.
  • Se não houver mais pontos de ramificação, você está documentando execução em vez de arquitetura de tarefa.

2. Decida Qual Método de Elicitação de Conhecimento Usar

  • Use decomposição estruturada para procedimentos explícitos e sequenciamento de ferramentas.
  • Use sondas do Método de Decisão Crítica quando o especialista disser "eu simplesmente sei" ou "depende".
  • Use validação com múltiplos especialistas sempre que o primeiro modelo parecer estranhamente limpo ou sem ferramentas.

3. Decida o que Simular

  • Simule pistas que realmente acionam decisões de ramificação.
  • Adicione sensoriamento redundante onde os especialistas dependem de mais de um canal.
  • Omita detalhes cosméticos que não alteram o reconhecimento de pistas ou a qualidade da escolha.

Modos de Falha

1. Captura de Lista de Verificação Plana

Sintomas: o modelo de tarefa flui suavemente, mas falha assim que o ambiente se desvia. Regra de detecção: condições de ramificação estão ausentes ou ocultas dentro de prosa em vez de regras de seleção explícitas. Recuperação: converta a lista de verificação em uma hierarquia de metas com pontos de ramificação vinculados a pistas.

2. Simulação Sem Pistas

Sintomas: trainees ou agentes têm sucesso no simulador, mas falham na implantação. Regra de detecção: a simulação reproduz procedimentos, mas não os sinais que os especialistas usam para escolher entre eles. Recuperação: construa um Inventário de Pistas Críticas e redesenhe o ambiente em torno da fidelidade das pistas.

3. Fragilidade de Canal Único

Sintomas: uma entrada ruidosa ou ausente colapsa todo o processo de decisão. Regra de detecção: um julgamento crítico depende de exatamente uma fonte. Recuperação: adicione canais redundantes e comportamento explícito de verificação cruzada.

4. Ponto Cego de Um Especialista

Sintomas: ferramentas essenciais ou ações de configuração de contexto nunca aparecem no primeiro modelo. Regra de detecção: especialistas de validação mencionam imediatamente equipamentos, rotinas ou comportamento de monitoramento omitidos. Recuperação: trate a discordância como evidência de estrutura ausente, não como ruído.

5. Arquitetura Apenas Sequencial

Sintomas: o sistema pode reagir a eventos, mas não pode sustentar uma avaliação contínua. Regra de detecção: todos os nós são tarefas únicas e nenhum representa metas de monitoramento recorrentes. Recuperação: adicione loops de monitoramento explícitos com comportamento de prever-observar-comparar-ajustar.

Exemplos Trabalhados

Exemplo 1: Transformando Julgamento de Especialista em uma Árvore de Agente

Um especialista em domínio de navegação fornece uma narrativa processual para atracação. O primeiro rascunho se decompõe limpidamente em passos, mas ainda falha quando corrente, disponibilidade de rebocadores e comportamento de linha mudam juntos. A skill adiciona regras de seleção nos pontos de ramificação relevantes, registra o inventário de pistas que impulsiona essas escolhas e introduz loops de monitoramento recorrentes em vez de apenas nós sequenciais.

Exemplo 2: Triagem de Fidelidade de Simulação

Um simulador de treinamento renderiza água, embarcações e geometria de píer lindamente, mas os trainees ainda ultrapassam o ponto de parada. A CTA revela que os especialistas dependem de movimento relativo contra referências fixas da costa e pistas de tensão de linha que o simulador nunca enfatiza. A skill direciona o esforço de design para essas pistas em vez de mais polimento visual.

Portões de Qualidade

  • O modelo de tarefa distingue procedimento explícito do conhecimento de pistas perceptuais.
  • Os pontos de ramificação incluem as pistas ou condições que selecionam cada método.
  • As metas de monitoramento recorrentes são modeladas separadamente das metas sequenciais únicas.
  • Decisões críticas têm canais de informação redundantes onde os especialistas confiam neles.
  • Pelo menos uma passagem de validação desafia o modelo com especialistas ou rastros adicionais.

Arquivos de Referência

ArquivoCarregar quando
references/goms-task-decomposition-for-agent-systems.mdConstruir uma hierarquia de metas ou decidir a profundidade de decomposição
references/critical-cue-inventories-for-agent-perception.mdRecuperar gatilhos perceptuais em pontos de decisão
references/knowledge-elicitation-methodology-for-agent-capability-building.mdExecutar entrevistas de CTA ou Método de Decisão Crítica
references/validation-gap-what-experts-dont-know-they-know.mdTestar a resistência de um modelo de tarefa de primeiro rascunho
references/redundant-sensing-in-multi-channel-environments.mdProjetar percepção robusta multicanal
references/the-art-science-gap-transfer-to-simulation.mdDecidir qual detalhe de simulação afeta materialmente a transferência de habilidade
references/situation-awareness-and-the-conning-officers-mental-model.mdModelar loops de monitoramento e detecção de divergência

Anti-Padrões

  • Tratar "conhecimento tácito" como um rótulo que encerra a investigação em vez de um sinal para sondar mais profundamente.
  • Capturar apenas procedimentos e chamar o resultado de modelo de especialista.
  • Projetar simulações para estética de realismo em vez de fidelidade de pistas.
  • Assumir completude de um único especialista em um domínio onde a automaticidade oculta a estrutura mais importante.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

curiositech/windags-skills

Expert in 2000s-era music visualization (Milkdrop, AVS, Geiss) and modern WebGL implementations. Specializes in Butterchurn integration, Web Audio API AnalyserNode FFT data, GLSL shaders for audio-reactive visuals, and psychedelic generative art. Activate on "Milkdrop", "music visualization", "WebGL visualizer", "Butterchurn", "audio reactive", "FFT visualization", "spectrum analyzer". NOT for simple bar charts/waveforms (use basic canvas), video editing, or non-audio visuals.

curiositech/windags-skills

Expert legal research agent for finding and scraping expungement data state by state. Knows authoritative sources, URL patterns, Firecrawl configuration, and 2026 legal landscape.

curiositech/windags-skills

Expert in 3D computer vision labeling tools, workflows, and AI-assisted annotation for LiDAR, point clouds, and sensor fusion. Covers SAM4D/Point-SAM, human-in-the-loop architectures, and vertical-specific training strategies. Activate on '3D labeling', 'point cloud annotation', 'LiDAR labeling', 'SAM 3D', 'SAM4D', 'sensor fusion annotation', '3D bounding box', 'semantic segmentation point cloud'. NOT for 2D image labeling (use clip-aware-embeddings), general ML training (use ml-engineer), video annotation without 3D (use computer-vision-pipeline), or VLM prompt engineering (use prompt-engineer).

curiositech/windags-skills

Implement WCAG 2.2 AA/AAA compliance with automated testing, keyboard navigation, screen reader support, and focus management. Activate on: accessibility audit, WCAG compliance, keyboard navigation, screen reader, aria attributes, axe-core, focus trap. NOT for: design-level accessibility review (use design-accessibility-auditor), color contrast only (use css-in-js-architect).

curiositech/windags-skills

Time-blind friendly planning, executive function support, and daily structure for ADHD brains. Specializes in realistic time estimation, dopamine-aware task design, and building systems that actually work for neurodivergent minds.

curiositech/windags-skills

Designs digital experiences for ADHD brains using neuroscience research and UX principles. Expert in reducing cognitive load, time blindness solutions, dopamine-driven engagement, and compassionate design patterns. Activate on 'ADHD design', 'cognitive load', 'accessibility', 'neurodivergent UX', 'time blindness', 'dopamine-driven', 'executive function'. NOT for general accessibility (WCAG only), neurotypical UX design, or simple UI styling without ADHD context.

curiositech/windags-skills

>- Apply crisis decision-making research to agent routing, uncertainty triage, and coordination failure analysis in time-pressured systems. Use when diagnosing handoff failures, analytical paralysis, or expert judgment under incomplete information. NOT for routine coding, simple CRUD design, or static single-agent tasks with complete information.

curiositech/windags-skills

Extend and modify the admin dashboard, developer portal, and operations console. Use when adding new admin tabs, metrics, monitoring features, or internal tools. Activates for dashboard development, analytics, user management, and internal tooling.

curiositech/windags-skills

Conversation patterns and interaction protocols for multi-agent systems. Covers request/response, pub/sub, blackboard, delegation chains, debate, critique, consensus, fan-out/fan-in, supervisor-worker, and peer negotiation. Deep analysis of AutoGen conversation patterns, CrewAI delegation, LangGraph state passing, and FIPA-ACL performatives. Teaches how to design what agents say to each other and in what order. Activate on: "agent conversation", "agent protocol", "multi-agent debate", "agent delegation", "supervisor worker pattern", "agent voting", "consensus protocol", "fan-out fan-in", "agent negotiation", "blackboard pattern", "agent dialogue", "conversation topology", "agent handoff". NOT for: wire format or serialization (use agent-interchange-formats), orchestration infrastructure (use agentic-infrastructure-2026), single agent behavior (use agentic-patterns).

curiositech/windags-skills

Meta-agent for creating new custom agents, skills, and MCP integrations. Expert in agent design, MCP development, skill architecture, and rapid prototyping. Activate on 'create agent', 'new skill', 'MCP server', 'custom tool', 'agent design'. NOT for using existing agents (invoke them directly), general coding (use language-specific skills), or infrastructure setup (use deployment-engineer).

curiositech/windags-skills

AI-powered calendar management and agent-based scheduling coordination. Covers calendar APIs (Google Calendar, CalDAV/iCal), AI scheduling assistants (Reclaim, Clockwise, Motion, Cal.com), building custom calendar agents with MCP, multi-calendar merging, timezone management, focus block protection, meeting fatigue detection, and agent-to-agent meeting negotiation protocols. Activate on: "calendar agent", "AI scheduling", "calendar coordination", "meeting scheduling", "calendar API", "focus time protection", "calendar optimization", "Google Calendar MCP", "Reclaim", "Clockwise", "Motion", "Cal.com", "smart scheduling", "calendar-aware agent", "timezone scheduling", "agent negotiation meetings". NOT for: manual calendar UI component design (use form-validation-architect), project management scheduling or Gantt charts (use project-management-guru-adhd), general time-tracking or pomodoro apps (use adhd-daily-planner for time-awareness), building the agent itself from scratch (use agent-creator).

curiositech/windags-skills

Build and adopt production AI agent infrastructure in 2026. Covers framework selection (LangGraph, CrewAI, AutoGen, MCP), orchestration patterns, evaluation, observability, memory systems, and tool use. Also covers the SOCIAL dimension: how to sell agent infrastructure internally, change management, measuring ROI, building trust in autonomous systems, and scaling adoption across teams. Activate on: "agent infrastructure", "agent framework comparison", "which agent framework", "sell AI tools internally", "agent adoption", "agent observability", "agent evaluation", "MCP architecture", "agentic mesh", "enterprise AI agents", "AI change management", "agent ROI". NOT for: building specific agents (use ai-engineer), designing agent behavior patterns (use agentic-patterns), prompt tuning (use prompt-engineer).

curiositech/windags-skills

Fundamental patterns for effective agentic behavior. Teaches decomposition, tool orchestration, error recovery, context management, quality self-assessment, and knowing when to stop. Model-agnostic principles that make any agent more effective regardless of domain. Activate on: "how should I structure this agent", "agentic workflow", "agent patterns", "multi-step task", "tool orchestration", "/agentic-patterns", "decompose this", "agent best practices", "chain of actions", "when should the agent stop", "agent loop design". NOT for: creating agent infrastructure (use agent-creator), building DAGs (use windags-architect), specific tool implementation.

curiositech/windags-skills

Automated discovery and matching of agent skills for dynamic task routing and capability assessment

curiositech/windags-skills

Cryptographic security for agentic systems — zero-trust agent networking, signed message envelopes (JWS/JWE), capability-based security (ocaps), Merkle tree audit trails, WASM sandboxing, and formal verification. Covers CLI dev tool security, mTLS between agents, permission boundaries (least privilege for AI agents), and supply chain security for skills/plugins. Activate on: "agent security", "zero trust agents", "secure agent communication", "capability-based security", "ocap", "signed messages between agents", "agent audit trail", "sandbox agent execution", "agent permissions", "mTLS agents", "cryptographic verification", "agent supply chain", "OWASP agentic", "prove agent did X", "tamper-proof agent logs". NOT for: application-level SAST scanning (use security-auditor), network firewall rules (use infrastructure), SOC2/HIPAA compliance (organizational), or prompt injection defense (use prompt-engineer).

curiositech/windags-skills

Data structures and serialization formats for agent-to-agent communication. Covers message envelopes, structured output schemas, capability declarations, task handoff payloads, error/retry signaling, and context windows as data structures. Deep comparison of A2A protocol, MCP, OpenAI function calling, and LangChain message types. Teaches when to use rigid schemas vs free-form with validation, typed vs untyped, streaming vs batch. Activate on: "agent message format", "agent communication schema", "agent-to-agent protocol", "A2A protocol", "MCP message format", "structured output for agents", "agent interop", "interchange format", "agent serialization", "task handoff format", "capability declaration". NOT for: what agents say to each other (use agent-conversation-protocols), orchestration topology (use multi-agent-coordination), building agent infrastructure (use agentic-infrastructure-2026).

curiositech/windags-skills

Logic-based agent programming language implementing BDI architecture for practical autonomous agent development

curiositech/windags-skills

>- Design AgentSpeak(L)-style BDI agents with context-guarded plans, selection functions, and intention stacks. Use for interruptible autonomy, agent policy, and multi-agent orchestration in dynamic environments. NOT for simple rule engines, static planners, or centralized workflows.

curiositech/windags-skills

Foundational concurrent computation model where actors communicate exclusively through asynchronous message passing

curiositech/windags-skills

license: Apache-2.0 NOT for unrelated tasks outside this domain.

Habilidades Relacionadas