AgentSkillsCN

rust

Rust 开发的最佳实践,包括项目结构、错误处理与测试

SKILL.md
--- frontmatter
name: rust
description: Best practices for Rust development including project structure, error handling, and testing
goal: พัฒนาระบบด้วย Rust ตาม best practices
outcome: Projects ที่ใช้ Rust มีคุณภาพและ maintainable

Rust Development

When to Execute

Use this skill when you need to develop systems with Rust focusing on safety, performance, and maintainability.

Folder Structure Summary

FolderPurposeWhen to Use
rules/Specific guidelines and patternsCreate actionable rules
rust-*.mdImplementation guidesStep-by-step setup instructions

Entry Points

  1. New Rust Project - Start with cargo new and configure Cargo.toml
  2. Error Handling - Use thiserror for robust error management
  3. Project Structure - Follow components, services, and adapters patterns
  4. Configuration - Set up config files and Cargo config
  5. Testing & CI - Implement comprehensive testing strategies

Quick Start

  1. สร้างโปรเจกต์ Rust ใหม่ด้วย cargo new my-project
  2. ตั้งค่า Cargo.toml ตาม rust-cargo-toml.md
  3. ตั้งค่า error handling ด้วย thiserror ตาม rust-error-rs.md
  4. จัดโครงสร้างโปรเจกต์ตาม rust-components.md
  5. รัน cargo test เพื่อทดสอบการตั้งค่า

Rules

PriorityImpactReferenceNameDescriptionPrefixCondition
1CRITICALrust-cargo-toml.mdCargo.tomlตั้งค่า Cargo.toml ตาม best practicesrust-เมื่อสร้าง project
1CRITICALrust-cargo-config.mdCargo Configตั้งค่า .cargo/config.tomlrust-เมื่อตั้งค่า config
1CRITICALrust-config-file.mdConfig Fileตั้งค่า Config.tomlrust-เมื่อตั้งค่า config
2HIGHrust-error-rs.mdError Handlingการจัดการ errors ด้วย thiserrorrust-เมื่อ handle errors
2HIGHrust-config-rs.mdConfig Moduleการจัดการ configuration ด้วย figmentrust-เมื่อจัดการ config
2HIGHrust-telemetry-rs.mdTelemetryการจัดการ logging ด้วย tracingrust-เมื่อ setup telemetry
2HIGHrust-prelude-rs.mdPreludeการจัดการ common importsrust-เมื่อจัดการ imports
2HIGHrust-lib-rs.mdLibrary EntryExpose Public APIrust-เมื่อสร้าง library
2HIGHrust-main-rs.mdMain EntryApplication Entry Pointrust-เมื่อสร้าง application
3HIGHrust-components.mdComponentsPure Layer: Domain logicrust-เมื่อสร้าง components
3HIGHrust-services.mdServicesEffect Layer: I/Orust-เมื่อสร้าง services
3HIGHrust-adapters.mdAdaptersWrappers สำหรับ external librariesrust-เมื่อสร้าง adapters
3HIGHrust-utils.mdUtilsPure helpersrust-เมื่อสร้าง utils
3HIGHrust-types.mdTypesData Structuresrust-เมื่อสร้าง types
3HIGHrust-constants.mdConstantsค่าคงที่rust-เมื่อสร้าง constants
4MEDIUMrust-testing.mdTestingUnit และ Integration Testsrust-เมื่อทดสอบ
4MEDIUMrust-imports.mdImportsการจัดการ importsrust-เมื่อจัดการ imports
4MEDIUMrust-documentation.mdDocumentationDocumentation Standardrust-เมื่อเขียน docs
4MEDIUMrust-prohibitions.mdProhibitionsสิ่งที่ห้ามrust-เมื่อเขียน code
4MEDIUMrust-code-quality.mdCode QualityBest practicesrust-เมื่อเขียน code
4MEDIUMrust-security.mdSecurityBest practicesrust-เมื่อ ensure security
4MEDIUMrust-performance.mdPerformanceBest practicesrust-เมื่อ optimize

Knowledge

ReferenceNameDescriptionPrefix
core-concept.mdCore Conceptsความรู้เกี่ยวกับ concepts หลักของ Rustrust-
all-features.mdAll Featuresความรู้เกี่ยวกับฟีเจอร์ทั้งหมดของ Rustrust-
best-practices.mdBest Practicesแนวทางปฏิบัติที่ดีที่สุดสำหรับ Rustrust-

References