Paquetes

Utilice epismo pack para flujos de trabajo reutilizables y artefactos de contexto.

Crear un paquete de contexto

epismo pack create --type context --title "Team onboarding" --personal \
  --blocks '[{"title":"Where things live","content":"Docs in Notion, code in GitHub, designs in Figma."}]'

Crear un paquete de flujo de trabajo

epismo pack create --type workflow --title "Release review" --projects $PROJECT_ID \
  --steps '[{"title":"Summarize changes","content":"List merged PRs."}]'

Utilice dependsOn para expresar el flujo entre los pasos del flujo de trabajo.

Buscar paquetes

epismo pack search --type workflow --query "release review"
epismo pack search --type context --query "onboarding" --search-mode semantic

--search-mode selecciona el modo de clasificación: keyword (predeterminado) o semantic (coincidencia de palabras clave más similitud de vectores). Omítalo para la búsqueda de palabras clave.

Leer paquetes

epismo pack get $PACK_ID
epismo pack get $PACK_ID --full
epismo pack get @repo-map --block-id b001,b002
epismo pack get @handle/repo-map
epismo pack get $PACK_ID --share-url

El valor predeterminado lee los datos del esquema de devolución. Utilice --full solo cuando sea necesario el contenido anidado completo. Utilice --share-url para crear o devolver un enlace para compartir a pedido. La respuesta incluye shareUrl; La creación y actualización de paquetes no crean un enlace para compartir automáticamente. Solicitar un enlace no hace público un paquete privado, por lo que los destinatarios aún necesitan acceso a los paquetes privados.

Lea primero el esquema para mantener pequeño el contexto del agente y luego obtenga solo el contenido anidado que necesita. epismo pack get cuesta lo mismo 1 crédito en los modos esquema, bloque/paso seleccionado y completo.

Califica un paquete

epismo pack rate registra el resultado del uso de un paquete.

epismo pack rate @release-review success
epismo pack rate $PACK_ID failure

Un resultado por cuenta y paquete: repetir el comando actualiza el resultado anterior (últimas victorias). Los resultados calificados alimentan los recuentos de éxito/fracaso del centro y la clasificación de tendencias.

Ejecutar un paquete de flujo de trabajo

epismo pack run expande un paquete de flujo de trabajo en una pista: un objetivo raíz más una tarea todo por paso, creada en una sola llamada.

epismo pack run @release-review \
  --title "Ship CSV export" \
  --projects $PROJECT_ID \
  --assignee human=$USER_ID \
  --context @repo-conventions

• La meta es el objetivo de la carrera y el ancla de recuperación. --title / --content configúrelo; Si se omiten, el valor predeterminado es el título y el contenido del paquete.
• Los ID del paso dependsOn se resuelven en los UUID de pista creados. Cada tarea se vincula con el objetivo a través de goalId.
• Los mapas --assignee token=id incluyen tokens de asignados para realizar un seguimiento de los asignados. Asigne human a una identificación de usuario; Los identificadores de agentes se resuelven tal cual. Los pasos human no asignados se dejan sin asignar y se informan en warnings.
• --context registra paquetes de contexto como fuentes context: en el objetivo (referencias, no copias). Cada pista creada lleva una fuente workflow:<pack-id> al paquete.

La respuesta incluye goal.id, la identificación de cada tarea con su origen stepId y stepMap. Obtenga la ejecución completa más tarde con:

epismo track search --type task --filter '{"goalId":["<goal-id>"]}'

Actualizar contenido anidado

epismo pack update @repo-map --blocks '[{"op":"add","title":"Local setup","content":"npm install"}]'
epismo pack update @repo-map --blocks '[{"op":"update","id":"b001","content":"Updated text"}]'
epismo pack update @repo-map --blocks '[{"op":"move","id":"b003","beforeId":"b001"}]'
epismo pack update @repo-map --blocks '[{"op":"remove","id":"b002"}]'

Utilice move con exactamente uno de beforeId o afterId para reordenar artículos; Los valores del flujo de trabajo dependsOn permanecen sin cambios. Omitir --blocks o --steps mantiene el contenido anidado sin cambios. Pasar [] no es una operación. La eliminación de todos los elementos anidados requiere una operación remove por ID de elemento.

Alias

epismo alias upsert @repo-map --reference $PACK_REFERENCE
epismo alias get @repo-map
epismo alias list --type context