在 Cursor 中面对陌生的历史项目，你不需要手动去“读代码”总结，而是要通过 “索引提取 -> 规则固化 -> 指令对齐” 的三步走策略，让 Cursor 自己去“查字典”并遵守你的 Design Doc。

以下是具体操作流程：
第一步：让 Cursor 自动提取“项目基因”
既然你没时间熟悉项目，就让 Cursor 的 Codebase Indexing 功能来做。
按 Ctrl+L (或 Cmd+L) 开启 Chat，输入以下指令，让它自查项目规范：
“Analyze this project and extract the current technical stack: 1. Core framework and version. 2. UI component library used. 3. Data fetching patterns (Axios, Fetch, or TanStack Query?). 4. State management approach. 5. Styling conventions (Tailwind, CSS Modules, or Styled Components?).”
Cursor 会扫描全局代码，并在回复中列出目前项目正在使用的“潜规则”。
第二步：将 Design Doc 转化为 .cursorrules
这是最关键的一步。将你的 Design Doc 和第一步提取出的规范结合，写入项目的根目录。
在根目录新建一个文件：.cursorrules。
在文件中填入结构化的约束。例如：
markdown

Project Standards

• Framework: [从第一步提取的结果，如 Next.js 13 Pages Router]
• Components: Use [如 Ant Design] components exclusively.
• Styling: Follow existing CSS Module patterns, do not use Tailwind.
• API: Use the existing src/utils/request.ts for all calls.

Design Doc Requirements (本次修改目标)

• Feature: Add a new “Filter Sidebar”.
• Interaction: Must be collapsible, state saved in URL params.
• UI Style: Must match the aesthetic of /src/components/Header.
  请谨慎使用此类代码。

Cursor 每次生成代码前都会强制读取该文件。 Cursor Custom Rules
第三步：使用 @ 符号进行“上下文强行对齐”
在执行具体的修改指令时，利用 Cursor 的 Context 引用 功能，确保它不“跑偏”：
输入指令时，手动引用关键文件：
“Refactor the Sidebar based on my Design Doc. Please refer to @src/api/user.ts for request logic and @src/components/Button.tsx for button styles. Ensure the code style is consistent with @folders/src/pages.”
快捷键提示：输入 @ 后选择 Codebase，这会强制 Cursor 在整个项目范围内搜索与你 Design Doc 描述最匹配的代码片段。
核心建议：
针对历史项目：如果项目很乱，给指令时加一句话：“Don’t hallucinate new libraries. If you don’t find a component in the project, ask me instead of creating a new style.”
增量修改：先让它生成一个 Plan（方案），确认无误后再执行 Apply。

1. 深度摸底指令（防御性增强版）
   这个指令不仅提取技术栈，还强制 AI 寻找项目中的“边界”和“坑”。
   Prompt:
   “Act as a Senior Frontend Architect. Thoroughly analyze this codebase and provide a summary of the environment:
   Core Architecture: Framework version, directory structure, and entry points.
   Library Constraints: List all UI kits, state management, and request libraries. Identify if there are multiple versions/libraries conflicting (e.g., both Less and Tailwind).
   Coding Patterns: How are components defined (FC or Class)? What is the naming convention? How are icons handled?
   Forbidden Practices: Scan the code to see what should not be done (e.g., no inline styles, no direct DOM manipulation, no specific deprecated APIs).
   Execution Context: Locate the common utility folders and global types. Output a summary and wait for my next instruction.”
2. 建立“严控规则”：.cursorrules 模板
   提取完信息后，直接把结果填入根目录的 .cursorrules。这是物理限制 AI 行为的最强手段。为了防止 AI 乱改，你需要加入以下“严厉条款”：
   markdown

[Project Name] AI Safety & Implementation Rules

1. Strict Boundary Controls

• NO NEW LIBRARIES: Do not suggest or add any new npm packages. Use only what is in package.json.
• LEGACY CONSISTENCY: If the project uses AntD v4, do not use AntD v5 syntax. Always check local component implementations before writing new ones.
• NO REFACTORING: Do not refactor existing logic unless explicitly asked. Only perform incremental changes.

2. Coding Standards

• Style: [例如：CSS Modules / Tailwind]. If using CSS Modules, ensure filenames follow *.module.less.
• Requests: Use the instance in @/utils/request only. Do not use global fetch or axios.
• Types: Always check @/types for existing interfaces. No any type allowed.

3. Pre-flight Checklist (AI must confirm before applying)

• Before applying changes, list which existing files will be modified.
• If a component/utility needed for the task doesn’t exist, ASK ME instead of creating a mockup.
  请谨慎使用此类代码。

3. 如何在 Cursor 中“严格把控”执行过程？
   当你开始修改代码时，请遵循这套“审核流”：
   Chat First (Ctrl+L)：先在对话框里引用你的 Design Doc 和相关文件（使用 @file）。
   Ask for a Plan：给指令时加上：“Give me a step-by-step implementation plan first. Do not write code yet.”
   Review the Plan：检查它选用的组件库和方法是否符合历史项目习惯。如果它想新造一个 Button，而项目里已经有了，立马纠正它。
   Cmd+K for Snippets：方案确认后，在具体的代码行使用 Cmd+K。如果它改动过大，点击 “Show Diff” 逐行比对，不确定的行直接拒绝（Reject）。
   为什么这样做有效？
   消除幻觉：AI 最爱在不熟悉项目时引入它最擅长的 Lucide-react 或 Tailwind，哪怕你的项目还在用 Iconfont。
   降低心智负担：你不需要读完整个项目，你只需要做“选择题”（批准或拒绝 AI 的方案）。

你现在手头的这个历史项目，规模大吗？如果是万行以上的大项目，我建议你再加一条：强制 AI 每次修改后都要检查是否破坏了现有的 Typescript 定义。