perform-task

Implements, reviews, tests, and publishes one queued Telegram Desktop AI task end to end.

32.8k|7.2k|Updated May 2, 2014
One-click install
npx skills add https://github.com/telegramdesktop/tdesktop --skill perform-task
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perform-task
Source: https://github.com/telegramdesktop/tdesktop/tree/main/.agents/skills/perform-task
Command: npx skills add https://github.com/telegramdesktop/tdesktop --skill perform-task

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It automates the full lifecycle of a single queued engineering task in the Telegram Desktop C++ codebase, from task resolution and planning through implementation, multi-lens code review, evidence-based testing, and canonical commit publication, removing the manual coordination of these phases.

Core Features & Use Cases

  • Single-task ownership: Resolves one task by slug or full id, claims it atomically, resumes interrupted or blocked work, and never processes other queue items.
  • Adaptive review pipeline: Runs a mandatory general review plus five standard lenses (lifetime, reuse, structure, performance, security) with fast NOT_APPLICABLE bailouts and bounded convergence assessment.
  • Falsifiable evidence loop: Designs and executes test campaigns using static checks, unit tests, Debug Telegram builds, in-app overlays, Computer Use, and screenshots with explicit oracles, controls, and falsifiers.
  • Use Case: A maintainer invokes $perform-task with a task slug; the skill plans the change, implements it in the Telegram Desktop source, reviews the diff, proves behavior with runtime evidence, and publishes a canonical Approve commit.

Quick Start

Ask the assistant to run $perform-task with the short slug or full dated id of an existing ai-tdesktop task you want implemented and published.

Frequently Asked Questions about perform-task

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run perform-task on a Telegram Desktop task?

Invoke $perform-task or /perform-task with the task's short slug or full dated id. The skill resolves it via workspace.py, claims it atomically, and runs the full pipeline from planning through canonical Approve publication.

What review process does perform-task apply to code changes?

It runs one mandatory general review over every changed file plus five standard lenses: lifetime, reuse, structure, performance, and security. Each lens can bail out with a proven NOT_APPLICABLE, and fixes trigger only focused re-reviews of invalidated approvals.

Can perform-task resume an interrupted or blocked task?

Yes. An in-progress task owned by the same checkout resumes from its first incomplete validated boundary using local phase artifacts. A blocked task owned by this checkout can be reopened with the retry command, preserving all prior plans, reviews, and evidence.

How does perform-task test Telegram Desktop UI changes?

It designs an evidence plan with explicit oracles, controls, and falsifiers, then uses Debug Telegram builds, in-app overlays, log assertions, screenshots, and optionally Computer Use for physical input paths. Locked macOS sessions fall back to overlay-only driving.

What happens when a task is too large for one review?

The assessment phase can declare Scope: split-required with a concrete split proposal before source edits, or convergence assessment can reach the same result later. The performer publishes the split-required result and the scheduler owns queue mutation.

When does perform-task stop instead of completing a task?

It stops when another task is in-progress for the checkout, dependencies are unfinished, the task is owned by another checkout, or a hard stop like a semantic conflict or unreachable remote occurs. Genuine exhausted blockers produce a canonical Block commit.