当设计或修改 REST API 响应结构、处理 API 返回值,或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义,以及生成产物时关键字段缺失但静默成功的问题。
日本語の概要は準備中です。原文の説明を表示しています。
Rust 开发规范(Axum + Tokio 后端栈),适用于 Rust 源码、模块组织、错误处理、异步编程和测试相关任务;不负责 review、debug 或运维流程。
インストール方法を見るインストールする前に、エージェントに与えられる指示の中身を確認できます。
在编辑或审查 Rust 代码时使用本技能,重点处理 idiomatic Rust、模块拆分、错误处理(thiserror/anyhow)、Tokio 异步陷阱、Axum 路由组织与测试。
不要用于:
.rs 文件,不堆 lib.rs;pub(crate) 优先于 pub。thiserror,应用用 anyhow,跨边界统一 AppError + IntoResponse。.unwrap() / .expect() / panic!();配置 clippy deny。tokio::task::spawn_blocking;跨 .await 的锁用 tokio::sync::Mutex。tokio::select! 分支必须取消安全;不确定时把状态保存到 select! 外部。edition = "2024",TLS 选 rustls;业务代码原则禁用 unsafe。references/style.mdreferences/errors.mdreferences/async.mdreferences/testing.mdreferences/project-shape.mdまだレビューはありません。使ってみた感想をお寄せください。
概要と使いどころ
当设计或修改 REST API 响应结构、处理 API 返回值,或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义,以及生成产物时关键字段缺失但静默成功的问题。
日本語の概要は準備中です。原文の説明を表示しています。
当设计或修改 REST API 响应结构、处理 API 返回值时触发。防止 API 设计缺陷导致的字段错位、类型歧义等问题。
日本語の概要は準備中です。原文の説明を表示しています。
网关/代理/WAF/CDN 中间件的安全关键词匹配实现规范,防止纯子串匹配误判正常响应内容中的技术术语(如 Cloudflare、502、error)
日本語の概要は準備中です。原文の説明を表示しています。
当 API/任务可能执行超过 10 秒(批量数据处理、远程 API 批量调用、全表扫描、跨租户聚合)时触发。防止同步接口被网关 30s 超时切断、用户重复点击触发并发、状态缓存内存泄漏等问题。提供异步任务状态机标准模板。
日本語の概要は準備中です。原文の説明を表示しています。
Bash 脚本与系统命令规范。禁止行尾注释,强制使用 tee/heredoc 写入,提升命令执行的可维护性。
日本語の概要は準備中です。原文の説明を表示しています。
Bash 编写规范。当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件, 或在 Markdown 中编写 bash/shell 代码块时触发。 包含注释规范、文件写入方式、Heredoc 引号规则、权限路径、脚本规范等。
日本語の概要は準備中です。原文の説明を表示しています。