Cursor 三级火箭以及点线面体实践指南 - 从对话到闭环

核心理念

目标: 把每次 Cursor 对话的价值最大化，形成可复用、可落地的知识资产。

🚀 第一级火箭: 通过 Chat 对话完成 Feature

核心价值

快速验证想法、完成核心功能产出

操作原则

高频使用，先做最常用、最核心的功能
暂不考虑边界情况，快速出原型
强调"可工作"而非"完美"

示例 1: 在 ZCCBaseView 视频视图添加时间标签

背景 : 项目中有一个视频基础视图 ZCCBaseView，需要在右上角添加一个显示时长的标签。 Prompt:

plaintext 复制代码

[I] Intent: 在 ZCCBaseView 的右上角添加一个时间标签（NSTextField）

[C] Constraints: 
- 距离右侧和顶部各 8pt 边距
- 使用手动布局（frame），不使用 Auto Layout
- 字体：系统 12pt，白色，半透明黑色背景
- 需要一个公开方法 updateWithTime: 用于更新时间显示

[E] Expected Output: 
- ZCCBaseView.h 的接口声明
- ZCCBaseView.m 的实现代码
- 简短的使用示例

AI 产出:

objectivec 复制代码

// ZCCBaseView.h
@interface ZCCBaseView : NSView

// Update the time label with time interval (in seconds)
- (void)updateWithTime:(NSTimeInterval)time;

@end

objectivec 复制代码

// ZCCBaseView.m
@interface ZCCBaseView ()
@property (nonatomic, strong) NSTextField *timeLabel;
@property (nonatomic, strong) NSDateComponentsFormatter *timeFormatter;
@end

@implementation ZCCBaseView

- (instancetype)initWithFrame:(NSRect)frame {
    self = [super initWithFrame:frame];
    if (self) {
        [self setupTimeLabel];
    }
    return self;
}

- (void)setupTimeLabel {
    // Initialize time formatter
    self.timeFormatter = [[NSDateComponentsFormatter alloc] init];
    self.timeFormatter.allowedUnits = NSCalendarUnitMinute | NSCalendarUnitSecond;
    self.timeFormatter.zeroFormattingBehavior = NSDateComponentsFormatterZeroFormattingBehaviorPad;
    
    // Create time label
    self.timeLabel = [[NSTextField alloc] initWithFrame:NSZeroRect];
    self.timeLabel.editable = NO;
    self.timeLabel.bordered = NO;
    self.timeLabel.backgroundColor = [[NSColor blackColor] colorWithAlphaComponent:0.6];
    self.timeLabel.textColor = [NSColor whiteColor];
    self.timeLabel.font = [NSFont systemFontOfSize:12.0];
    self.timeLabel.alignment = NSTextAlignmentCenter;
    [self.timeLabel setWantsLayer:YES];
    self.timeLabel.layer.cornerRadius = 4.0;
    
    [self addSubview:self.timeLabel];
}

- (void)layout {
    [super layout];
    
    // Manual layout for time label
    CGSize labelSize = CGSizeMake(60, 20);
    CGFloat padding = 8.0;
    CGRect labelFrame = CGRectMake(
        self.bounds.size.width - labelSize.width - padding,
        self.bounds.size.height - labelSize.height - padding,
        labelSize.width,
        labelSize.height
    );
    self.timeLabel.frame = labelFrame;
}

- (void)updateWithTime:(NSTimeInterval)time {
    NSString *timeString = [self.timeFormatter stringFromTimeInterval:time];
    self.timeLabel.stringValue = timeString ?: @"00:00";
}

@end

使用示例:

objectivec 复制代码

ZCCBaseView *videoView = [[ZCCBaseView alloc] initWithFrame:rect];
[videoView updateWithTime:125.5]; // 显示 "02:05"

🚀 第二级火箭: 沉淀场景 + 生成可复用 Prompt

核心价值

把对话中产出的有价值信息抽象、整理成可复用场景和模板

操作原则

按 MECE 法则（互斥、完全穷尽）整理场景
移除冗余或无关的 Prompt 文本
形成"模块化知识库"
存储到 .cursor/rules/ 以便未来复用

操作流程

plaintext 复制代码

1. 回顾第一级对话，识别核心价值
   ↓
2. 移除冗余或无关的 Prompt 文本
   ↓
3. 按 MECE 整理场景
   ↓
4. 生成可复用 Prompt 模板
   ↓
5. 形成"模块化知识库"

实战示例: 从"添加时间标签"对话中沉淀模板

步骤 1: 分析原始对话

有价值的部分:

在视图添加子控件的标准流程
手动布局的实现方式
属性声明的最佳实践（私有属性放 class extension）
格式化器（Formatter）的复用模式 无价值的部分:
具体的尺寸数字（60、20、8 等）
时间标签特定的样式细节
单次性的调试建议

步骤 2: 沉淀为可复用 Prompt 模板

创建文件: .cursor/rules/mac-add-subview-template.md

markdown 复制代码

# Mac 视图添加子控件模板生成器

## 适用场景
- 在现有 NSView 子类中添加新的子控件
- 需要手动布局或 Auto Layout
- 需要公开接口供外部调用

## Prompt 模板

I\] Intent: 在 \[ViewClassName\] 中添加 \[控件描述\] \[C\] Constraints: * 控件类型: \[NSTextField/NSButton/NSImageView/Custom

布局方式: [手动布局/Auto Layout]
位置: [左上角/右上角/居中/自定义]
样式要求: [字体/颜色/背景/边框等]
公开接口: [是/否]，方法签名 [method signature] [S] Steps:

在 .h 文件中声明公开接口（如果需要）
在 .m 文件的 class extension 中声明私有属性
在 init 方法中调用 setup 方法
实现 setup 方法，配置控件样式
在 layout 或使用 Auto Layout 设置位置
实现公开接口方法 [E] Expected Output:

.h 文件的接口声明（如果需要）
.m 文件的完整实现（带注释）
使用示例

plaintext 复制代码

## 模块化代码模板

### 头文件（如果需要公开接口）
```objc
// [ViewClassName].h
@interface [ViewClassName] : NSView

// Public method to update the [control]
- (void)[updateMethodName]:(Type)parameter;

@end

实现文件

objectivec 复制代码

// [ViewClassName].m

// Private properties
@interface [ViewClassName] ()
@property (nonatomic, strong) NSTextField *[controlName];
@end

@implementation [ViewClassName]

- (instancetype)initWithFrame:(NSRect)frame {
    self = [super initWithFrame:frame];
    if (self) {
        [self setup[ControlName]];
    }
    return self;
}

- (void)setup[ControlName] {
    // Initialize and configure the control
    self.[controlName] = [[NSTextField alloc] initWithFrame:NSZeroRect];
    // ... configuration
    [self addSubview:self.[controlName]];
}

- (void)layout {
    [super layout];
    // Manual layout logic
}

// Or use Auto Layout
- (void)updateConstraints {
    [super updateConstraints];
    // Auto Layout constraints
}

// Public method
- (void)[updateMethodName]:(Type)parameter {
    // Implementation
}

@end

注意事项清单

属性声明: 私有属性放 class extension，避免暴露实现细节
布局选择: 性能敏感场景用手动布局，复杂布局用 Auto Layout
格式化器: 可以声明为属性复用，避免重复创建
命名规范: 遵循项目 .cursorrules 中的命名规范

plaintext 复制代码

---

## 🚀 第三级火箭: 闭环固化产出

### 核心价值
**形成可落地、可直接使用的完整产出**

### 完整产出物清单

□ 可复用代码库（封装为独立模块） □ 架构设计文档（含 Mermaid 图） □ API 使用文档（含示例代码） □ 单元测试用例（覆盖核心场景） □ 集成指南（如何接入现有项目） □ 故障排查手册（常见问题 FAQ） □ 可复用 Prompt 模板（存入 .cursor/rules/）

plaintext 复制代码

### 实战示例: 完整的视频视图组件库闭环产出

#### **综合 Prompt (结合第一级 + 第二级)**

Cursor 三级火箭以及点线面体实践指南 - 从对话到闭环

核心理念

目标: 把每次 Cursor 对话的价值最大化，形成可复用、可落地的知识资产~~。~~

🚀 第一级火箭: 通过 Chat 对话完成 Feature

核心价值

操作原则

示例 1: 在 ZCCBaseView 视频视图添加时间标签

🚀 第二级火箭: 沉淀场景 + 生成可复用 Prompt

核心价值

操作原则

操作流程

实战示例: 从"添加时间标签"对话中沉淀模板

步骤 1: 分析原始对话

步骤 2: 沉淀为可复用 Prompt 模板

实现文件

注意事项清单

目标: 把每次 Cursor 对话的价值最大化，形成可复用、可落地的知识资产。