task-intelligence

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Task Intelligence — Protocolo de Amplificação Pré-Tarefa

任务智能——任务前增强协议

Overview

概述

Protocolo de Inteligência Pré-Tarefa — ativa TODOS os agentes relevantes do ecossistema ANTES de executar qualquer tarefa solicitada pelo usuário. Enriquece o contexto com análise paralela multi-agente, produz estimativa real de tempo (início→fim), mapeia problemas prováveis e improvável, e formula um plano de execução antecipado com estratégias de contingência.

任务前智能协议——在执行用户请求的任何任务之前，激活生态系统中所有相关的Agent。通过多Agent并行分析丰富上下文，生成从开始到结束的真实时间估算，映射可能和不太可能出现的问题，并制定带有应急策略的预先执行计划。

When to Use This Skill

何时使用此Skill

When the user mentions "pre-task briefing" or related topics
When the user mentions "briefing tarefa" or related topics
When the user mentions "plano execucao tarefa" or related topics
When the user mentions "antes de executar analise" or related topics
When the user mentions "task intelligence" or related topics
When the user mentions "consultar agentes paralelo" or related topics

当用户提到“pre-task briefing”或相关主题时
当用户提到“briefing tarefa”或相关主题时
当用户提到“plano execucao tarefa”或相关主题时
当用户提到“antes de executar analise”或相关主题时
当用户提到“task intelligence”或相关主题时
当用户提到“consultar agentes paralelo”或相关主题时

Do Not Use This Skill When

何时不使用此Skill

The task is unrelated to task intelligence
A simpler, more specific tool can handle the request
The user needs general-purpose assistance without domain expertise

任务与任务智能无关
更简单、更具体的工具可以处理请求
用户需要无领域专业知识的通用协助

How It Works

工作原理

Antes de qualquer execução, este agente realiza um briefing inteligente completo:

Ativa todos os agentes relevantes em paralelo — cada um analisa a tarefa pela sua ótica
Sintetiza o conhecimento coletivo em um plano unificado
Estima tempo real do início ao fim (com breakdown por etapa)
Mapeia problemas prováveis e os resolve antecipadamente
Define pontos de verificação para detectar desvios antes que virem bloqueadores

A razão central: executar uma tarefa sem esse briefing é como cirurgiar sem exame pré-operatório. O custo de 30-60 segundos de análise paralela elimina horas de retrabalho.

在执行任何任务之前，该Agent会完成一次完整的智能简报：

并行激活所有相关Agent——每个Agent从自身视角分析任务
将集体知识整合为统一计划
估算从开始到结束的真实时间（按阶段细分）
映射可能出现的问题并提前解决
定义检查点，在问题演变为障碍前检测偏差

核心原因：没有此简报就执行任务，如同不做术前检查就进行手术。30-60秒的并行分析成本，能消除数小时的返工。

Fase 1 — Classificação Da Tarefa (5-10 Segundos)

阶段1——任务分类（5-10秒）

Antes de qualquer coisa, classifique a tarefa em uma das categorias:

Categoria	Exemplos	Nível de Briefing
Simples	responder pergunta, explicar conceito, pequena edição	Mínimo (só scan)
Moderada	criar arquivo, modificar skill, instalar dependência	Normal (scan + match + estimativa)
Complexa	criar skill nova, integração API, arquitetura, refatoração	Completo (todos os passos abaixo)
Crítica	ações irreversíveis, deploys, delete, reset, modificar infra	Máximo + confirmação explícita

Para tarefas Simples, execute normalmente sem briefing completo. Para Moderada, Complexa e Crítica, execute o protocolo completo abaixo.

首先，将任务归类为以下类别之一：

类别	示例	简报级别
简单	回答问题、解释概念、小修改	最低（仅扫描）
中等	创建文件、修改Skill、安装依赖	常规（扫描+匹配+估算）
复杂	创建新Skill、API集成、架构设计、重构	完整（执行以下所有步骤）
关键	不可逆操作、部署、删除、重置、修改基础设施	最高+明确确认

对于简单任务，无需完整简报，正常执行即可。对于中等、复杂和关键任务，执行以下完整协议。

Fase 2 — Scan E Match Paralelo

阶段2——并行扫描与匹配

Execute simultaneamente:

bash

undefined

同时执行：

bash

undefined

Terminal 1 — Atualizar Registry

终端1 — 更新注册表

python agent-orchestrator/scripts/scan_registry.py

Terminal 2 — Identificar Agentes Relevantes

终端2 — 识别相关Agent

python agent-orchestrator/scripts/match_skills.py "<tarefa do usuário>"


Se `matched >= 2`, execute orquestração:
```bash
python agent-orchestrator/scripts/orchestrate.py --skills <skill1,skill2,...> --query "<tarefa>"

python agent-orchestrator/scripts/match_skills.py "<用户任务>"


如果`matched >= 2`，执行编排：
```bash
python agent-orchestrator/scripts/orchestrate.py --skills <skill1,skill2,...> --query "<任务>"

Fase 3 — Briefing Dos Agentes Especializados

阶段3——专业Agent简报

Para cada agente relevante identificado no match, faça uma pergunta direcionada:

Padrão de consulta por tipo de agente:

007 (Segurança): "Esta tarefa tem vetores de ataque, dados expostos, ou ações irreversíveis?"
skill-sentinel (Qualidade): "Existe skill redundante? A skill que será criada/modificada segue os padrões?"
agent-orchestrator (Orquestração): "Quais skills já existem que resolvem parte desta tarefa?"
matematico-tao (Complexidade): "Qual a complexidade computacional? Há otimizações não-óbvias?"
context-guardian (Continuidade): "Existe contexto de sessões anteriores relevante para esta tarefa?"
advogado-especialista/criminal (Legal): "Há implicações legais, LGPD, ou riscos regulatórios?"
leiloeiro-ia (Leilões): "Esta tarefa envolve dados ou lógica do domínio de leilões?"

Não consulte todos os agentes cegamente — escolha os 3-5 mais relevantes para a tarefa.

针对匹配到的每个相关Agent，提出针对性问题：

按Agent类型的查询模板：

007（安全）：“此任务存在攻击向量、数据暴露或不可逆操作吗？”
skill-sentinel（质量）：“是否存在冗余Skill？即将创建/修改的Skill符合标准吗？”
agent-orchestrator（编排）：“有哪些已存在的Skill可以解决此任务的部分需求？”
matematico-tao（复杂度）：“计算复杂度如何？是否有非显而易见的优化空间？”
context-guardian（连续性）：“是否存在与当前任务相关的之前会话上下文？”
advogado-especialista/criminal（法务）：“是否存在法律影响、LGPD合规问题或监管风险？”
leiloeiro-ia（拍卖）：“此任务涉及拍卖领域的数据或逻辑吗？”

不要盲目咨询所有Agent——选择与任务最相关的3-5个。

Fase 4 — Estimativa De Tempo Real

阶段4——真实时间估算

Construa um breakdown de tempo honesto com base na complexidade real:

ESTIMATIVA DE TEMPO — [Nome da Tarefa]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Etapa 1: [nome]          ~X min   [motivo do tempo]
Etapa 2: [nome]          ~X min   [motivo do tempo]
Etapa 3: [nome]          ~X min   [motivo do tempo]
Contingência (problemas) +X min   [buffer para imprevistos típicos]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
TOTAL ESTIMADO:          ~X min
Confiança: Alta/Média/Baixa — [justificativa]

Regras de estimativa honesta:

Nunca subestime para agradar — o usuário precisa saber o tempo real
Adicione sempre 20-30% de buffer para problemas típicos
Se a confiança for Baixa, explique por quê e o que aumentaria ela
Diferencie "tempo de execução do agente" vs "tempo de espera do usuário"

根据实际复杂度构建诚实的时间细分：

时间估算 — [任务名称]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
步骤1: [名称]          ~X分钟   [时间估算理由]
步骤2: [名称]          ~X分钟   [时间估算理由]
步骤3: [名称]          ~X分钟   [时间估算理由]
应急时间（问题处理） +X分钟   [针对典型意外的缓冲时间]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
总估算时间:          ~X分钟
置信度: 高/中/低 — [理由]

诚实估算规则：

永远不要为了讨好而低估——用户需要知道真实时间
始终添加20-30%的缓冲时间以应对典型问题
如果置信度为低，解释原因以及如何提高置信度
区分“Agent执行时间”与“用户等待时间”

Fase 5 — Mapa De Problemas (Antecipação Proativa)

阶段5——问题映射（主动预判）

Pense em TRÊS camadas de problemas:

考虑三层问题：

Problemas Prováveis (80%+ de chance de acontecer)

可能问题（80%+发生概率）

São os problemas que SEMPRE acontecem. Resolva-os ANTES de começar.

Exemplos por categoria:

Skills novas: YAML inválido → valide com

python -c "import yaml; yaml.safe_load(open('SKILL.md').read())"

antes de instalar

APIs externas: chave expirada, rate limit, mudança de endpoint → verifique autenticação primeiro
Instalações: dependências faltando, versão incompatível → leia requirements.txt antes de executar
Arquivos: path não existe, permissão negada, encoding errado → verifique antes de abrir
Git/Versionamento: branch errada, conflito de merge, uncommitted changes → sempre
```
git status
```
antes

这些是总会发生的问题。在开始前解决它们。

按类别示例：

新Skill：无效YAML → 安装前用

python -c "import yaml; yaml.safe_load(open('SKILL.md').read())"

验证

外部API：密钥过期、速率限制、端点变更 → 先检查认证
安装：缺少依赖、版本不兼容 → 执行前阅读requirements.txt
文件：路径不存在、权限拒绝、编码错误 → 打开前检查
Git/版本控制：错误分支、合并冲突、未提交更改 → 执行前始终运行
```
git status
```

Problemas Possíveis (30-70% de chance)

潜在问题（30-70%发生概率）

Problemas que podem acontecer dependendo do estado atual.

Estratégia: verifique rapidamente o estado antes de assumir que está OK.

取决于当前状态，可能发生的问题。

策略：在假设状态正常前，快速检查当前状态。

Problemas Improváveis mas Críticos (< 10% mas alto impacto)

低概率但关键问题（<10%概率但影响大）

Ações irreversíveis, perda de dados, exposição de credenciais.

Estratégia: backup preventivo, confirmação explícita, rollback plan.

Template de mapa de problemas:

MAPA DE PROBLEMAS — [Nome da Tarefa]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PROVÁVEIS (resolver antes de começar):
  ⚠ [problema] → [solução preventiva aplicada agora]
  ⚠ [problema] → [solução preventiva aplicada agora]

POSSÍVEIS (monitorar durante execução):
  ~ [problema] → [sinal de alerta] → [ação se ocorrer]

CRÍTICOS (baixa prob, alto impacto):
  🔴 [risco] → [backup/rollback plan]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

不可逆操作、数据丢失、凭证泄露。

策略：预防性备份、明确确认、回滚计划。

问题映射模板：

问题映射 — [任务名称]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
可能问题（开始前解决）：
  ⚠ [问题] → [当前已应用的预防性解决方案]
  ⚠ [问题] → [当前已应用的预防性解决方案]

潜在问题（执行期间监控）：
  ~ [问题] → [警报信号] → [发生时的操作]

关键问题（低概率、高影响）：
  🔴 [风险] → [备份/回滚计划]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Fase 6 — Plano De Execução Enriquecido

阶段6——增强执行计划

Depois de coletar análises dos agentes + estimativas + mapa de problemas, produza:

BRIEFING PRÉ-EXECUÇÃO — [Nome da Tarefa]
════════════════════════════════════════════
CONTEXTO COLETADO:
  • [insight do agente 1]
  • [insight do agente 2]
  • [insight do agente 3]

PLANO DE EXECUÇÃO:
  1. [etapa] (~Xmin) — [por quê esta ordem]
  2. [etapa] (~Xmin) — [dependência da anterior]
  3. [etapa] (~Xmin) — [verificação de qualidade]

TEMPO TOTAL: ~Xmin | CONFIANÇA: Alta/Média/Baixa

PROBLEMAS PRÉ-RESOLVIDOS:
  ✅ [problema] → [solução aplicada]
  ✅ [problema] → [solução aplicada]

PONTOS DE VERIFICAÇÃO:
  [ ] Após etapa 1: verificar [critério de sucesso]
  [ ] Após etapa 2: verificar [critério de sucesso]
  [ ] Final: validar resultado completo

ROLLBACK PLAN (se algo der errado):
  → [como desfazer cada etapa crítica]
════════════════════════════════════════════

收集Agent分析+估算+问题映射后，生成：

执行前简报 — [任务名称]
════════════════════════════════════════════
收集到的上下文：
  • [Agent1的洞察]
  • [Agent2的洞察]
  • [Agent3的洞察]

执行计划：
  1. [步骤] (~X分钟) — [为何此顺序]
  2. [步骤] (~X分钟) — [依赖前一步骤]
  3. [步骤] (~X分钟) — [质量检查]

总时间：~X分钟 | 置信度: 高/中/低

预先解决的问题：
  ✅ [问题] → [已应用的解决方案]
  ✅ [问题] → [已应用的解决方案]

检查点：
  [ ] 步骤1后：检查 [成功标准]
  [ ] 步骤2后：检查 [成功标准]
  [ ] 最终：验证完整结果

回滚计划（若出现问题）：
  → [如何撤销每个关键步骤]
════════════════════════════════════════════

Integração Com O Ecossistema

与生态系统的集成

Este agente complementa o agent-orchestrator — não substitui:

agent-orchestrator: identifica QUAIS skills usar (routing)
task-intelligence: enriquece COMO usar + quando + com que riscos (briefing)

Ambos devem ser ativados juntos. O CLAUDE.md já exige o orchestrator — este agente adiciona a camada de inteligência sobre ele.

此Agent补充agent-orchestrator——而非替代：

agent-orchestrator：识别要使用的Skill（路由）
task-intelligence：丰富使用方式+时机+风险（简报）

两者应同时激活。CLAUDE.md已要求使用orchestrator——此Agent在其基础上增加智能层。

Quando Não Usar O Briefing Completo

何时不使用完整简报

Perguntas rápidas de 1 linha (responder diretamente é mais eficiente)
Tarefas de leitura pura (read, grep, glob sem efeitos colaterais)
Iterações simples dentro de uma tarefa já planejada
Quando o usuário pede "só responde rápido" / "vibe comigo"

O objetivo não é burocracia — é inteligência a serviço da velocidade real.

1行快速问题（直接回答更高效）
纯阅读任务（read、grep、glob无副作用）
已规划任务内的简单迭代
当用户要求“快速回答”/“灵活处理”时

目标不是官僚主义——而是为实际速度服务的智能。

Referências

参考资料

```
references/problem-catalog.md
```
— Catálogo de problemas típicos por domínio
```
references/time-patterns.md
```
— Padrões históricos de tempo por tipo de tarefa
```
scripts/pre_task_check.py
```
— Script de verificação automatizada pré-tarefa

```
references/problem-catalog.md
```
— 按领域分类的典型问题目录
```
references/time-patterns.md
```
— 按任务类型划分的历史时间模式
```
scripts/pre_task_check.py
```
— 任务前自动检查脚本

Exemplo De Briefing Completo

完整简报示例

Tarefa do usuário: "Crie uma skill para integração com Stripe"

BRIEFING PRÉ-EXECUÇÃO — Skill: stripe-integration
════════════════════════════════════════════════════

CONTEXTO COLETADO (3 agentes consultados):
  • 007: CRÍTICO — API keys do Stripe NÃO devem ir para SKILL.md ou git.
    Usar variáveis de ambiente (.env). Webhooks precisam validação HMAC-SHA256.
  • skill-sentinel: whatsapp-cloud-api já implementa padrão HMAC-SHA256 para webhooks
    — reusar esse padrão. Skill deve seguir estrutura: config.py + client.py + SKILL.md.
  • agent-orchestrator: 3 skills similares (whatsapp, telegram, instagram) como referência
    de arquitetura. Nenhuma conflita com Stripe.

PLANO DE EXECUÇÃO:
  1. Criar estrutura de diretórios (~2min) — base para os demais arquivos
  2. Escrever SKILL.md com workflow (~5min) — define comportamento do agente
  3. Criar config.py com variáveis de ambiente (~3min) — sem hardcode de keys
  4. Criar stripe_client.py com autenticação (~10min) — métodos principais
  5. Criar webhook_handler.py com HMAC-SHA256 (~5min) — reusar padrão whatsapp
  6. Instalar via skill-installer (~2min) — validação + registro
  7. Gerar ZIP (~1min) — para backup/upload manual

TEMPO TOTAL: ~28min | CONFIANÇA: Alta
(estrutura clara, dependências conhecidas, sem APIs externas incertas)

PROBLEMAS PRÉ-RESOLVIDOS:
  ✅ API key exposta → .env obrigatório, .gitignore configurado
  ✅ YAML inválido → validar antes de instalar
  ✅ Webhook sem autenticação → HMAC-SHA256 incluído no plano

PONTOS DE VERIFICAÇÃO:
  [ ] Após SKILL.md: yaml.safe_load não levanta exceção
  [ ] Após config.py: sem strings hardcoded de credenciais
  [ ] Final: skill-installer valida os 10 checks

ROLLBACK PLAN:
  → Se skill-installer falhar: pasta em /tmp/stripe-skill-backup/
  → Se ZIP corrompido: reconstruir com build_ecosystem.py
════════════════════════════════════════════════════

用户任务： "创建一个与Stripe集成的Skill"

执行前简报 — Skill: stripe-integration
════════════════════════════════════════════════════

收集到的上下文（咨询了3个Agent）：
  • 007: 关键——Stripe的API密钥不得存入SKILL.md或git。使用环境变量(.env)。Webhooks需要HMAC-SHA256验证。
  • skill-sentinel: whatsapp-cloud-api已为Webhooks实现HMAC-SHA256标准——复用此标准。Skill应遵循结构：config.py + client.py + SKILL.md。
  • agent-orchestrator: 有3个类似Skill（whatsapp、telegram、instagram）可作为架构参考。与Stripe无冲突。

执行计划：
  1. 创建目录结构 (~2分钟) — 为其他文件奠定基础
  2. 撰写带工作流的SKILL.md (~5分钟) — 定义Agent行为
  3. 创建带环境变量的config.py (~3分钟) — 不硬编码密钥
  4. 创建带认证的stripe_client.py (~10分钟) — 核心方法
  5. 创建带HMAC-SHA256的webhook_handler.py (~5分钟) — 复用whatsapp标准
  6. 通过skill-installer安装 (~2分钟) — 验证+注册
  7. 生成ZIP (~1分钟) — 用于手动备份/上传

总时间：~28分钟 | 置信度: 高
（结构清晰，依赖已知，无不明确外部API）

预先解决的问题：
  ✅ API密钥暴露 → 强制使用.env，配置.gitignore
  ✅ 无效YAML → 安装前验证
  ✅ Webhook无认证 → 计划中包含HMAC-SHA256

检查点：
  [ ] SKILL.md完成后：yaml.safe_load无异常
  [ ] config.py完成后：无硬编码凭证字符串
  [ ] 最终：skill-installer通过10项检查

回滚计划：
  → 若skill-installer失败：备份目录在/tmp/stripe-skill-backup/
  → 若ZIP损坏：用build_ecosystem.py重新构建
════════════════════════════════════════════════════

Best Practices

最佳实践

Provide clear, specific context about your project and requirements
Review all suggestions before applying them to production code
Combine with other complementary skills for comprehensive analysis

提供关于项目和需求的清晰、具体上下文
将建议应用到生产代码前，先进行审查
与其他互补Skill结合使用，以获得全面分析

Common Pitfalls

常见陷阱

Using this skill for tasks outside its domain expertise
Applying recommendations without understanding your specific context
Not providing enough project context for accurate analysis

将此Skill用于其领域专业知识之外的任务
不理解具体上下文就应用建议
未提供足够的项目上下文以进行准确分析