Communitygithub.com

XiucuiGuan/teachany-hepbl

TeachAny 高等教育 PBL 拆解 Agent Skill — 输入高校课程项目目标，输出知识路径长图 + 可编辑链接 + HE-PBL 设计方案（v2.0.0）

O que é teachany-hepbl?

Esta skill do TeachAnyHEPBL foi projetada para agentes de IA que atuam na educação superior, automatizando a decomposição de projetos de curso universitário em artefatos pedagógicos completos. Ao receber o objetivo de um projeto de curso, juntamente com campos opcionais como disciplina, matéria e tipo de entrega, a skill gera três saídas principais: (1) uma imagem longa em PNG com a decomposição HE-PBL estruturada e um grafo do sistema de conhecimento do curso; (2) uma página web interativa que replica o conteúdo da imagem, permitindo o preenchimento online de fichas de projeto, informações de grupo e submissão por e-mail aos professores; e (3) uma URL de edição para refinar a decomposição. O fluxo de trabalho segue um pipeline de seis estágios que alinha os nós de conhecimento com o sumário do curso (evitando invenção). A skill também impõe uma etapa de calibragem obrigatória: quando um documento de design do projeto está presente, o agente deve extrair um overlay JSON 'palavra por palavra' dele e executar um script de calibragem para reconstruir a página web e a imagem. A saída segue um template padronizado que resume os objetivos tridimensionais (conhecimento, habilidade e qualidade), os níveis de Bloom e links para edição. A ferramenta é compatível com CLI Python, utilizando Playwright para renderização de páginas, e inclui scripts de fallback para ambientes com restrições de rede. É ideal para educadores e desenvolvedores que desejam automatizar a criação de materiais pedagógicos baseados em projetos, garantindo alinhamento curricular e integridade dos dados.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add XiucuiGuan/teachany-hepbl
Ver original→Navegar por todas as habilidades

Perguntar na sua IA favorita

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

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Prévia

Do README da skill

Decomposição do caminho de conhecimento do curso

Documentação

TeachAnyHEPBL

Transforme o objetivo de um projeto de curso universitário (+ disciplina / curso / entrega opcionais) em:

  1. Imagem longa PNG — decomposição HE-PBL estruturada + grafo do sistema de conhecimento do curso
  2. Página web interativa — página interativa de decomposição do projeto com conteúdo consistente com a imagem longa, incluindo ficha de projeto preenchível online, painel de informações do grupo e suporte para envio por e-mail ao professor (consulte references/interactive-webpage.md para as especificações)
  3. URL de edição — https://www.teachany.cn/pbl?... para refinamento via chat, ajustes de nós e criação de materiais didáticos

A decomposição usa o pipeline de seis estágios do TeachAny em teachany.cn (LLM + índice curricular). Não invente nós de conhecimento por conta própria — alinhe-se ao programa do curso alvo (课程大纲 / 培养方案) em vez de fabricar estrutura de capítulos.

Fluxo de Trabalho

  1. Analise o objetivo do projeto de curso e os campos opcionais (consulte references/parameters.md). Padrão --grade university.
  2. Execute a CLI fornecida a partir deste diretório da skill (onde SKILL.md reside):
python3 scripts/hepbl-decompose.py \
  --goal "Texto original da tarefa do usuário" \
  --grade university \
  --subject computer-science \
  -o ./pbl-output
  1. Na primeira execução, instale as dependências se estiverem faltando: pip install playwright && playwright install chromium
  2. Elabore o design HE-PBL seguindo references/course-blueprint.md — objetivos tridimensionais, níveis de Bloom, cadeia de pré-requisitos, fluxo acadêmico. Use references/examples.md como referência de estilo.
  3. Calibração autoritativa do design (obrigatória quando existir documento de design, não pode ser ignorada): extraia o overlay JSON palavra por palavra a partir do documento de design → execute scripts/calibrate_hepbl.py para reconstruir a página web e a imagem longa (veja detalhes em "Controle de Acesso de Calibração Autoritativa do Design" e "Especificações de Visualização da Rota Técnica" abaixo).
  4. Responda com o caminho da PNG, caminho da página web interativa, contagens de nós do JSON, os três objetivos tridimensionais e a edit_url (nunca inclua auto=1 nos links que você der aos usuários).
  5. Se o Playwright falhar, siga references/fallback.md — ainda assim retorne um link de edição.

Script de Substituição Local Restrito (mantenha o script original, use este quando o original não funcionar)

scripts/hepbl-decompose-local.py é uma versão de substituição do script original (o hepbl-decompose.py original é mantido), direcionada aos seguintes problemas verificados localmente:

  1. Download travado do Chromium integrado do Playwright (CDN inacessível) → fallback automático para channel="msedge" (Edge do sistema)
  2. Timeout de 360s insuficiente → TIMEOUT_MS = 900_000 (a página pbl unifica o índice localStorage com cota excedida, cada reconstrução total leva cerca de 100–180s, o fluxo completo testado leva 8–11 minutos, execute em segundo plano)
  3. net::ERR_NETWORK_CHANGED esporádico no goto → repetição automática 3 vezes (intervalo de 5s)
# Uso idêntico ao script original (o template ainda é referenciado de forma relativa a ../assets/hepbl-report.html, não mova)
python scripts/hepbl-decompose-local.py --goal "..." --grade university --subject mathematics -o ./pbl-output

Solução rápida de problemas: imagem longa gerada mas faltando página web interativa = o script foi copiado para outro local, resultando em template ../assets/ não encontrado (ignorado silenciosamente; coloque o template de volta no mesmo diretório); SciPy local bloqueado pela política de controle de aplicativos Windows (DLL _trlib), para projetos de PL use sempre PuLP(CBC) como principal, SciPy com try/except como opcional para validação cruzada (NumPy/PuLP funcionam normalmente).

Padrões de Design HE-PBL (obrigatórios na saída)

Cada design DEVE incluir:

  • 知识目标 / 能力目标 / 素质目标 (objetivos tridimensionais)- Nível da taxonomia de Bloom (记忆 / 理解 / 应用 / 分析 / 评价 / 创造) por objetivo
  • Pré-requisitos de conhecimento (cadeia de pré-requisitos para cursos/capítulos anteriores)
  • Conceitos centrais e dificuldades mapeados para o sistema de conhecimento do curso
  • Fluxo do projeto: pesquisa bibliográfica → design de solução → implementação e validação → apresentação de resultados
  • Entregas avaliáveis com padrões acadêmicos (relatório de laboratório / documento de design / defesa)

Consulte references/course-blueprint.md para o padrão completo.

Controle de Acesso de Calibração Autoritativa do Design (obrigatório)

Quando existir um documento de design (por exemplo, "PBL 项目设计方案" md), a decomposição do motor é apenas um rascunho inicial; a entrega final deve passar pelo controle de acesso de calibração:

  1. Extração palavra por palavra do overlay: nomes de nós, objetivos tridimensionais, números de restrições, resultados de referência (x*/Z*/preço sombra), horas por fase — tudo extraído literalmente do documento de design, não invente ou reformule.
  2. Poluição de remoção null: campos inventados pelo motor (techRoute/pathPlan/projectBlueprint/stats) devem ser definidos como null no overlay e removidos durante deep_merge; chaves de metadados prefixadas com _ devem ser removidas.
  3. Imagem longa = página web: use scripts/calibrate_hepbl.py para reconstruir a página web e a imagem longa (captura de tela completa do Playwright, device_scale_factor=2). Realize uma auto-verificação antes da entrega (nomes de nós consistentes com o documento de design, payload com zero resíduos, summary consistente com o número de nós).
  4. Título unificado: o overlay DEVE conter o campo title (literalmente consistente com o título do documento de design) — o Hero da página web, a guia, o relatório exportado e o título da imagem longa são todos obtidos de DATA.title (fallback para o goal se ausente).
  5. Entrada para continuar edição: o botão "Abrir no TeachAnyHE" na página web copia o comando de invocação da skill @skill:TeachAnyHE (cole na caixa de diálogo do WorkBuddy para continuar editando no cenário de ensino superior); o link do motor teachany.cn é rebaixado para um link pequeno "Rascunho Inicial do Motor TeachAny" mantido (DATA.edit_url).

Especificações de Visualização da Rota Técnica

  • Na página web, priorize a renderização do fluxograma em camadas techStages[] (stage/hours/tasks[]/output) + toolChain[] (name/use): chips da cadeia de ferramentas → setas de conexão → cartões de fase (círculo numerado + linhas de conexão + emblema de horas + lista de tarefas + saída da fase); se ausente, fallback para lista de quatro seções projectPhases.
  • Consulte references/interactive-webpage.md para o contrato de dados e estrutura de blocos; veja references/calibration-example-lp.json para um exemplo completo de overlay.

Template de Saída

## Decomposição de Design de Curso HE-PBL

**Projeto**: {title}

![Decomposição do caminho de conhecimento do curso]({png_path})

- **Nós do grafo**: {nodeCount} (alinhados ao sumário {matched} · extensão {external})
- **Objetivo de conhecimento**: {...}
- **Objetivo de habilidade**: {...}
- **Objetivo de qualidade**: {...}
- **Nível de Bloom**: {...}
- **Página web interativa**: [Abrir página de decomposição do projeto]({html_path}) (preenchível online: ficha de projeto, informações do grupo e envio para e-mail do professor)
- **Continuar edição**: O botão "Abrir no TeachAnyHE" na página web copia o comando de invocação da skill (cole na caixa de diálogo do WorkBuddy para continuar editando no cenário HE) · Link do rascunho inicial do motor: {edit_url}

O comando copiado pelo botão "Abrir no TeachAnyHE" ao ser colado no diálogo do WorkBuddy permite continuar a conversa para modificar a decomposição, ajustar pontos de conhecimento e criar materiais didáticos com um clique.

Mostre a PNG no chat quando o ambiente suportar imagens.

Por que não escrever o grafo manualmente?

O TeachAny combina nós com índices curriculares, executa revisão de relevância e constroi arestas de dependência. Uma lista simples de LLM perde o alinhamento com o sumário e produz IDs de nós falsos.

Exemplos

Consulte references/examples.md para uma biblioteca completa de exemplos HE-PBL em cursos de 数学 / 计算机 / 通信 / 电气.

Exemplo 1 — Estrutura de Dados: python3 scripts/hepbl-decompose.py --goal "Projetar sistema de caminho mais curto para navegação no campus…" --grade university --subject computer-science --deliverable engineering-prototype -o ./pbl-output

Exemplo 2 — Sinais e Sistemas: python3 scripts/hepbl-decompose.py --goal "Design de filtro FIR e análise espectral…" --grade university --subject communications --deliverable simulation-report -o ./pbl-output

Recursos Adicionais

Habilidades Relacionadas

steipete/sag

ElevenLabs text-to-speech with mac-style say UX.

community

steipete/oracle

Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.

community

steipete/peekaboo

Capture and automate macOS UI with the Peekaboo CLI.

community

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

community

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

community

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

community