CommunityPesquisa e Análise de Dadosgithub.com

pm-tasks-core

Núcleo compartilhado para todos os adaptadores pm-tasks-<tool>. Define fases de extração, estrutura de cartão genérico, vocabulário CRUD, contrato de modo autônomo, regras de busca de configuração e formato de registro de auditoria.

O que é pm-tasks-core?

Este skill fornece o núcleo compartilhado para todos os adaptadores da família pm-tasks-<tool>, que são habilidades de agente para ferramentas como Claude Code, Cursor, Codex e Windsurf, seguindo a especificação Skills aberta. Ele define a estrutura fundamental para que os adaptadores extraiam tarefas de diferentes fontes (arquivos de planejamento, colagem inline ou entrada implícita) e as convertam em cartões genéricos padronizados. Inclui um vocabulário CRUD de seis verbos idempotentes com suporte a `clientToken`, um modo autônomo que requer ativação explícita e lista de permissões, regras de busca de configuração em ordem definida (repositório local e depois configuração do usuário), e um formato de registro de auditoria append-only usado para resolver referências de tarefas. O skill também oferece um helper de inicialização via `npx @llodev/pm-tasks-<tool> init` e um comando de diagnóstico `pm-tasks-core-doctor` para validar ambientes. Adaptadores referenciam este skill por caminho e o invocam antes de aplicar sua formatação específica, garantindo consistência entre ferramentas sem um mecanismo formal de dependência. Ele não funciona sozinho; exige que pelo menos um adaptador pm-tasks-<tool> esteja instalado.

Funciona com✓Claude Code✓Codex CLI✓Cursor✓Windsurf
npx skills add llodev/skills

Installed? Explore more Pesquisa e Análise de Dados skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Perguntar na sua IA favorita

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

Documentação

O que pm-tasks-core faz?

Núcleo compartilhado para todos os adaptadores pm-tasks-<tool>. Define as fases de extração, a estrutura de cartão genérico, o vocabulário CRUD, o contrato de modo autônomo, as regras de busca de configuração e o formato de registro de auditoria. Os adaptadores referenciam este skill por caminho — não há mecanismo formal de dependência na especificação.

Roteamento

Os adaptadores invocam este skill ANTES de aplicar sua formatação específica da ferramenta. O ponteiro exato está documentado em references/contract.md.

Fases

FasePropósitoReferência
1Identificar a entrada (arquivo de plano vs colagem inline vs implícita)references/contract.md § 1
2Extrair seções por intenção (objetivo, pré-requisitos, tarefas, critério de conclusão)references/contract.md § 2
2.5Barreira de antipadrõesanti-patterns/core.md
3Construir o cartão genéricoreferences/generic-card.md

Os adaptadores então executam as Fases 4+ de acordo com seu próprio SKILL.md.

Vocabulário CRUD (verbos que os adaptadores implementam)

Consulte references/crud-vocabulary.md. Seis verbos, todos idempotentes (com regras de clientToken para casos não naturais).

Modo autônomo

Consulte references/autonomous-mode.md. Ativado apenas pela sentinela [autonomous] / --auto / env LLODEV_PM_TASKS_AUTONOMOUS=1. Requer lista de permissões explícita + escopo + limite de taxa na configuração da ferramenta. Nunca inferido.

Configuração

Ordem de busca: <git-root>/.<tool>.json → ~/.config/llodev/pm-tasks/<tool>.json → abortar. Segredos NUNCA em JSON (apenas variáveis de ambiente / chaveiro do SO).

Registro de auditoria

Formato JSONL somente anexação em ~/.local/share/llodev/pm-tasks/<tool>/audit.log. Esquema em references/audit-log-format.md. Também serve como índice de consulta para resolução de <task-ref>.

Helper de inicialização

Os adaptadores expõem npx @llodev/pm-tasks-<tool> init. UX compartilhada em references/init-ux.md. Biblioteca de implementação em @llodev/pm-tasks-core/init-lib (código-fonte TypeScript em ./src/init-lib.ts; compilado para ./dist/init-lib.js).

Verificação de integridade (doctor)

pm-tasks-core-doctor valida configuração do workspace, lista de permissões autônoma, capacidade de escrita da auditoria e alcance de rede. Matriz de verificação e códigos de saída em references/doctor.md — catálogo de verificações pm-tasks-core-doctor + códigos de saída.

Fallback independente

Este skill não é útil sem um adaptador. Se ativado sozinho, informe ao usuário que é necessário instalar pelo menos um pacote pm-tasks-<tool>.

Habilidades Relacionadas