surfup

Cursor 和 Claude Code 的 12 条项目规则

12 条实用规则,涵盖代码仓库上下文、SEO、安全和可验证的改动。

将以下规则作为工作清单,并根据项目的证据、范围和限制进行调整。

上下文与范围

  • 先阅读适用于此工具的项目说明(如有,例如 .cursor/rules 或 CLAUDE.md);同时查看 README 和 manifest(如有)。
  • 编辑前,概述当前架构,并只确定这项改动需要涉及的文件。
  • 把目标定义为一个可验证的结果;没有理由时不要扩大任务范围。
  • 修改 API 前,先确认它的调用方、请求与响应结构,以及兼容性要求。

质量与安全

  • 对每项用户输入,明确格式、长度以及不安全值的校验方式。
  • 不要将机密放入代码、日志、测试夹具、示例或随前端发布的资源中。
  • 对于搜索页面,检查 title、description、canonical、robots、标题、链接和原始 HTML。
  • 每种语言都应使用对应的文案、符合地区习惯的联系示例,以及相互对应的 URL。
  • 确保交互元素可通过键盘操作、具有辅助技术可识别的名称,并显示清晰的焦点状态。

验证与报告

  • 只运行能够验证本次改动的检查;不要声称运行过实际上没有运行的命令。
  • 对照验收条件检查结果,并查看错误路径和移动端视口。
  • 报告改动、实际运行的命令及结果、已知限制和回滚方式。