WebCull - Documentation - Vue D Ensemble

Vue D Ensemble

Les compétences d'agent donnent à votre agent une base CLI sûre

Le WebCull Agent Skill Set aide les outils d'agent à utiliser la CLI WebCull avec prudence. Installez d'abord webcull-cli pour les consignes partagées de sécurité et de commande, puis ajoutez des compétences de flux ciblées pour les tâches de favoris souhaitées.

Au début d'une tâche WebCull, la compétence de base affiche les comptes connectés. Elle utilise automatiquement le seul compte disponible ou vous demande d'en choisir un dans une liste numérotée, puis inclut le hash de ce compte dans chaque commande authentifiée.

webcull accounts
webcull whoami --account <account-hash>
webcull bookmarks count --account <account-hash> --path /
webcull bookmarks tree --account <account-hash> --path / --max-depth 1 --limit 25 --fields id,type,title,modified
webcull bookmarks search --account <account-hash> --query 'github api' --limit 20 --fields id,title,url,parent_id
webcull bookmarks get --account <account-hash> --ids 123,456 --fields id,title,url,notes --max-metadata-chars 1500

Catalogue

Choisir les compétences selon ce que vous voulez faire

webcull-cli

Compétence de base pour la sélection du compte, la connexion, les limites de sortie, les règles E2EE, les commandes de graphe, les rappels et les écritures soumises à approbation. Installez-la avant les compétences de flux de travail.

webcull-talk-to-bookmarks

Répondre aux questions naturelles à partir des détails de favoris enregistrés, du texte de snapshot si disponible et d'un contexte de page soigneusement sélectionné.

webcull-organize-bookmarks

Inspecter la croissance des dossiers, proposer des catégories extensibles et utiliser des écritures de simulation seulement après approbation.

webcull-graph-relationships

Explique ce qui relie les éléments enregistrés, ce qui pointe ici et comment deux éléments sont liés.

webcull-workflow-analysis

Trouve les outils répétés, zones obsolètes, projets actifs, dossiers encombrés et frictions de favoris.

webcull-recommendations

Déduire les intérêts à partir des favoris et suggérer de prochaines découvertes utiles sans les enregistrer automatiquement.

webcull-learning-path

Transformer un dossier en séquence guidée, de l'orientation à l'étude plus approfondie.

webcull-public-collection-review

Inspecter un dossier avant publication et signaler les problèmes de confidentialité, de clarté, d'ordre ou de présentation.

Détails de la compétence

Détails de la compétence de base

Statut

Version stable

Version CLI requise

@webcull/cli >= 0.1.1

Fichier d'installation

webcull-cli/SKILL.md

Autorisations

Utilise le jeton CLI WebCull autorisé pour l'accès en lecture et en écriture aux favoris. Les actions d'écriture exigent votre demande explicite et utilisent d'abord des essais à blanc.

Journal des modifications

/skills/CHANGELOG.md

Télécharger

/skills/webcull-cli/SKILL.md

Package

Télécharger le bundle de compétences versionné

Le bundle inclut un dossier par compétence, un fichier de version skills.json, un fichier de notes de version CHANGELOG.md et des instructions d'installation pour les outils d'agent.

skills/
  skills.json
  INSTALL.md
  CHANGELOG.md
  README.md
  webcull-cli/SKILL.md
  webcull-talk-to-bookmarks/SKILL.md
  webcull-organize-bookmarks/SKILL.md
  webcull-graph-relationships/SKILL.md
  webcull-workflow-analysis/SKILL.md
  webcull-recommendations/SKILL.md
  webcull-learning-path/SKILL.md
  webcull-public-collection-review/SKILL.md

Mises à jour

Vérifier les mises à jour de compétences par version et changelog

Le fichier skills.json affiche la version actuelle du bundle et les versions des compétences. Le fichier CHANGELOG.md explique ce qui a changé avant de mettre à jour les dossiers de compétences installés. Examinez les changements de version majeure avant de remplacer une copie locale. Les mises à jour mineures et correctives devraient conserver le même flux de base.

Limites de requêtes

Les compétences gardent les requêtes volontairement petites

L'ensemble de compétences indique aux agents d'utiliser --max-chars, --limit, --page, --fields et --max-metadata-chars sur les commandes larges de favoris. Quand les résultats sont trop larges, l'agent réduit d'abord les champs, puis le texte long, puis parcourt les résultats par pages.

L'ensemble de compétences garde les appels séquentiels pour un même compte. Des agents distincts peuvent travailler en même temps sur différents comptes lorsque chaque commande inclut le hash du compte prévu. Les agents régulent aussi les requêtes et limitent la suivante si WebCull leur demande de ralentir.

Écritures

Les écritures exigent votre demande explicite

Les compétences indiquent aux agents d'éviter de créer, mettre à jour, déplacer ou réorganiser des favoris tant que vous ne demandez pas cette écriture. Elles préfèrent aussi --dry-run avant une écriture réelle, préservent les champs non modifiés et envoient le correctif le plus étroit possible.

E2EE

Les phrases secrètes des comptes chiffrés restent locales

Pour les comptes chiffrés, la CLI demande la phrase secrète E2EE uniquement par saisie interactive masquée dans le terminal. Les compétences indiquent aux agents de ne pas placer les phrases secrètes dans les arguments CLI, variables d'environnement, configuration, stdin, journaux, exemples ou requêtes API.