Hi-AI

Instructions

Implementation Reference

• src/tools/thinking/stepByStepAnalysis.ts:27-68 (handler)

  The core handler function that executes the step-by-step analysis tool logic. It generates a structured breakdown of the task into steps with actions, checkpoints, and estimates based on the detail level.

  export async function stepByStepAnalysis(args: { task: string; context?: string; detailLevel?: string }): Promise<ToolResult> {
    const { task, context = '', detailLevel = 'detailed' } = args;
    
    const stepCount = detailLevel === 'basic' ? 3 : detailLevel === 'detailed' ? 5 : 7;
    const stepAnalysis = {
      action: 'step_by_step_analysis',
      task,
      context,
      detailLevel,
      steps: Array.from({ length: stepCount }, (_, i) => {
        const stepNum = i + 1;
        return {
          stepNumber: stepNum,
          title: `Step ${stepNum}: ${task} - Phase ${stepNum}`,
          description: `Detailed analysis of ${task} in step ${stepNum}`,
          actions: [
            `Analyze requirements for step ${stepNum}`,
            `Identify dependencies and prerequisites`,
            `Execute the planned actions`,
            `Validate results and check for issues`,
            `Prepare for next step`
          ],
          checkpoints: [
            `Verify step ${stepNum} requirements are met`,
            `Confirm outputs are as expected`,
            `Check for any blocking issues`
          ],
          estimatedTime: detailLevel === 'comprehensive' ? `${stepNum * 10} minutes` : `${stepNum * 5} minutes`
        };
      }),
      summary: {
        totalSteps: stepCount,
        estimatedTotalTime: detailLevel === 'comprehensive' ? `${stepCount * 35} minutes` : `${stepCount * 20} minutes`,
        complexity: detailLevel === 'basic' ? 'low' : detailLevel === 'detailed' ? 'medium' : 'high'
      },
      status: 'success'
    };
    
    return {
      content: [{ type: 'text', text: `Task: ${task}\nDetail: ${detailLevel}\nSteps: ${stepCount}\n\n${stepAnalysis.steps.map(s => `Step ${s.stepNumber}: ${s.title}\n  Time: ${s.estimatedTime}\n  Actions: ${s.actions.join(', ')}\n  Checkpoints: ${s.checkpoints.join(', ')}`).join('\n\n')}\n\nTotal Time: ${stepAnalysis.summary.estimatedTotalTime} | Complexity: ${stepAnalysis.summary.complexity}` }]
    };
  }

• src/tools/thinking/stepByStepAnalysis.ts:5-25 (schema)

  The ToolDefinition object providing the schema, description, input validation, and annotations for the step_by_step_analysis tool.

  export const stepByStepAnalysisDefinition: ToolDefinition = {
    name: 'step_by_step_analysis',
    description: '단계별|차근차근|하나씩|step by step|one by one|gradually - Perform detailed step-by-step analysis',
    inputSchema: {
      type: 'object',
      properties: {
        task: { type: 'string', description: 'Task to analyze step by step' },
        context: { type: 'string', description: 'Additional context for the task' },
        detailLevel: { type: 'string', description: 'Level of detail', enum: ['basic', 'detailed', 'comprehensive'] }
      },
      required: ['task']
    },
    annotations: {
      title: 'Step-by-Step Analysis',
      audience: ['user', 'assistant'],
      readOnlyHint: true,
      destructiveHint: false,
      idempotentHint: true,
      openWorldHint: false
    }
  };

• src/index.ts:191-194 (registration)

  Registration of the stepByStepAnalysis handler in the toolHandlers object, which is used for dynamic dispatch during tool calls.

  'create_thinking_chain': createThinkingChain,
  'analyze_problem': analyzeProblem,
  'step_by_step_analysis': stepByStepAnalysis,
  'format_as_plan': formatAsPlan,

• src/index.ts:126-129 (registration)

  Inclusion of the stepByStepAnalysisDefinition in the tools array, used by the server to list available tools.

  createThinkingChainDefinition,
  analyzeProblemDefinition,
  stepByStepAnalysisDefinition,
  formatAsPlanDefinition,

• src/index.ts:38-38 (registration)

  Import statement bringing in the tool definition and handler function for use in the main server index.

  import { stepByStepAnalysisDefinition, stepByStepAnalysis } from './tools/thinking/stepByStepAnalysis.js';