Desenvolvimento e Redação do Modus
Este é um conjunto de habilidades compostas voltado para o próprio framework Modus. Um único ponto de entrada conecta conhecimento global, desenvolvimento de módulos, testes, publicação e redação de artigos; os guias dos módulos são carregados de acordo com a tarefa, sem inserir todo o diretório de referência no contexto de uma só vez.
Primeiro, determine o projeto atual
A localização do código-fonte é definida pelo checkout especificado pelo usuário; quando não especificado, usa-se a raiz do repositório Git atual. O diretório desta habilidade é determinado pela localização do SKILL.md carregado. Ao entrar em um checkout pela primeira vez, defina SKILL_DIR como o diretório desta habilidade e execute um diagnóstico somente leitura na raiz do repositório Modus:
python3.11 "$SKILL_DIR/scripts/inspect_repository.py" --root .
Ele verifica branch, HEAD, upstream, modificações locais, versão do pacote e desvios da linha de base do conhecimento, sem acesso à rede, sem escrever no repositório e sem chamar o Modus instalado. Use qualquer interpretador Python 3.11+; substitua python3.11 nos exemplos conforme seu ambiente.
O snapshot do conhecimento vem de modus-open / 49c51621f378a58d6724eedde4657d9505346d45, pacote de distribuição openmodus 0.0.4. Branches, versões ou alterações de arquivo diferentes significam que os guias relevantes precisam ser verificados com a implementação atual; não mude de branch automaticamente, atualize seu CLI pessoal ou gere conhecimento do projeto.
Leia primeiro a visão geral, depois selecione o guia na tabela abaixo. Se você já conhece o projeto e a tarefa está clara, pode ir diretamente para o módulo relevante.
Roteamento de Tarefas
| Tarefa Atual | Ler |
|---|---|
| Desenvolvimento de funcionalidades, correções, refatoração, revisão de código | Fluxo de desenvolvimento + módulo correspondente + Verificação e publicação |
| Ajuda, parâmetros, códigos de saída, experiência em chinês, manutenção de pacotes pessoais | CLI e ponto de entrada de manutenção |
| Integração, atualização, desinstalação, manifesto, conflitos de ativos, proteção Git | Instalação do projeto e propriedade |
| Integração CodeBuddy / Claude / Cursor / Codex, hooks de inicialização | Plataformas e hooks |
| Descoberta de código-fonte, congelamento, parsing, compilador, extensões de linguagem, hits de cache | N1–N2: Código-fonte e observação |
| Resolução de identidade, relacionamento de chamadas, topologia, entrada para efeito, travessia de capacidades | N3–N4: Resolução e capacidade |
| Candidatos de escopo, sugestões de agrupamento, pacotes de evidência, contexto, cursor, sumário | N5–N6: Projeção e entrega |
| Contexto do projeto atual, roteamento de conhecimento, classificação, fallback de código-fonte, orçamento | Recuperação e orquestração |
| Identidade Markdown, CAS, atualização de conhecimento, âncoras, verificação de integridade e publicação | Escrita e verificação de conhecimento |
Comportamento init/reinit/update/sync, geração de corpo, confirmação de escopo, templates | Fluxo de trabalho de criação de conhecimento |
| Workspace multi-repositório, endereçamento de membros, navegação externa, isolamento | Workspace |
| Wheel, pacote fonte, dependências, CI, seleção de testes | Verificação e publicação |
| Artigos, relatórios, introdução técnica, esboço de compartilhamento, diagrama de arquitetura | Base de código-fonte e escrita; consulte o módulo correspondente para os mecanismos envolvidos |
| Verificar iwiki, materiais antigos ou base desta habilidade | Fontes e diferenças |
Limites que são mais fáceis de modificar incorretamente
- A instalação e integração do Modus, a evidência de inicialização e o conhecimento Markdown de longo prazo têm proprietários diferentes.
modus initinstala ativos;/modus-initinvestiga e cria conhecimento pelo assistente. - A recuperação normal lê o código-fonte atual e o Markdown oficial. A análise de inicialização não se torna uma fonte factual para a operação diária; novas capacidades não devem importar
machinepara o caminho normal do CLI. - N1–N6 são processamento determinístico de evidências; K1–K6 são criação semântica pelo assistente. A combinação de capacidades não chama LLM; caminhos de candidatos e representantes não equivalem a domínios oficiais ou cadeias de execução completas.
- A semântica de falha difere entre transações de instalação/atualização e atualizações de conhecimento. Atualizações de conhecimento são commitadas por arquivo e relatam sucesso parcial; não podem prometer rollback em lote.
.modus/e cópias do host são ativos de integração gerenciados;modus/knowledge/é conhecimento de longo prazo;constraint/ereferences/business/artificiais têm proteção independente.cleanprova apenas a integridade ou promessa de publicação coberta pelo verificador, não prova a verdade, integridade ou clareza do corpo, nem prova o sucesso em tempo de execução.- Comandos, campos JSON, códigos de status, IDs estáveis e exibição em chinês são mantidos separadamente. Templates são contratos de comportamento do produto entregues com o pacote.
Concluindo a tarefa
Os resultados do desenvolvimento explicam comportamentos específicos, proprietário da modificação, verificação real e limites não verificados. Os resultados da escrita separam a implementação atual, objetivos de design, materiais históricos e evidências de efeito. Referenciar esta habilidade acelera a localização, mas as conclusões de implementação devem reler o código-fonte atual.
Esta habilidade suporta o desenvolvimento subsequente, mas não concede permissões de publicação, commit, push, escrita em documentação externa ou delegação; essas ações seguem a autorização da tarefa atual do usuário. Não reconstrua automaticamente o conhecimento, atualize a habilidade ou altere ativos não relacionados devido ao uso desta habilidade.