SuperAPI AI 工具集

rust-sop

编程与开发

查看项目

更新于 10-15 23:33

技能介绍

用途:为 joelclaw 内所有 Rust 代码提供统一的惯用模式与约定,主要服务对象是 clawnode(嵌入式 PDS + mesh 守护进程),也用于把 Rust 工作委派给 codex 等智能体时附带此技能。

主要能力与约定:技术栈包括 tokio(默认多线程,测试用 current_thread)、axum(XRPC 端点与健康检查)、libsql(本地优先,支持 F32_BLOB 与 DiskANN 向量搜索)、serde/serde_json、thiserror(库)与 anyhow(二进制)、clap(derive)、tracing 结构化日志、内置测试与 tokio::test、proptest、atrium 处理 AT Proto 类型。项目结构给出 clawnode 的目录布局(daemon、pds、storage、mesh、socket、cli、tests、migrations)。命名约定涵盖 crate、模块、类型、trait、错误枚举与常量。核心模式包括:错误处理(生产代码禁用 unwrap,用 ? 与 context,边界层做错误映射)、所有权与借用(参数用 &str、&[T],必要时用 Cow)、异步(优雅关闭、select! 可取消循环、spawn_blocking 处理 CPU 密集任务、禁止跨 await 持有锁)、trait 与六边形架构(端口 trait + 适配器 + 组合根)、结构化日志、libSQL 向量检索、axum 路由。

使用方式:按验证清单执行 cargo fmt --check、cargo clippy --all-targets --all-features、cargo test、cargo test --doc;clawnode 另需 cargo build --release 与 cargo clippy -- -D warnings。写非平凡代码前须用 joelclaw docs search 检索 pdf-brain 库,并用 joelclaw docs context <chunk-id> --mode snippet-window 获取上下文。

适用场景与限制:适用于 joelclaw 仓库内的 Rust 开发与智能体委派。资料未提供安装方式、收费、价格或平台信息;反模式表列出应避免的写法(如生产 unwrap、println! 日志、跨 await 持锁等)。