AgentSkillsCN

rust-code-debugger

针对 Rust 编译错误、借用检查器问题、运行时恐慌以及逻辑缺陷,提供清晰易懂的诊断说明与贴合 Rust 语言特性的解决方案。

SKILL.md
--- frontmatter
name: rust-code-debugger
description: Diagnoses and fixes Rust compile errors, borrow-checker issues, runtime panics, and logic bugs with clear explanations and idiomatic solutions.
scope: server

Rust Code Debugger

Instructions

  1. Understand the user request:
    Identify whether the problem is a compiler error, borrow-checker conflict, runtime panic, undefined behavior risk, or incorrect logic. Determine which Rust concepts (ownership, lifetimes, traits, concurrency, async, interior mutability, error handling) are involved.

  2. Reproduce the mental execution flow:
    Walk through the code step by step, tracking:

    • variable bindings and moves
    • reference creation and lifetimes
    • mutation paths (mutable aliasing, interior mutability)
    • control-flow branches
    • async .await suspension points
    • thread boundaries and Send / Sync requirements
  3. Identify the root cause with precision:
    Provide a detailed explanation grounded in Rust’s guarantees:

    • why the borrow checker rejected a pattern
    • why a value was moved earlier than expected
    • why a panic occurred (unwrap, index out of bounds, threading, channel behavior, etc.)
    • why lifetimes cannot be inferred
    • why trait resolution fails
    • why async runtime ordering causes issues
  4. Provide an idiomatic and minimal fix:
    Offer a correction that adheres to Rust best practices, such as:

    • replacing &mut conflicts with scoped blocks or .split_at_mut()
    • using Option or Result instead of panicking APIs
    • using iterator combinators instead of manual loops when appropriate
    • leveraging ? for clean error propagation
    • using Arc<Mutex<T>> or Arc<RwLock<T>> for shared mutable state across threads
    • applying Cow<'a, T> for flexible ownership
    • introducing helper structs or newtypes to reflect invariant boundaries

    Keep the fix minimal but idiomatic, avoiding unnecessary complexity.

  5. Suggest robust alternatives when relevant:
    If the user’s current approach is fragile or overly complex, gently recommend stronger patterns:

    • Use RAII guards for cleanup
    • Introduce separate data structures to enforce invariants
    • Replace manual state machines with enums
    • Use async channels or tasks instead of locks
    • Avoid premature cloning; prefer borrowing when possible
    • Structure code into smaller functions to reduce lifetime complexity
  6. Recommend preventive strategies:
    Provide practical guidance for long-term improvement, including:

    • writing smaller functions to help lifetime inference
    • adding #[derive(Debug)] for easier inspection
    • avoiding unnecessary clone() calls
    • adopting clippy (cargo clippy) and rustfmt
    • using feature flags, miri, and cargo-udeps to maintain healthy code
    • structuring modules around ownership boundaries
  7. Maintain clarity and educational value:
    Every explanation should not only fix the bug but help the user understand how Rust’s model leads to safer and more predictable code.