Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Add an AGENTS.md rule for pacing bulk GitHub writes (secondary rate limit)

Abierto Apto para principiantes
  • ¿Algo no está bien?
#5,133 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
76/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
github, typescript
Área
devtools

Línea de trabajo

Empieza con AGENTS.md y localiza las indicaciones sobre el trabajo impulsado por issues y el trabajo de larga duración. Después, lee el paso Close de docs/contribution-model.md y las recetas de los skills issue-triage y board-ops para realizar escrituras masivas en GitHub. Añade la regla proporcionada a AGENTS.md y enlázala desde la guía de contribución y desde cualquier skill afectado, sin repetir las cifras. El trabajo estará terminado cuando esas referencias apunten a la única regla y, si se modificó algún skill, npm run verify:skills pase.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

documentation v2

Problem

Nothing in AGENTS.md governs how fast an agent may write to GitHub. The only pacing guidance is in docs/contribution-model.md (closing outside PRs: "a pause of a few seconds between them, in batches"). That is a design document, not loaded every session, and it gives no numbers.

Several flows in this repo make bulk writes, and agents run them:

  • the backlog triage (#4875, #4876, #4877): closing PRs with canned comments, boarding and labelling issues
  • board audits and recoveries (board-ops)
  • Copilot review loops (pr-flow): many thread replies per round

GitHub's secondary rate limit refuses those writes even while gh api rate_limit still shows primary quota. Most gh writes go through GraphQL, which has its own limits on top. A refused create is also not reliably a no-op: the object can still have been created, so a blind retry duplicates it.

Change

Add this rule to AGENTS.md, worded as given:

Pace bulk GitHub writes: 1 s between requests, never in parallel, under 80 a minute and 500 an hour. The secondary limit refuses while gh api rate_limit still shows quota, and most gh writes are GraphQL. After a refusal, wait out retry-after, or a minute without one; a refused create can still land, so look before retrying.

  • The rule belongs in AGENTS.md (where a rule that must not drop out of context lives), probably under Issue-driven work style or next to Waiting on long-running work, which already sets the 30 s polling floor for remote APIs.
  • docs/contribution-model.md's "Close" step should then link to the rule instead of stating its own pacing, so there is one copy.
  • Any skill recipe that loops over GitHub writes (issue-triage, board-ops) should follow it and point to it rather than restating the numbers.

Done when

  • AGENTS.md carries the rule as above.
  • docs/contribution-model.md and any skill that does bulk writes link to it, with no second copy of the numbers.
  • npm run verify:skills passes if a skill changed.
Lenguaje dominante
JavaScript
Estrellas
91.2k
Forks
11.8k
Merge medio
6 h 52 min
PR fusionados (30 d)
107

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de modelcontextprotocol/servers

Todos los issues de modelcontextprotocol/servers

Issues similares

Más issues de JavaScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.