Usando memoria de relaciones de Skills
Use esta plantilla cuando quiera que una habilidad le diga a un agente cuándo y cómo capturar relaciones de flujo de trabajo, capacidad y rol de administrador con la herramienta knowledge. Mantiene el grafo como un flujo de trabajo orientado al operador, no solo como una capacidad interna.
Crea un paquete para las habilidades de relationship-memory, luego genera el esqueleto de la habilidad:
sh
zeroclaw skills bundle add relationship-memory
zeroclaw skills add relationship-memory-capture \
--bundle relationship-memory \
--description "Capture and query durable workflow relationships with the knowledge graph" \
--edit
El comando skills add abre SKILL.md en tu editor. Reemplaza el contenido del archivo generado con esta plantilla:
---
name: relationship-memory-capture
description: Capture and query durable workflow relationships with the knowledge graph
version: 0.1.0
author: zeroclaw_operator
tags: [knowledge, memory, relationships]
---
# Relationship memory capture
Use this skill when the operator asks to remember or inspect how workflows, skills, capabilities, decisions, lessons, or steward roles connect to each other.
Before writing graph memory:
1. Confirm the deployment has `[knowledge] enabled = true`.
2. Ask what relationship should be remembered and why it should be durable.
3. Ask whether the entry may include private workspace, account, client, or contact context.
4. Refuse to store secrets, tokens, personal email addresses, phone numbers, private URLs, account IDs, session IDs, or credential-like values.
Capture durable things as graph nodes with the `knowledge` tool:
- Use `pattern` for reusable workflows, practices, or skill-shaped procedures.
- Use `technology` for tools, protocols, providers, or capability surfaces.
- Use `expert` for steward roles, maintainer roles, or agent roles. Prefer role labels over real names.
- Use `decision` for design choices, policy calls, or accepted direction.
- Use `lesson` for something learned from an incident, review, or run.
Relate nodes after capture:
- Use `uses` from a workflow or skill to a capability it depends on.
- Use `authored_by` from a workflow or skill to the role that maintains it.
- Use `applies_to` from a lesson, decision, or pattern to the project or capability it affects.
When the operator asks what is connected to a workflow, capability, decision, lesson, or steward role, call `graph_neighbors`.
Keep entries short and factual. If a relationship is uncertain, capture the uncertainty in the content field or ask before writing it.
Para hacer que la habilidad esté disponible para un agente, adjunta el paquete relationship-memory a ese agente. Por ejemplo, añade el alias del paquete a agents.<alias>.skill_bundles en la configuración, o usa el editor de configuración del panel.
Capturar una dependencia del flujo de trabajo
Estos ejemplos muestran argumentos de la herramienta knowledge orientados al modelo. No son subcomandos de la CLI.
Captura el flujo de trabajo:
{
acción: capture,
"node_type": "pattern",
title: Flujo de comprobación de publicación,
"contenido": Verifica las notas de la versión, las evidencias de validación, la cobertura del changelog y las notas de reversión antes de la aprobación del lanzamiento.,
"tags": [skill, "release"]
}
Captura la capacidad que utiliza:
{
acción: capture,
"node_type": tecnología,
title: Capacidad de validación de documentación,
"contenido": "Ejecuta la validación de calidad de la documentación y de enlaces cambiados para cambios en el código fuente de mdBook.",
"tags": [capacidad, docs]
}
Relaciona el flujo de trabajo con la capacidad:
{
acción: relate,
"from_id": "<release-check-workflow-node-id>",
"to_id": "<docs-validation-capability-node-id>",
"relation": uses
}
Captura el rol de steward y relaciónalo con el flujo de trabajo:
{
acción: capture,
"node_type": "expert",
title: "rol de release-steward",
"contenido": "Rol que mantiene las comprobaciones de preparación para la publicación y decide cuándo la evidencia es suficiente.",
"tags": ["role", "release"]
}
{
acción: relate,
"from_id": "<release-check-workflow-node-id>",
"to_id": "<release-steward-role-node-id>",
"relation": "authored_by"
}
Luego inspecciona el flujo de trabajo:
{
acción: graph_neighbors,
"node_id": "<release-check-workflow-node-id>",
limit: 10
}
Relaciones del proyecto
El mismo patrón de habilidad puede cubrir relaciones de proyecto o de cliente, pero mantenlo como una extensión explícita. Añade orientación sobre nodos client, contact e interaction solo cuando el operador quiera realizar seguimiento de relaciones de proyecto y tenga una política de privacidad para esos datos. La página de memoria de relaciones muestra las acciones client_network y interaction_log para esa forma.
Validar la habilidad instalada
Audita el directorio de habilidades después de guardarlo. Con la raíz de instalación predeterminada, la habilidad del bundle generada vive en ~/.zeroclaw/shared/skills/<bundle>/<skill>/:
sh
zeroclaw skills audit ~/.zeroclaw/shared/skills/relationship-memory/relationship-memory-capture
Si la raíz de instalación no es ~/.zeroclaw, audita la ruta impresa por zeroclaw skills add.
skills audit comprueba la forma del paquete de habilidades. No demuestra que tu implementación tenga habilitada la herramienta knowledge ni que el grafo contenga datos útiles. Para eso, ejecuta una pequeña sesión manual con datos de marcador de posición y confirma que el agente puede llamar a capture, relate y graph_neighbors para un par flujo de trabajo/capacidad. Si amplías la plantilla para proyectos, confirma también que client_network e interaction_log devuelven las entradas de marcador de posición esperadas.