@quick-start-soft/quick-task-refine

Quick Task Refine

A CLI tool that refines task specifications through iterative Q&A with AI (OpenAI or Google Gemini).

Purpose

This tool helps improve task definitions by:

• Providing richer context and information for task performers
• Aligning expectations between task requesters and performers
• Ensuring clearer requirements and success criteria

Installation

npm install -g @quick-start-soft/quick-task-refine

Usage

# Refine a task specification file (uses OpenAI by default)
quick-task-refine canvas <source_file_path>

# Use OpenAI (default)
quick-task-refine canvas task.txt
quick-task-refine canvas --ai-provider openai task.txt

# Use Google Gemini
quick-task-refine canvas --ai-provider google task.txt

# Examples with different file formats
quick-task-refine canvas requirements.md
quick-task-refine canvas spec.yaml

Supported File Formats

• .txt
• .md
• .yaml
• .yml

Environment Variables

# For OpenAI (default provider)
export QUICK_START_SOFT_OPENAI_API_KEY=your_openai_api_key_here

# For Google Gemini
export QUICK_START_SOFT_GEMINI_API_KEY=your_gemini_api_key_here

How It Works

• Read Task Spec: The tool reads your task specification file
• Generate Questions: AI analyzes the spec and generates 3 important questions to improve clarity
• User Input: For each question, you select from 8 suggested answers or provide custom input
• Refine Spec: The AI refines the task spec based on all your answers
• Update File: The refined spec is saved back to the original file in YAML format
• Repeat: The process continues until you exit (Ctrl+C)

Example Session

$ quick-task-refine canvas task.txt

ℹ Starting task refinement for: task.txt
ℹ Press Ctrl+C to exit at any time

Task Refinement

ℹ File: task.txt
ℹ Analyzing task specification...
ℹ 질문에 답변해주세요. (총 3개)

질문 1/3
? What are the specific user roles and permissions needed for the authentication system?
  1. Basic users only with standard login/logout
  2. Multiple roles: admin, user, guest with different access levels
  3. Role-based with customizable permissions per feature
  4. Simple two-tier: regular users and administrators
  5. OAuth integration with social media roles
  6. Enterprise-level with department-based permissions
  7. Dynamic roles that can be created/modified by admins
  8. Hierarchical roles with inheritance
  9. 직접입력

질문 2/3
? What security measures should be implemented for password storage and authentication?
  1. Basic hashing with salt
  2. bcrypt with configurable rounds
  3. Argon2 with recommended parameters
  4. PBKDF2 with SHA-256
  5. Multi-factor authentication support
  6. Biometric authentication options
  7. Hardware token support
  8. Password complexity requirements and rotation policies
  9. 직접입력

질문 3/3
? How should the password reset process work?
  1. Email link with temporary token
  2. Security questions verification
  3. SMS OTP verification
  4. Admin-initiated reset only
  5. Magic link authentication
  6. Time-limited reset codes
  7. Multi-channel verification (email + SMS)
  8. Account recovery through trusted contacts
  9. 직접입력

✓ Task specification updated successfully!

Features

• Interactive Q&A refinement process
• AI-powered generation of 3 questions per cycle
• Support for multiple AI providers (OpenAI with o3 model, Google Gemini)
• Provider selection via command-line option
• 8 answer choices per question + custom input option
• Preserves and enhances original task content
• Outputs refined specs in YAML format
• Continuous refinement loop
• Graceful exit handling

Development

# Install dependencies
npm install

# Build
npm run build

# Link for local testing
npm run dev:install