AgentSkillsCN

ask-user-questions

通过交互式 TUI 向用户提出澄清性问题。适用于需要用户就偏好、实施方案或模糊指令提供反馈时使用。

SKILL.md
--- frontmatter
name: ask-user-questions
description: Ask clarifying questions to users via interactive TUI. Use when you need user input on preferences, implementation choices, or ambiguous instructions.
license: MIT
metadata:
  author: paulp-o
  version: "2.0.1"

Ask User Questions

Use this tool when you need to ask the user questions during execution. This allows you to:

Gather user preferences or requirements Clarify ambiguous instructions Get decisions on implementation choices as you work Offer choices to the user about what direction to take. Usage notes:

Users will always be able to select "Other" to provide custom text input Use multiSelect: true to allow multiple answers to be selected for a question Recommend an option unless absolutely necessary, make it the first option in the list and add "(Recommended)" at the end of the label For multiSelect questions, you MAY mark multiple options as "(Recommended)" if several choices are advisable Do NOT use this tool to ask "Is my plan ready?" or "Should I proceed?"

Usage

bash
# Ask questions via CLI
npx auq ask '{"questions": [...]}'

# Or pipe JSON input
echo '{"questions": [...]}' | npx auq ask

Parameters

json
{
  "questions": [
    {
      "prompt": "Which authentication method would you like to use?",
      "title": "Auth",
      "options": [
        {"label": "JWT (Recommended)", "description": "Stateless, scalable"},
        {"label": "Session cookies", "description": "Traditional, server-side"}
      ],
      "multiSelect": false
    }
  ]
}
FieldTypeRequiredDescription
questionsarrayYes1-5 question objects
questions[].promptstringYesFull question text
questions[].titlestringYesShort label (max 12 chars)
questions[].optionsarrayYes2-5 options with label and optional description
questions[].multiSelectbooleanYesAllow multiple selections