Add Command

Stap-voor-stap checklist voor het toevoegen van een nieuw commando aan de Doist todoist-cli codebase

Door Doist · Doist/todoist-cli

Getest · Werkt ★ 8.0/10

Add Command — Stap-voor-stap checklist voor het toevoegen van een nieuw commando aan de Doist todoist-cli codebase

Wat het doet

Een repository-specifieke checklist voor het toevoegen van nieuwe CLI-commando's of subcommando's aan het Doist todoist-cli TypeScript project. Het somt elk cross-cutting bestand op dat moet worden aangeraakt — mock API, spinner messages, de read-only permission allowlist, error codes, tests, en het gegenereerde skill-bestand — en activeert bij het implementeren van een nieuw SDK endpoint of het uitbreiden van de CLI. Is alleen van toepassing binnen een kloon van Doist/todoist-cli, niet op algemene CLI-ontwikkeling of Todoist-gebruik.

Testrapport

De echte SKILL.md opgehaald van .agents/skills/add-command/ (de .claude kopie is een pointer stub). Gerefereerde bestanden steekproefsgewijs gecontroleerd via raw fetch: errors.ts, permissions.ts, skills/content.ts, output.ts, api/core.ts allemaal HTTP 200, maar stap 1's src/__tests__/helpers/mock-api.ts is 404 (echt pad is src/test-support/mock-api.ts) en de src/__tests__/ test dir bestaat niet — tests zijn gecollokeerd (bijv. src/commands/add.test.ts). In een kloon verifieerde ik dat permissions.ts onbekende methoden standaard weigert (regel 92) en dat sync:skill / check:skill-sync echte npm scripts zijn. Voor OUTPUT schreef ik twee patch-artefacten voor het toevoegen van een `td label count` subcommand: baseline raakt 3 bestanden aan; skill-gevolgd raakt 8 bestanden aan plus `npm run sync:skill` — de extra permissions.ts allowlist entry voorkomt dat het read-only commando ten onrechte wordt geblokkeerd onder een read-only OAuth token, en de sync stap voorkomt dat CI check:skill-sync de PR laat falen. Trigger 5/5 beoordeeld (laadt voor "add a td subcommand"/"new SDK endpoint", negeert correct "add a task to my Todoist" en "write a React component").

Getest op: 2026-07-31 · Claude Code 2.x (agent harness)

Installatie

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.

Commando's en voorbeeldprompts

  • /add-commandStap-voor-stap checklist voor het toevoegen van een nieuw commando aan de Doist todoist-cli codebase

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

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