quality

A set of Cursor coding rules covering code quality, Chinese comments, logging, error handling, security, performance, testing, and delivery checks. Cursor rules guide an AI coding assistant's work in a project.

In plain words
What is it for?
Use them when adding features, reviewing code, handling failures, designing logs, checking performance, and preparing changes for delivery.
Why use it?
They give the assistant consistent expectations for readable code, safe logs, useful errors, input validation, maintainability, and basic verification.

Cursor rule for Cursor

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add rules/mywand/cusrsor-do-it/quality
Clone the repo
git clone --depth 1 https://github.com/mywand/cusrsor-do-it

Made for: Cursor.

Per session 511 This file is loaded in full into every session.
When invoked 511 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00511 $0.00511
Opus 5 $0.00255 $0.00255
Sonnet 5 $0.00102 $0.00102
Haiku 4.5 $0.00051 $0.00051

Measured yesterday against content hash 3343c4783123, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

quality scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.cursor/rules/tools/quality.mdc · 44 lines

What it actually says

最近更新: 2025-09-18

质量守则

通用

  • 所有注释中文;领域命名精确。
  • 文件 / 模块聚焦单一职责;避免巨型类/函数。
  • 任何新增能力:附最小用例 / 测试思路(即便伪代码)。

日志

  • 仅关键路径、失败、边界条件;避免噪音与重复日志。
  • 等级语义:TRACE/DEBUG/INFO/WARN/ERROR;INFO 以上默认结构化(键值)。
  • 日志字段建议:timestamp | level | traceId | spanId | actor/userId | scene | keyArgs | result | costMs | errorType。
  • 敏感字段必须脱敏(仅保留末 3~4 位或散列)。
  • 禁止在热点循环内高频打印或打印大对象(使用摘要/计数)。

错误处理

  • 不吞异常;转换或包装并携带上下文。
  • 区分业务 vs 系统异常;必要时自定义异常类。
  • 用户可见消息不得暴露敏感实现细节。

性能与扩展

  • 评估算法复杂度(O 表示);避免无界增长集合。
  • 预留扩展点:接口/策略/配置,不过度抽象。

安全(视场景)

  • 输入校验:长度 / 类型 / 枚举 / 危险字符。
  • 不记录敏感信息到日志(密码、密钥、隐私)。

交付前自检清单

  • 需求点全部覆盖(含边界)。
  • README 已更新或创建。
  • 编译 / 构建 / 基础测试通过。
  • 关键异常路径演练过。
  • 命名、注释、目录结构清晰。
  • 无明显重复代码 / 死代码。
  • 日志结构化且适度,无噪音;不含敏感信息。
  • 关键链路具备可观测点:trace 覆盖 + 核心指标(QPS/Latency/ErrorRate)。
  • 给出后续迭代建议(如有)。
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 44 lines · 511 tokens per session scan A 3343c4783123

Subscribe to this mod's changes

quality is a cursor rule published in the GitHub repository mywand/cusrsor-do-it (2 stars, last pushed 7mo ago), licensed Apache-2.0. It adds 511 tokens to every session, about $0.0026 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.