Kiro高级应用技巧、技术原理与学习路径指南

// 自定义Spec模板示例 (.kiro/templates/custom-web-app.json)
{
  "name": "Web应用开发Spec模板",
  "description": "适用于Web应用开发的Spec模板",
  "version": "1.0.0",
  "sections": [
    {
      "id": "overview",
      "name": "项目概述",
      "required": true,
      "fields": [
        {
          "id": "project_name",
          "name": "项目名称",
          "type": "string",
          "required": true
        },
        {
          "id": "project_description",
          "name": "项目描述",
          "type": "text",
          "required": true
        },
        {
          "id": "tech_stack",
          "name": "技术栈",
          "type": "multiselect",
          "options": ["React", "Vue", "Angular", "Node.js", "Express", "MongoDB", "MySQL"],
          "required": true
        }
      ]
    },
    {
      "id": "requirements",
      "name": "需求分析",
      "required": true,
      "fields": [
        {
          "id": "functional_requirements",
          "name": "功能需求",
          "type": "list",
          "required": true
        },
        {
          "id": "non_functional_requirements",
          "name": "非功能需求",
          "type": "list",
          "required": false
        }
      ]
    },
    {
      "id": "architecture",
      "name": "系统架构",
      "required": true,
      "fields": [
        {
          "id": "system_diagram",
          "name": "系统架构图",
          "type": "image",
          "required": true
        },
        {
          "id": "component_description",
          "name": "组件描述",
          "type": "text",
          "required": true
        }
      ]
    },
    {
      "id": "api_design",
      "name": "API设计",
      "required": true,
      "fields": [
        {
          "id": "api_endpoints",
          "name": "API端点",
          "type": "table",
          "columns": ["URL", "Method", "Description", "Parameters", "Response"],
          "required": true
        }
      ]
    },
    {
      "id": "data_model",
      "name": "数据模型",
      "required": true,
      "fields": [
        {
          "id": "database_schema",
          "name": "数据库 schema",
          "type": "text",
          "required": true
        },
        {
          "id": "entity_relationship",
          "name": "实体关系图",
          "type": "image",
          "required": false
        }
      ]
    }
  ]
}

// 在Spec中使用变量和条件逻辑
{
  "project_type": "web",
  "framework": "React",
  "database": "MongoDB",
  "features": {
    "authentication": true,
    "authorization": true,
    "file_upload": false
  },
  "code_generation": {
    "generate_tests": true,
    "generate_documentation": true
  },
  "conditions": [
    {
      "if": "${project_type} === 'web' && ${framework} === 'React'",
      "then": {
        "template": "react-web-app",
        "dependencies": ["react", "react-dom", "react-router-dom", "axios"]
      }
    },
    {
      "if": "${database} === 'MongoDB'",
      "then": {
        "dependencies": ["mongoose"],
        "configuration": {
          "database": "mongodb"
        }
      }
    },
    {
      "if": "${features.authentication} === true",
      "then": {
        "components": ["Login", "Register", "ForgotPassword"],
        "services": ["AuthService"]
      }
    }
  ]
}

// 自定义post-code-generation Hook (.kiro/hooks/post-code-generation.js)
module.exports = async function(context) {
  // 获取生成的代码文件
  const generatedFiles = context.generatedFiles;
  // 获取当前项目信息
  const projectInfo = context.projectInfo;
  
  console.log(`Post-processing ${generatedFiles.length} generated files for project ${projectInfo.name}`);
  
  // 对生成的代码进行自定义修改
  for (const file of generatedFiles) {
    // 只处理JavaScript和TypeScript文件
    if (file.path.endsWith('.js') || file.path.endsWith('.ts') || file.path.endsWith('.jsx') || file.path.endsWith('.tsx')) {
      let content = file.content;
      
      // 添加自定义的代码注释和版权信息
      const copyrightHeader = `/**
 * ${projectInfo.name}
 * ${projectInfo.description}
 * Copyright (c) ${new Date().getFullYear()} ${projectInfo.author}
 * All rights reserved.
 */\n\n`;
      
      // 检查文件是否已经包含版权信息
      if (!content.startsWith('/**')) {
        content = copyrightHeader + content;
      }
      
      // 添加ESLint disable注释（如果需要）
      if (content.includes('console.log') && !content.includes('eslint-disable')) {
        const lines = content.split('\n');
        for (let i = 0; i < lines.length; i++) {
          if (lines[i].includes('console.log')) {
            lines[i] = lines[i] + ' // eslint-disable-line no-console';
          }
        }
        content = lines.join('\n');
      }
      
      // 更新文件内容
      file.content = content;
    }
  }
  
  // 返回修改后的文件
  return generatedFiles;
};