Skill de Aprendizado de Conhecimento com Texto e Imagem
Dado um tópico, entregue um artigo de conhecimento em chinês que explique os princípios, com diagramas explicativos já gerados e incorporados, fontes rastreáveis e prompts, salvando tudo no Obsidian do usuário.
Pré-requisitos de Execução
O ambiente hospedeiro deve ser capaz de carregar a skill ou executar este conjunto de instruções, ter acesso à internet, capacidade de leitura/escrita de arquivos e um modelo de geração de imagens invocável. Recomenda-se um ambiente Codex / ChatGPT com essas capacidades; outros Agentes podem usar ferramentas de geração de imagens já configuradas. Escrever diretamente no Obsidian local também requer acesso ao sistema de arquivos local. Se apenas a capacidade de exportação estiver disponível, entregue o artigo e as imagens, e explique a lacuna de importação. Primeiro, verifique as ferramentas reais; não presuma capacidades completas apenas com base no nome do produto.
Selecionar Forma de Saída
- Artigo de Conhecimento: Siga os passos 1-6 abaixo para verificação de fatos, explicação textual e visual, e importação para o Obsidian.
- README Ilustrado de Projeto: Primeiro, leia o Fluxo de Trabalho README. Organize o texto e as imagens em torno de "o que faz, como é a saída, como instalar, como usar pela primeira vez" e salve no projeto. Este formato não requer configuração do Obsidian, nem segue a extensão, quantidade de imagens, YAML e requisitos de resumo do artigo longo. Os princípios de verificação, escrita e ilustração continuam sendo aplicados.
Escopo e Resultados Padrão
- Um artigo completo geralmente tem cerca de 3000–6000 caracteres chineses e 3–5 diagramas explicativos; a quantidade de imagens inclui o diagrama de resumo final, ajustado de acordo com o tópico.
- Comece com uma introdução conceitual em fundo claro, explicando "o que é, como funciona, que problema resolve", mantendo a definição completa; em seguida, apresente o contexto, a motivação e a origem necessários.
- As imagens adotam por padrão o Estilo da Oficina de IA do Jiale. O texto do corpo e as legendas das figuras devem esclarecer as condições que afetam a compreensão; as imagens explicam o conhecimento diretamente.
- Tarefas de revisão alteram apenas a parte especificada pelo usuário. Ao ajustar apenas o cartão inicial, mantenha o corpo do texto, as imagens, as legendas e o estilo das imagens; só regenere as imagens se o usuário solicitar explicitamente.
- Conclua a verificação, redação, geração e importação dentro do escopo autorizado. Faça perguntas concentradas se faltarem configurações que afetem o resultado; não transforme escolhas comuns de layout em aprovações.
1. Determinar o Cofre de Notas e Dependências
Leia o arquivo config.local.json no diretório raiz da skill (se existir). A solicitação atual tem precedência sobre a configuração; se faltar configuração, use o ambiente do usuário ou as diretrizes da base de conhecimento. Consulte Regras de Arquivamento para os campos. Se o cofre de destino estiver faltando e não puder ser determinado a partir do contexto, apenas pergunte pelo caminho do cofre de destino e prossiga com o trabalho de pesquisa e rascunho independente.
Após entrar no cofre de destino, leia o AGENTS.md existente, o guia de uso e a página inicial; consulte notas semelhantes para determinar a estrutura de diretórios, metadados e método de vinculação. Ao depender de conteúdo wikilink, abra o arquivo real.
Use as seguintes capacidades conforme necessário nesta fase, localizando-as a partir do diretório de skills do ambiente atual, evitando caminhos de instalação fixos:
| Capacidade | Priorizar Reutilização | Quando Não Instalado |
|---|---|---|
| Pesquisa e Leitura em Plataformas | agent-reach; primeiro leia suas instruções, use os canais realmente disponíveis | Use a recuperação somente leitura disponível no ambiente hospedeiro e explique o canal usado desta vez |
| Verificação Geral de Páginas Web e Artigos | Ferramenta de rede do ambiente hospedeiro; pode ser auxiliada por research-workflow | Leia diretamente as fontes primárias |
| Planejamento de Redação e Ilustração | Regras deste pacote; pode ser auxiliado por content-research-writer, baoyu-article-illustrator | Siga o fluxo deste pacote |
| Geração ou Edição de Imagens Raster | Ferramenta de geração de imagens invocável do ambiente hospedeiro; priorize Image / imagegen nativo se disponível | Mantenha o rascunho concluído e o plano de ilustração, esclarecendo a lacuna de imagens |
| Importação Local | Python 3.10+, script de arquivamento deste pacote | Esclareça o ambiente ausente, mantenha arquivos de trabalho transferíveis |
Essas habilidades externas não são distribuídas com este pacote. Continue as etapas já cobertas por autorização; respeite as capacidades e limitações reais das ferramentas do ambiente hospedeiro.
2. Verificar e Estabelecer Base de Material
Salve sources.md no diretório de trabalho atual: registre os materiais realmente abertos, URLs, versões ou datas, conclusões suportadas e problemas não resolvidos. Primeiro, verifique documentação oficial, artigos, código-fonte e publicações originais; use postagens em plataformas para descobrir pistas, experiência prática ou controvérsias. Para material de plataforma adequado, obtenha-o preferencialmente via Agent Reach.
Números, datas, arquiteturas e conclusões de desempenho importantes no artigo devem corresponder ao texto original realmente lido. Use resumos de pesquisa apenas como pistas; distinga entre fatos, inferências, exemplos pedagógicos e resultados de medição real. Ao abordar origens e evolução, verifique as fontes originais. Conforme necessário, leia notas existentes, reutilize conceitos e verifique os destinos dos links.
Condição de conclusão: O mecanismo central e o contexto têm fundamentos, as principais divergências foram explicadas e o material é suficiente para dar suporte aos exemplos específicos no artigo.
3. Escrever a Linha Principal de Aprendizado
Leia as Regras de Redação e crie um rascunho em Markdown com YAML frontmatter. Comece com uma definição completa e organize o conteúdo na sequência "Contexto e Motivação → Processo Geral → Mecanismo Chave → Exemplo Específico → Compensações de Engenharia → Fechamento do Aprendizado", ajustando a ordem conforme o tópico.
Coloque marcadores únicos em locais adequados para ilustração, por exemplo, <!-- figure:01 -->. O texto do corpo explica as razões e o raciocínio intermediário; as imagens mostram estrutura, processo ou diferenças. As referências das fontes devem estar próximas às conclusões correspondentes. O diagrama de resumo final fica após a explicação principal e antes da lista de materiais originais.
Condição de conclusão: O leitor pode explicar o processo de causa e efeito, recontar um exemplo e julgar as condições de aplicação; a definição inicial, o contexto e o resumo final estão conectados; as principais conclusões são consistentes com a base de material.
4. Planejar e Gerar Imagens
Leia o Guia Visual, salve illustration-plan.md listando a pergunta de cada imagem, o parágrafo correspondente, nós, arestas, valores e legendas. Se reutilizar a ilustração de Baoyu, copie aquele guia visual para .baoyu-skills/baoyu-article-illustrator/EXTEND.md no diretório atual.
Salve o prompt final completo de cada imagem em arquivos como prompts/01-flow.md. Organize a descrição positiva em torno de "propósito da explicação, objetos e relacionamentos específicos, layout, visual, rótulos palavra por palavra, tamanho da tela". Use a ferramenta de geração de imagens invocável do ambiente hospedeiro; priorize Image / imagegen nativo se disponível; parâmetros e método de chamada seguem as regras da ferramenta atual, geralmente duas imagens por lote.
Localize o arquivo real a partir do resultado da ferramenta e copie-o para o diretório de trabalho atual. Abra cada imagem e verifique termos, caracteres chineses, números, setas, escala de comparação e legibilidade. Se encontrar erros claros, salve um prompt de revisão e faça correções direcionadas; mantenha a versão utilizável; se ainda houver lacunas, registre-as honestamente. Não declare resultados completos de texto e imagem se faltarem imagens ou se não tiverem sido verificadas.
5. Salvar no Obsidian
Leia as Regras de Arquivamento, salve images.json. Primeiro, execute o script de arquivamento com --dry-run no rascunho real, imagens, prompts e registros de material; após confirmar os resultados, importe. Resolva o diretório da skill como caminho real e, em seguida, chame scripts/archive_note.py, passando explicitamente o cofre de destino, diretório de notas e diretório de anexos.
O script de arquivamento apenas adiciona novas notas; em caso de homônimo, cria um sufixo de versão. Ao modificar um artigo existente, faça backup primeiro e modifique in-situ conforme a autorização atual; não arquive uma segunda cópia duplicada, nem regenere imagens não alteradas.
Se for necessário definir um estilo de cartão, use assets/jiale-knowledge.css; na primeira instalação do estilo, apenas anexe o fragmento, preservando as configurações e personalizações existentes do usuário. Se a base de conhecimento tiver um índice adequado, adicione um link para evitar duplicação.
6. Verificação Final
Verifique se o artigo final, imagens e arquivos realmente existem, se todos os marcadores de figura foram substituídos, e se as incorporações e wikilinks podem ser resolvidos. Relate o escopo real da verificação para verificação de arquivos, revisão de texto nas imagens e visualização da interface.
Na entrega, explique brevemente o conteúdo concluído, o local de salvamento e as lacunas reais, anexando notas abertas ou arquivos exportados. Um artigo de conhecimento só é marcado como entrega completa quando o material, o texto principal, as imagens reais e a importação estiverem todos concluídos; o README do projeto deve ser verificado de acordo com as condições de conclusão de seu fluxo de trabalho correspondente.