出海实战手记：.cursorrules 提示词上下文最佳配置
在出海开发多语言、全栈项目（如 Astro + Tailwind CSS + TypeScript）时，推荐在项目根目录维护 .cursorrules 文件，以固化 AI 智能体的代码生成边界与质量准则。
核心约束原则
- 技术栈规范：统一采用 TypeScript 严格模式，显式声明类型，避免随意使用
any； - UI 与设计系统：优先使用 Tailwind CSS 实用类名与原子化组件，禁止手写冗余内联样式；
- 交互与语义化：保证可访问性语义标签（如
<header>、<nav>、<main>、<article>、<button>）与键盘导航友好； - 出海多语言与 SEO：字符串严禁硬编码在组件中，统一通过 i18n 字典加载；外链必须显式标注
rel="noopener noreferrer"； - Git 规范：提交信息遵循 Conventional Commits 规范（如
feat:,fix:,refactor:,docs:）。
生产级 .cursorrules 开箱即用模板
将以下内容直接保存至项目根目录的 .cursorrules 文件中：
# Role & Context
你是一名专注于出海全栈开发的资深工程师。本项目技术栈为：Astro + TypeScript + Tailwind CSS。
# Code Standards
- 编写简洁、高内聚、易维护的现代 TypeScript 代码。
- 严禁使用 any，复杂对象必须声明明确的 interface 或 type。
- 优先采用不可变数据流与函数式编程模式。
# UI & Accessibility (a11y)
- 全面使用 Tailwind CSS 原子化类名，严禁硬编码内联样式。
- 严格保证 HTML 语义化结构（优先使用 <nav>、<main>、<article>、<section> 代替无意义 <div>）。
- 所有交互式元素（按钮、链接）必须具备清晰的 aria-label 或可视文本，支持键盘 Tab 导航。
# Outbound & SEO Security
- 外部链接必须携带 target="_blank" rel="noopener noreferrer"。
- 涉及跨境支付与敏感鉴权的代码，严格遵循 HTTPS 与 CSRF/防重放签名规范。
- 严禁在客户端代码或公开 Git 仓库中泄露任何私有环境变量（如 API Secret、支付私钥）。
# Git Commits
- 提交信息遵循 Conventional Commits 格式，例如：
- feat: add programmatic seo template
- fix: resolve broken internal anchor tags在项目根目录配置后，Cursor Composer 与 Agent 在多轮迭代重构时将自动遵循上述规范约束，大幅减少因 AI“自由发挥”导致的低级语法报错与多轮沟通返工成本。