Utiliser la mémoire des relations depuis Skills
Utilisez ce modèle lorsque vous souhaitez qu’une skill indique à un agent quand et comment capturer les relations de workflow, de capacité et de rôle de steward avec l’outil knowledge. Il conserve le graphe comme un workflow orienté opérateur, et non seulement comme une capacité interne.
Créez un bundle pour les compétences de mémoire relationnelle, puis générez le squelette de la compétence :
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
La commande skills add ouvre SKILL.md dans votre éditeur. Remplacez le contenu du fichier généré par ce modèle :
---
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.
Pour rendre le skill disponible à un agent, attachez le bundle relationship-memory à cet agent. Par exemple, ajoutez l’alias du bundle à agents.<alias>.skill_bundles dans la configuration, ou utilisez l’éditeur de configuration du tableau de bord.
Capturer une dépendance de workflow
Ces exemples montrent les arguments d’outil knowledge orientés modèle. Ce ne sont pas des sous-commandes CLI.
Capturer le flux de travail :
{
action: capture,
"node_type": motif,
"title": Workflow de vérification de release,
"contenu": Vérifie les notes de version, les preuves de validation, la couverture du journal des modifications et les notes de retour arrière avant la validation de la version.,
étiquettes: [compétence, version]
}
Capturer la fonctionnalité qu’il utilise :
{
action: capture,
"node_type": technologie,
"title": Capacité de validation de la documentation,
"contenu": Exécute le contrôle de la qualité de la documentation et la validation des liens modifiés pour les modifications du code source mdBook.,
étiquettes: [capacité, docs]
}
Relier le workflow à la capacité :
{
action: relate,
from_id: "<release-check-workflow-node-id>",
to_id: "<docs-validation-capability-node-id>",
relation: utilise
}
Enregistrer le rôle de steward et l’associer au flux de travail :
{
action: capture,
"node_type": expert,
"title": rôle de responsable de version,
"contenu": Rôle qui maintient les vérifications de disponibilité de la version et décide quand les preuves sont suffisantes.,
étiquettes: [rôle, version]
}
{
action: relate,
from_id: "<release-check-workflow-node-id>",
to_id: "<release-steward-role-node-id>",
relation: authored_by
}
Ensuite, inspectez le workflow :
{
action: graph_neighbors,
node_id: "<release-check-workflow-node-id>",
limite: 10
}
Relations de projet
Le même modèle de compétence peut couvrir les relations de projet ou de client, mais conservez cela comme une extension explicite. Ajoutez les conseils pour les nœuds client, contact et interaction uniquement lorsque l’opérateur souhaite le suivi des relations de projet et dispose d’une politique de confidentialité pour ces données. La page mémoire de relation montre les actions client_network et interaction_log pour cette forme.
Valider le skill installé
Vérifiez le répertoire du skill après son enregistrement. Avec la racine d’installation par défaut, le skill du bundle généré se trouve sous ~/.zeroclaw/shared/skills/<bundle>/<skill>/:
sh
zeroclaw skills audit ~/.zeroclaw/shared/skills/relationship-memory/relationship-memory-capture
Si votre répertoire d’installation n’est pas ~/.zeroclaw, vérifiez le chemin affiché par zeroclaw skills add.
skills audit vérifie la structure du package de skill. Cela ne prouve pas que votre déploiement a l’outil knowledge activé ou que le graphe contient des données utiles. Pour cela, exécutez une petite session manuelle avec des données de substitution et confirmez que l’agent peut appeler capture, relate et graph_neighbors pour une paire workflow/capability. Si vous étendez le modèle pour les projets, confirmez également que client_network et interaction_log renvoient les entrées de substitution attendues.