mcpField
C
code-generator

code-generator

github.com/partme-ai开发716123 次安装3 周前更新
代码仓库

关于 code-generator

code-generator 是面向开发者的代码生成技能，可生成带文档和错误处理的代码、项目脚手架及模板代码，也可重构现有结构。

主要功能

  1. 01生成函数、类和模块
  2. 02搭建项目目录与配置
  3. 03生成 CRUD 样板代码
  4. 04重构代码结构
  5. 05支持五种语言及测试

适用场景

  1. 01为新功能生成带类型标注的代码
  2. 02搭建 TypeScript 项目基础结构
  3. 03为函数补充成功与错误路径测试

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/partme-ai/full-stack-skills --skill code-generator

安装后在 Claude Code 中输入/code-generator确认已加载。

详细介绍

适用场景

在用户希望进行以下操作时使用此技能：

  • 生成带有完善文档和错误处理的函数、类或模块
  • 使用配置文件和目录结构搭建新项目
  • 创建样板代码（CRUD 控制器、服务层、数据模型）
  • 重构或优化现有代码结构
  • 根据模板或规范生成代码

如何使用此技能

工作流
  1. 明确需求 - 确定目标语言、框架和编码规范
  2. 选择生成类型 - 函数/类、模块/包或完整项目脚手架
  3. 生成代码 - 按照以下模式生成完整、有文档且经过测试的代码
  4. 验证输出 - 确保代码可以编译/运行，并遵循项目规范
代码生成模式

函数生成（Python 示例）：

def calculate_order_total(
    items: list[OrderItem],
    discount_pct: float = 0.0,
    tax_rate: float = 0.08,
) -> Decimal:
    """Calculate the total price for an order including tax and discount.

    Args:
        items: List of order items with price and quantity.
        discount_pct: Discount percentage (0.0 to 1.0).
        tax_rate: Tax rate to apply after discount.

    Returns:
        Final order total as a Decimal rounded to 2 places.

    Raises:
        ValueError: If discount_pct is not between 0 and 1.
    """
    if not 0 <= discount_pct <= 1:
        raise ValueError(f"discount_pct must be 0-1, got {discount_pct}")

    subtotal = sum(item.price * item.quantity for item in items)
    discounted = subtotal * Decimal(1 - discount_pct)
    total = discounted * Decimal(1 + tax_rate)
    return total.quantize(Decimal("0.01"))

项目脚手架（TypeScript/Node）：

my-service/
├── src/
│   ├── controllers/    # Route handlers
│   ├── services/       # Business logic
│   ├── models/         # Data models / DTOs
│   ├── middleware/      # Auth, logging, error handling
│   └── index.ts        # Entry point
├── tests/
│   ├── unit/
│   └── integration/
├── package.json
├── tsconfig.json
└── README.md
支持的语言
  • Python（类型提示、文档字符串、pytest）
  • JavaScript / TypeScript（ESM、JSDoc 或 TSDoc）
  • Java（JavaDoc、Maven/Gradle）
  • Go（godoc、模块）
  • Rust（rustdoc、Cargo）

最佳实践

  1. 始终包含错误处理 - 验证输入、使用有类型的异常，并返回有意义的错误消息
  2. 添加文档 - 每个公共函数/类都应有包含参数、返回值和异常说明的文档字符串
  3. 遵循语言规范 - Python 使用 PEP 8，Go 使用 gofmt，TypeScript 使用 Prettier
  4. 同时生成测试 - 每个函数至少包含一个正常路径测试和一个错误路径测试
  5. 使用类型注解 - 在语言支持静态类型的情况下尽早发现错误

关键词

代码生成, code generation, scaffold, boilerplate, template, 函数, 类, 模块, project structure, code scaffold, 项目脚手架

评论

支持 Markdown