Cursor Agent Master Prompt 使用教程

1. 项目介绍

Cursor Agent Master Prompt 是一个开源项目，旨在帮助开发者以一种系统化的方式完成任务。该项目通过创建一个清晰的记录，记录下每一个决策和里程碑，使开发者能够随时查看完成了哪些工作以及为什么这样做。它具有以下关键特性：

• 自动化任务文档：帮助开发者建立一个包含从初始分析到最终实现的单一“任务文件”。
• Git 工作流集成：为开发者提供精确的指令，如何创建分支、合并更改以及清理仓库，确保版本控制流程的平滑和一致性。
• 基于检查点的进度：设置战略性的暂停点，以便开发者在与你确认进度后再继续前进，减少无效努力或避免错误的方向。
• 详细任务分析：鼓励在代码更改之前进行彻底的问题解决，防止草率的解决方案，并促进对任务更深入的理解。
• 进度跟踪：保持一个按时间顺序记录的日志，记录每一次尝试、成功和失败，便于回顾尝试的内容及其结果。
• 可重用文档：每个任务文件可以作为未来任务合作的独立提示。
• 真实来源管理：集中管理所有项目决策和进度笔记，避免对发生了什么或为什么做出某些选择产生混淆。
• 最终审查过程：引导开发者进行结构化的审查，以验证每一步是否完成并且文档正确无误。

2. 项目快速启动

首先，你需要克隆项目到本地环境：

git clone https://github.com/maxfahl/cursor-agent-master-prompt.git
cd cursor-agent-master-prompt

然后，创建一个新的任务文件，并按照以下模板填写信息：

[TASK]: <描述你的任务>
[PROJECT OVERVIEW]: <输入项目概述，或链接到包含详细信息的文件>
[MAIN BRANCH]: <你的主分支>
[YOLO MODE]: <ask|on|off>

例如：

[TASK]: 修复表单提交时有时无法添加待办事项的问题
[PROJECT OVERVIEW]: PimpMyTask 是一个待办事项应用... 这里是一个重要文件列表及其功能...
[MAIN BRANCH]: master
[YOLO MODE]: off

3. 应用案例和最佳实践

• 详细任务分析：在开始编码之前，确保你完全理解任务的需求和目标。这可以通过创建一个任务分析文档来实现，其中详细描述问题、可能的解决方案以及预期的结果。
• Git 工作流：遵循项目中的 Git 工作流指导，创建新分支进行开发，确保你的更改不会影响主分支的稳定性。
• 进度跟踪：在任务文件中记录你的进度，包括遇到的问题、尝试的解决方案以及最终的结果。
• 代码审查：在合并代码之前，进行代码审查以确保代码质量，并且符合项目的最佳实践。

4. 典型生态项目

Cursor Agent Master Prompt 可以与许多其他开源项目结合使用，例如：

• 自动化工作流：结合 GitHub Actions 或 GitLab CI/CD，自动化测试和部署过程。
• 代码质量工具：使用 ESLint、Prettier 等工具确保代码质量和一致性。
• 项目管理工具：整合 Trello、Jira 等工具，更有效地管理项目任务和进度。

通过以上步骤和最佳实践，你可以更高效地使用 Cursor Agent Master Prompt 来提升你的开发流程。