用途:当用户需要生成带文档与错误处理的函数、类或模块,搭建含配置文件和目录结构的新项目,创建 CRUD 控制器、服务层、数据模型等样板代码,重构或优化现有代码结构,或按模板与规格生成代码时使用本技能。
主要能力:支持 Python(类型注解、docstring、pytest)、JavaScript/TypeScript(ESM、JSDoc 或 TSDoc)、Java(JavaDoc、Maven/Gradle)、Go(godoc、模块)、Rust(rustdoc、Cargo)。可生成函数/类、模块/包或完整项目脚手架,例如 TypeScript/Node 项目可包含 src/controllers、src/services、src/models、src/middleware、src/index.ts、tests/unit、tests/integration、package.json、tsconfig.json、README.md。
使用方式:先明确目标语言、框架与编码规范;再选择生成类型(函数/类、模块/包或完整项目脚手架);然后生成完整、有文档、有测试的代码;最后验证代码可编译/运行并符合项目约定。
最佳实践:始终包含错误处理,校验输入、使用类型化异常并返回有意义的错误信息;为每个公开函数/类添加含参数、返回值与异常的文档;遵循语言规范(Python 用 PEP 8、Go 用 gofmt、TypeScript 用 Prettier);随代码生成测试,每个函数至少一个正常路径和一个错误路径测试;在语言支持时使用类型注解。
限制:资料未提供具体安装命令、收费方式、平台支持范围及实际效果数据,暂未提供。