tencentmusic/modus

Desarrollo y escritura de Modus

Este es un conjunto de habilidades compuestas al servicio del propio framework Modus. Un punto de entrada conecta el conocimiento global, el desarrollo de módulos, las pruebas, la publicación y la redacción de artículos; las guías de los módulos se cargan según la tarea, sin saturar el contexto con todo el directorio de referencia de una sola vez.

Primero, determine el proyecto actual

La ubicación del código fuente se basa en el checkout especificado por el usuario; si no se especifica, se utiliza el directorio raíz del repositorio Git actual. El directorio de esta habilidad se determina por la ubicación del SKILL.md cargado. Al entrar por primera vez a un checkout, establezca SKILL_DIR como el directorio de esta habilidad y ejecute el diagnóstico de solo lectura en el directorio raíz del repositorio Modus:

python3.11 "$SKILL_DIR/scripts/inspect_repository.py" --root .

Esto verifica la rama, HEAD, origen, modificaciones locales, versión del paquete y desviación de la línea base de conocimiento; no se conecta a la red, no modifica el repositorio ni ejecuta Modus instalado. Use cualquier intérprete de Python 3.11+; puede reemplazar python3.11 en el ejemplo según su entorno real.

La instantánea de conocimiento proviene de modus-open / 49c51621f378a58d6724eedde4657d9505346d45, paquete de distribución openmodus 0.0.4. Las diferentes ramas, versiones o cambios de archivos implican que las guías relevantes deben volver a la implementación actual para verificación; no cambie automáticamente de rama, actualice la CLI personal ni genere conocimiento del proyecto.

Primero lea la Visión general global, luego seleccione la guía según la tabla siguiente. Si ya está familiarizado con el proyecto y la tarea es clara, puede ir directamente al módulo correspondiente.

Enrutamiento de tareas

Tarea actual	Leer
Desarrollo de funcionalidades, correcciones, refactorización, revisión de código fuente	Flujo de desarrollo + módulo correspondiente + Verificación y publicación
Ayuda, parámetros, códigos de salida, experiencia en chino, mantenimiento de paquetes personales	CLI y punto de entrada de mantenimiento
Integración, actualización, desinstalación, manifiesto, conflictos de activos, protección de Git	Instalación del proyecto y propiedad
Integración de CodeBuddy / Claude / Cursor / Codex, hooks de inicio	Plataformas y hooks
Descubrimiento de código fuente, congelación, análisis, compilador, extensiones de lenguaje, aciertos de caché	N1–N2: Código fuente y observación
Resolución de identidad, relaciones de llamada, topología, entrada a efecto, recorrido de capacidades	N3–N4: Resolución y capacidad
Candidatos de ámbito, sugerencias de agrupación, paquetes de evidencia, contexto, cursor, resumen	N5–N6: Proyección y entrega
Contexto del proyecto actual, enrutamiento de conocimiento, clasificación, retroceso a código fuente, presupuesto	Recuperación y orquestación
Identidad Markdown, CAS, actualización de conocimiento, anclajes, verificación de integridad y publicación	Escritura y verificación de conocimiento
Comportamiento de init/reinit/update/sync, generación de cuerpo, confirmación de ámbito, plantillas	Flujo de trabajo de creación de conocimiento
Espacio de trabajo multirepositorio, direccionamiento de miembros, navegación externa, aislamiento	Espacio de trabajo
wheel, paquete fuente, dependencias, CI, selección de pruebas	Verificación y publicación
Artículos, informes, presentaciones técnicas, esquemas de intercambio, diagramas de arquitectura	Base de código fuente y escritura; los mecanismos involucrados deben leerse en conjunto con el módulo correspondiente
Verificar iwiki, materiales antiguos o la base de esta habilidad	Fuentes y diferencias

Límites más fáciles de modificar por error

• La instalación e integración de Modus, la evidencia de inicialización y el conocimiento Markdown a largo plazo tienen diferentes propietarios. modus init instala activos; /modus-init es investigado y creado por el asistente.
• La recuperación normal lee el código fuente actual y el Markdown oficial. El análisis de inicialización de la caché no se convierte en la fuente de facto para la ejecución diaria; las nuevas capacidades no deben importar machine a la ruta CLI común.
• N1–N6 son procesamiento de evidencia determinista, K1–K6 son creación semántica del asistente. La combinación de capacidades no invoca LLM, las rutas candidatas y representativas no equivalen a dominios formales o rutas completas de ejecución.
• Los semánticas de fallo de las transacciones de instalación/actualización y las actualizaciones de conocimiento son diferentes. Las actualizaciones de conocimiento se envían por archivo y reportan éxito parcial; no se puede prometer una reversión completa por lotes.
• .modus/ y las copias del host son activos de integración gestionados; modus/knowledge/ es conocimiento a largo plazo; constraint/ creado manualmente y references/business/ tienen protección independiente.
• clean solo demuestra la integridad o el compromiso de publicación cubiertos por el verificador, no la veracidad, integridad o claridad del cuerpo, ni el éxito en tiempo de ejecución.
• Los comandos, campos JSON, códigos de estado, IDs estables y la visualización en chino se mantienen por separado. Las plantillas son contratos de comportamiento del producto que se entregan con el paquete.

Completar la tarea

El resultado del desarrollo debe explicar el comportamiento específico, el propietario de la modificación, la verificación real y los límites no verificados. El resultado de la escritura debe separar la implementación actual, los objetivos de diseño, los materiales históricos y la evidencia del efecto. Citar esta habilidad puede acelerar la localización, pero las conclusiones de la implementación deben confirmarse con la lectura del código fuente actual.

Esta habilidad admite el desarrollo posterior, pero no otorga permisos de publicación, confirmación, envío, escritura en documentos externos o delegación; estas acciones heredan la autorización de la tarea actual del usuario. No reconstruya automáticamente el conocimiento, actualice la habilidad ni modifique activos no relacionados debido al uso de esta habilidad.