القائمة
[Bot developer] Implements WizardStep for wizard flows. Use when adding a step to a wizard, implementing validation, state storage, or transitions in the telegram-bot library.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
Adds a new collector to the ktnip KSP processor. Use when implementing a new handler type (e.g. new annotation like @MyHandler), adding a collector for a new activity pattern, or extending the ktnip processor to collect additional annotated functions.
Adds tests for the ktnip KSP processor. Use when adding tests for a new collector, testing processor behavior with new annotations, or verifying KSP code generation for the telegram-bot library.
[Library contributor] Adds a new collector to the ktnip KSP processor. Use when implementing a new handler type (e.g. new annotation like @MyHandler), adding a collector for a new activity pattern, or extending the ktnip processor to collect additional annotated functions.
[Library contributor] Adds tests for the ktnip KSP processor. Use when adding tests for a new collector, testing processor behavior with new annotations, or verifying KSP code generation for the telegram-bot library.
Adds a new parameter resolution strategy to the ktnip KSP processor. Use when handler functions need to receive a new parameter type (e.g. ChatMember, InlineQuery), or when adding support for a new resolvable type in Activity invocation.
Adds a new Telegram Bot API method (action class and top-level functions). Use when implementing a new Telegram API endpoint, adding support for a specific method (e.g. sendVideoNote, getChatMemberCount), or creating a new action for the telegram-bot library.
استنادا إلى تصنيف SOC المهني
| name | add-wizard-step |
| description | [Bot developer] Implements WizardStep for wizard flows. Use when adding a step to a wizard, implementing validation, state storage, or transitions in the telegram-bot library. |
Extend WizardStep. Override onEntry (required) and optionally validate, store, onRetry.
object NameStep : WizardStep(isInitial = true) {
override suspend fun onEntry(ctx: WizardContext) {
message("What's your name?").send(ctx.user, ctx.bot)
}
override suspend fun validate(ctx: WizardContext): Transition {
val text = (ctx.update as? MessageUpdate)?.message?.text ?: return Transition.Retry()
return if (text.isNotBlank()) Transition.Next else Transition.Retry("Invalid")
}
override suspend fun store(ctx: WizardContext): String? =
(ctx.update as? MessageUpdate)?.message?.text
}
| Method | Required | Purpose |
|---|---|---|
onEntry(ctx) | Yes | Called when entering step. Send prompts, set keyboards. |
validate(ctx) | No | Return Transition based on input. Default: Transition.Next |
store(ctx) | No | Return value to persist. Type must match a state manager. Default: null |
onRetry(ctx, reason) | No | Called when validation returns Transition.Retry. Default: no-op |
| Transition | Effect |
|---|---|
Transition.Next | Move to next step in sequence |
Transition.JumpTo(Step::class) | Jump to specific step |
Transition.Retry() or Transition.Retry("reason") | Stay on step; onRetry is called |
Transition.Finish | End wizard |
ctx.user, ctx.update, ctx.botctx.getState(Step::class), ctx.setState(Step::class, value), ctx.delState(Step::class) — KSP generates type-safe accessors per stepOverride id if needed: override val id: String = "custom_id". Default: fully qualified class name.
Set isInitial = true on exactly one step. That step runs when the wizard starts.