【Kiro】语言支持-Python
Kiro 为 Python 项目提供了强大的 AI 辅助开发能力，帮助您更高效地编写、调试和维护代码。
先决条件
在使用 Kiro 进行 Python 开发之前，请确保您已：
Python ：为您的平台安装最新版本（建议使用 Python 3.8+）
pip：Python 软件包安装程序（Python 附带）
虚拟环境：使用
venv、virtualenv或conda进行依赖管理Git：用于版本控制和协作
扩展
Kiro 支持 Open VSX 的扩展，可以增强你的 Python 开发体验。以下是一些你可以安装的实用扩展：
Python - Python 语言支持，具有用于 IntelliSense（Pylance）、调试（Python 调试器）、linting、格式化、重构、单元测试等的扩展访问点。
PyLint - 对 Python 文件的 Linting 支持。
Jupyter - Jupyter 笔记本支持，支持 Intellisense、调试等的交互式编程和计算。
Python 调试器- Python 调试器 (debugpy) 扩展为 Python 应用程序提供调试功能。
Rainbow CSV - 突出显示 CSV 和 TSV 文件，运行类似 SQL 的查询
您可以在 Kiro 中安装这些扩展，使用扩展面板并搜索上面列出的扩展名称。
与您的环境协作
使用 Kiro，您可以利用聊天功能来设置新项目或处理现有项目。
项目配置和结构
Kiro 可以帮助您设置和维护 Python 项目的配置文件，并按照 Python 最佳实践组织您的项目。
初始化配置文件：要求 Kiro 根据项目初始化默认配置文件。
创建项目结构：要求 Kiro 根据需求和最佳实践创建项目结构。
提示示例：
"Set up a requirements.txt with development dependencies"
"Configure a .env file for my Django application"
"Set up a Python package structure with proper __init__.py files"
"Create a Flask project structure with blueprints"
"Organize my data science project with notebooks and modules"
"Create a pyproject.toml for a FastAPI project with pytest and black"
代码分析和重构
Kiro 可以分析您的 Python 代码以识别问题并提出改进建议：
代码质量分析：要求 Kiro 检查您的代码是否存在潜在错误、性能问题或 PEP 8 合规性
重构协助：获取提取函数、重命名变量或重构代码的帮助
类型提示：Kiro 可以建议类型注释以提高代码清晰度并捕获错误
提示示例：
"Analyze this function for potential bugs and performance issues"
"Refactor this code to follow PEP 8 style guidelines"
"Add type hints to this Python module"
"Convert this synchronous code to use async/await"
调试协助
当你在 Python 代码中遇到错误时：
错误解释：Kiro 可以用通俗易懂的语言解释 Python 回溯和错误消息
解决方案建议：获取常见 Python 错误的可行修复方法
运行时调试：Kiro 可以帮助设置调试配置和断点
例子：
"Explain this Python error: AttributeError: 'NoneType' object has no attribute 'split'"
"Help me debug this Django view that's returning a 500 error"
"Why is my pandas DataFrame operation so slow?"
引导配置
Steering(引导配置)允许您向 Kiro 提供项目特定的背景信息和指南。Kiro 可以生成您可以进行优化的指导文件：
产品简介（
product.md）- 包含有关产品、其用途和主要功能的信息技术栈（
tech.md）- 详细介绍技术、框架和开发指南项目结构（
structure.md）- 提供有关项目组织方式的信息
对于 Python 项目，您可以创建其他自定义指导文件来提供更具体的指导：
创建自定义指导文件
使用以下说明将新的指导文件添加到您的项目中。
添加新的指导文件
导航到侧边栏中的Kiro视图。
在代理指导部分，选择
+按钮来创建一个新的指导文件。输入文件的名称以及描述性标题。
按照 markdown 约定添加您的自定义指导内容。
自定义转向文件存储在.kiro/steering/目录中，并在交互过程中由 Kiro 自动识别。
代码风格和约定
例如，您可以为项目定义自定义命名约定、文件结构或实践。创建一个python-conventions.md指导文件来定义团队的编码标准：
降价
Python Conventions
Naming Conventions
- Use snake_case for variables and functions
- Use PascalCase for classes
- Use UPPER_SNAKE_CASE for constants
- Use descriptive names that explain purpose
Code Style
- Follow PEP 8 guidelines
- Use Black for code formatting
- Maximum line length of 88 characters
- Use type hints for all public functions
File Structure
- One class per file for large classes
- Group related functions in modules
- Use __init__.py files for package organization
- Separate tests in tests/ directory
Documentation
- Use docstrings for all public functions and classes
- Follow Google or NumPy docstring style
- Include type information in docstrings
框架特定指南
对于 Django 项目，创建一个django-patterns.md控制文件：
降价
Django Development Guidelines
Model Design
- Use descriptive model names
- Add __str__ methods to all models
- Use model managers for complex queries
- Follow Django naming conventions for fields
View Structure
- Prefer class-based views for complex logic
- Use function-based views for simple operations
- Keep business logic in models or services
- Use proper HTTP status codes
Template Organization
- Use template inheritance effectively
- Keep templates DRY with includes and tags
- Use meaningful template names
- Organize templates by app
Performance Best Practices
- Use select_related and prefetch_related for queries
- Implement database indexing for frequently queried fields
- Use caching for expensive operations
- Profile database queries in development
对于数据科学项目，创建一个data-science-patterns.md指导文件：
降价
Data Science Development Guidelines
Notebook Organization
- Use clear section headers and markdown cells
- Keep notebooks focused on single analyses
- Export reusable code to Python modules
- Include data source documentation
Data Handling
- Validate data quality early in pipelines
- Use consistent column naming conventions
- Document data transformations clearly
- Handle missing values explicitly
Model Development
- Use cross-validation for model evaluation
- Track experiments with clear versioning
- Document model assumptions and limitations
- Implement proper train/validation/test splits
Code Organization
- Separate data processing, modeling, and visualization
- Use configuration files for parameters
- Implement logging for long-running processes
- Create reproducible environments with requirements files
这些指导文件可帮助 Kiro 生成遵循您团队的特定惯例和最佳实践的代码。
代理钩子
Kiro 的Agent Hooks可以自动执行常见的 Python 开发任务：
导航到Kiro 面板中的Agent Hooks部分
单击+按钮创建一个新的钩子
用自然语言定义钩子工作流程
以下是一些钩子示例：
测试生成钩子
保存 Python 文件时自动生成测试：
"Create a hook that generates pytest tests when I save a new Python module"
依赖更新钩子
保持你的依赖项为最新：
"Create a hook that checks for outdated pip packages and suggests updates"
Linting Hook
When a Python file is saved:
1. Run flake8 or pylint on the file
2. Report any style or quality issues
3. Suggest fixes for common problems
4. Update docstrings if missing
虚拟环境钩子
When requirements.txt or pyproject.toml is modified:
1. Check if virtual environment is activated
2. Install or update dependencies automatically
3. Report any dependency conflicts
4. Update requirements-dev.txt if needed
文档访问#docs
Kiro 通过参考系统内置了 Python 和热门框架的文档访问功能#docs。这让您可以快速将相关文档带入与 Kiro 的对话中。只需#docs在聊天中输入内容，然后从可用的文档来源中进行选择即可，例如：
#Python - Python 语言文档
#Pytorch - PyTorch 框架文档
#PySide6——用于创建 GUI 的 Python 库
使用示例：
"#Python How do I use context managers effectively?"
"#Pytorch how can I add a custom operator?"
"#PySide6 What is the best way to add a button?"
您还可以使用以下方式引用特定文档 URL #URL：
"#URL https://docs.python.org/3/library/asyncio.html"
调试问题
当您遇到问题时，Kiro 可以帮助诊断并解决问题：
在线聊天：
输入
Cmd/Ctrl + I以打开在线聊天。要求 Kiro 帮助使用自然语言调试您的代码。
添加到聊天：
键入
Cmd/Ctrl + L以将当前文件添加到聊天中。要求 Kiro 帮助使用自然语言调试您的代码。
快速修复：
将鼠标悬停在错误或警告上，然后选择
Quick fix和Ask Kiro。Kiro 会自动将代码添加到聊天中并开始调试。