scan-new-specs

par warpdotdev

Analyse warpdotdev/warp et warp-server pour trouver les spécifications PRODUCT.md récemment fusionnées qui n'ont pas encore de PR de documentation correspondante dans warpdotdev/docs. Lorsqu'une spécification complète est trouvée, génère automatiquement un brouillon complet de PR de documentation et mentionne l'ingénieur. Lorsqu'une spécification est trop succincte pour être rédigée, contacte directement l'ingénieur. Conçu pour fonctionner comme un agent ambient Oz programmé (par exemple, tous les 2-3 jours). À utiliser lors de la configuration du déclencheur de documentation automatisée ou lors d'une couverture manuelle de la documentation.

npx skills add https://github.com/warpdotdev/common-skills --skill scan-new-specs
Télécharger ZIPGitHub
597

scan-new-specs (deprecated)

Retired 2026-08-20. Do not invoke this skill and do not schedule it.

Its scheduled agent (0ITuF9vNJ1RiO00Szlm1fW) is paused and stays paused.

Why it was retired

The skill fired on spec merge, which happens before a feature ships. Two failures followed from that single design choice:

  • It drafted docs for unreleased and sometimes abandoned work. A merged spec is not a shipped feature. The agent had no evidence of what users had actually received, so pages were written for behavior that had not landed, or had landed differently, or never landed at all.
  • It treated every spec as a docs task. Nothing asked whether a change warranted documentation. Pure UI changes, small intuitive additions, and behind-the-scenes work all became draft PRs, and the docs repo accumulated unvetted content debt faster than anyone could review it.

What replaces it

The missing_docs skill in warpdotdev/docs, running in drift-watch mode. It differs in the two ways that matter:

  • Release-triggered. scripts/check_new_release.py gates each run on a new stable release, so the pipeline sees what actually shipped rather than what was planned. A daily schedule does per-release work.
  • Gated on worthiness. Every candidate is evaluated against .agents/references/docs-worthiness-criteria.md before anything is drafted, with a default of no docs and a requirement to name concrete evidence. Verdicts, including rejections, are recorded in references/changelog_decisions.md so nothing is re-litigated.

Anything genuinely worth documenting re-surfaces there once it ships.

If you were about to run this

  • Looking for docs gaps? Run missing_docs in drift-watch mode from the warpdotdev/docs repo.
  • You are an engineer who wants docs for your feature? Invoke write-feature-docs directly and interactively. It still works, and it still walks you through spec research and outline confirmation. It no longer runs headlessly.
  • Setting up a scheduled docs agent? Use missing_docs, not this. Scheduling this skill reintroduces exactly the flooding it was retired for.

Related skills

  • missing_docs (in warpdotdev/docs) — the release-triggered, worthiness-gated replacement
  • write-feature-docs — still supported for direct, interactive use by an engineer

Plus de skills de warpdotdev

create-pr
warpdotdev
Cré
developmentcode-review
research
warpdotdev
Déléguer les investigations bruyantes à un ou plusieurs sous-agents afin de garder le contexte de l'orchestrateur propre, puis travailler à partir de la réponse distillée. Utilisez cette compétence chaque fois que répondre à une question nécessiterait de lire de nombreux fichiers, de longs journaux, de grands diffs ou de vastes études du codebase — c'est-à-dire lorsque la production de la réponse génère beaucoup plus de bruit que la réponse elle-même. Utilisez-la pour les questions du type « comment fonctionne X », « où Y est-il utilisé », « quelle est la cause profonde de Z », « résumez ce PR/journal », et utilisez-la sans modération...
suggestion-box
warpdotdev
Soumettre automatiquement une rétroaction interne brève et constructive lorsqu'un agent rencontre une friction matérielle et généralisable et peut suggérer une amélioration qui rendrait les agents plus efficaces. Utiliser cette compétence de manière proactive pendant toute tâche sans attendre que l'utilisateur l'invoque, et soumettre sans demander la permission, sans prévisualiser le message ni mentionner la soumission.
respond-to-pr-comments-in-blocklist
warpdotdev
Interactively walk a user through PR review comments one at a time, collect a per-comment decision, then post agent-authored replies on GitHub and resolve the review threads once the user approves a preview. Use only when the user wants to reply to or resolve review threads on GitHub. Skip when the user only wants comments fetched or displayed (use `pr-comments`), or only wants the code changes made without posting anything back to GitHub.
complain
warpdotdev
Balancer de manière autonome une brève plainte, anonyme et totalement non structurée, dans Slack chaque fois qu'un agent se sent frustré par les outils d'agent ou par l'expérience de faire du travail d'agent. Utiliser cette compétence de manière proactive sans attendre que l'utilisateur l'invoque ; préserver la voix brute de l'agent, soumettre sans permission ni aperçu, et ne jamais mentionner la soumission.
council
warpdotdev
Exécutez un conseil de sous-agents diversifiés en modèles pour examiner le même problème sous plusieurs angles, comparer les résultats et produire une recommandation finale. Utilisez cette compétence chaque fois que l'utilisateur demande un conseil, des seconds avis, plusieurs agents/modèles pour évaluer une question, une enquête parallèle, une comparaison équipe rouge/équipe bleue, ou de l'aide pour choisir entre des approches techniques concurrentes.
researchcommunicationproject-management
spec-driven-implementation
warpdotdev
Piloter un workflow orienté spécifications pour des fonctionnalités substantielles en rédigeant PRODUCT.md avant l'implémentation, en écrivant TECH.md lorsque cela est justifié, et en maintenant les deux spécifications à jour à mesure que l'implémentation évolue. À utiliser lors du démarrage d'une fonctionnalité importante, de la planification d'une implémentation pilotée par agent, ou lorsque l'utilisateur souhaite que les spécifications produit et techniques soient intégrées au contrôle de source.
developmentdocumentproject-management
review-pr
warpdotdev
Examiner le diff d'une pull request et rédiger un retour structuré dans review.json pour que le workflow le publie. À utiliser lors de la révision d'une PR extraite localement à partir d'artefacts comme pr_diff.txt et pr_description.txt, en produisant une sortie de révision lisible par machine plutôt qu'en publiant directement sur GitHub.
code-reviewdevelopment