Add Command

Lista de verificación paso a paso para añadir un nuevo comando a la base de código de Doist todoist-cli

Por Doist · Doist/todoist-cli

Probado · Funciona ★ 8.0/10

Add Command — Lista de verificación paso a paso para añadir un nuevo comando a la base de código de Doist todoist-cli

Qué hace

Una lista de verificación específica del repositorio para añadir nuevos comandos o subcomandos CLI al proyecto TypeScript Doist todoist-cli. Enumera cada archivo transversal a modificar — mock API, spinner messages, la lista de permisos de solo lectura, error codes, tests y el archivo de habilidad generado — y se activa al implementar un nuevo SDK endpoint o extender la CLI. Se aplica solo dentro de un clon de Doist/todoist-cli, no al desarrollo general de CLI o al uso de Todoist.

Informe de la prueba

Se obtuvo el SKILL.md real de .agents/skills/add-command/ (la copia .claude es un stub de puntero). Se verificaron los archivos referenciados mediante raw fetch: errors.ts, permissions.ts, skills/content.ts, output.ts, api/core.ts, todos HTTP 200, pero src/__tests__/helpers/mock-api.ts del paso 1 es 404 (la ruta real es src/test-support/mock-api.ts) y el directorio de prueba src/__tests__/ no existe — las pruebas están co-ubicadas (ej. src/commands/add.test.ts). En un clon, verifiqué que permissions.ts deniega por defecto métodos desconocidos (línea 92) y que sync:skill / check:skill-sync son scripts npm reales. Para la salida, escribí dos artefactos de parche para añadir un subcomando `td label count`: la línea base toca 3 archivos; la habilidad seguida toca 8 archivos más `npm run sync:skill` — la entrada adicional en la lista de permisos de permissions.ts evita que el comando de solo lectura sea bloqueado erróneamente bajo un token OAuth de solo lectura, y el paso de sincronización evita que CI check:skill-sync falle el PR. El disparador se juzgó 5/5 (carga para "add a td subcommand"/"new SDK endpoint", ignora correctamente "add a task to my Todoist" y "write a React component").

Probado el: 2026-07-31 · Claude Code 2.x (agent harness)

Instalación

git clone --depth 1 https://github.com/Doist/todoist-cli.git /tmp/add-command-src
mkdir -p ~/.claude/skills
cp -R /tmp/add-command-src/.agents/skills/add-command ~/.claude/skills/add-command
# The full guide lives at .agents/skills/add-command/SKILL.md; the .claude/skills copy is only a pointer stub.
# Repo-specific: only useful while working inside a clone of Doist/todoist-cli. No external deps or API keys.

Comandos y prompts de ejemplo

  • /add-commandLista de verificación paso a paso para añadir un nuevo comando a la base de código de Doist todoist-cli

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • Add a new subcommand to todoist-cli
  • Implement this SDK endpoint as a CLI command
  • Extend the label command group with a new option