s2f/cursor-rules

Cursor 规则文档索引

本目录包含 Cursor AI 辅助开发的核心协作规范和工作流文档。

文档概览

核心工作流

1. ai-coding-workflow.md - Cursor 全局 AI Coding 协作规则

   • 五阶段工作流：0-req → 1-prd → 2-task → 开发执行
   • 统一编号体系和执行前读取顺序
   • Definition of Done 标准

2. quick-reference.md - AI Coding 工作流快速参考

   • 新项目强制检查点
   • 阶段与产出对照表
   • Definition of Ready & Done
   • 禁止行为清单和紧急降级策略

3. new-project-checkpoint.md - 新项目初始化检查点

   • 新项目识别条件
   • 强制启动流程
   • 检查点通过条件

专项规范

4. AGENTS.md - AI 辅助开发协作规范（项目级）

   • 文档阅读顺序
   • 代码修改原则
   • 任务管理和测试纪律
   • 提交规范和已知问题

5. change-management.md - 需求变更管理

   • 7 维度影响评估表
   • 六步变更流程
   • 变更文档模板

6. architecture-and-design.md - 架构与设计原则

   • ADR 架构决策记录
   • API/DB 变更约束
   • 实体唯一代码规范
   • 代码质量、测试、安全

7. ui-components-standard.md - UI/UX 与公共组件规范

   • UI/UX 设计原则
   • 公共组件抽取原则
   • UI 公共组件登记表
   • 组件参数膨胀应对策略

使用指南

新项目启动

1. 阅读 new-project-checkpoint.md 了解新项目初始化流程
2. 阅读 ai-coding-workflow.md 了解五阶段工作流
3. 按照 quick-reference.md 中的阶段对照表推进

日常开发

1. 执行任务前，按 ai-coding-workflow.md §3.1.2 的顺序读取上下文
2. 遵循 AGENTS.md 的代码修改原则
3. 需求变更时，参考 change-management.md 的六步流程
4. 重大技术决策时，参考 architecture-and-design.md 创建 ADR

快速查询

遇到以下情况，快速查阅对应文档：

• 不确定当前阶段 → quick-reference.md 阶段对照表
• 需要变更需求 → change-management.md 7 维评估
• API/DB 变更 → architecture-and-design.md 变更检查清单
• UI 组件重复 → ui-components-standard.md 抽取原则
• 项目特定规则 → AGENTS.md 项目协作规范

文档维护

• 这些规则文档来源于 Cursor 全局规则
• 项目级调整应在项目根目录的 AGENTS.md 中说明
• 规则冲突时，优先级：用户明确指令 > 项目规则 > 全局规则

相关文档

项目其他重要文档：

• ../pmdocs/ - 项目需求、PRD、任务文档
• ../run.md - 项目运行手册
• ../.windsurfrules - 项目精简规则（如果存在）
• ../AGENTS.md - 项目级 AI 协作规范（如果存在）