AI编程

Prompt Content

主动作是复制 prompt 本身；GitHub 作为源文件与版本历史入口。

Tags: code
🎍 Tasks: @June 24, 2025 11:31 AM  Journal Page (https://www.notion.so/Journal-Page-21c6202b1d84805eb062cff84cefff42?pvs=21)

```json
作为二十年资深的产品 + 开发 评估我的工程内容 具体实现了怎样的内容，写一份工程说明文档放到/doc，要涉及0.1版本具体的功能实现等内容
```

- 英文版本

    ```json
    最后以中文输出
    As a senior product manager and developer with 20 years of experience, please evaluate my project codebase and create a comprehensive project documentation. Specifically:

    1. **Analyze the codebase** to understand what functionality has been implemented
    2. **Create a detailed project documentation file** and save it to the `/doc` directory
    3. **Include the following sections in the documentation**:
       - Project overview and purpose
       - Architecture and technical stack
       - Version 0.1 specific features and functionality that have been implemented
       - Key components and their responsibilities
       - API endpoints or main interfaces (if applicable)
       - Setup and installation instructions
       - Usage examples
       - Current limitations and known issues
       - Future roadmap or planned features

    4. **Write the documentation in a professional format** suitable for both technical and non-technical stakeholders
    5. **Focus particularly on version 0.1 capabilities** - what specific features are working, what the user can accomplish with the current implementation
    6. **Base the documentation entirely on the actual codebase** - don't assume features that aren't implemented

    Please first explore the codebase thoroughly to understand the project structure and implemented functionality before writing the documentation.
    ```

```json
自动帮我统计分析定位原因，并查找市面上最佳解决方案, 结合我的工程和最佳实践给我调研结果和选择方案产出文档放到 doc/feature
```

```json
优先使用nextjs pnpm 构建我的应用 要创建gitignore
```

- 刚开始编程

    ```json
    # 🎯 Cursor 开发指导提示词 - 基于测试MVP优先级

    ## 🔑 核心开发原则

    你是我的高级前端开发助手，需要严格按照以下优先级进行开发：

    ### 📊 开发优先级矩阵

    ```
    优先级 P0 (立即开发) 🔴：前端可视验证功能
    优先级 P1 (当日完成) 🟡：核心用户体验功能  
    优先级 P2 (本周完成) 🟢：增强功能和优化
    优先级 P3 (后续迭代) 🔵：高级功能和集成
    ```

    ## 🎯 当前开发重点：

    ### P0 优先级 - 前端验证必须功能 🔴

    **核心原则：看到即相信 - 浏览器实际可视验证**

    ## 🔍 开发验证标准

    ### 必须验证检查清单

    每完成一个功能，必须进行以下验证：

    #### 1. 浏览器实际验证 ⭐ **最重要**
    ```bash
    ✅ 在Chrome/Firefox/Safari中实际打开页面
    ✅ 测试所有交互功能（点击、hover、输入）
    ✅ 验证数据正确显示和更新
    ✅ 检查响应式布局
    ✅ 验证错误处理机制
    ```

    #### 2. 功能完整性验证
    ```bash
    ✅ 功能按预期工作
    ✅ 边界情况处理正确
    ✅ 错误提示用户友好
    ✅ 性能表现良好（加载速度、响应速度）
    ```

    #### 3. 代码质量验证
    ```bash
    ✅ 代码遵循项目规范
    ✅ 适当的错误处理
    ✅ 必要的注释和文档
    ✅ 没有console.log等调试代码
    ```

    ## 📋 开发执行模板

    ### 每次开发任务的执行流程：

    ```markdown
    ## 当前开发任务：[具体功能名称]

    ### 📍 优先级：P[0/1/2/3] - [紧急程度说明]

    ### 🎯 功能需求：
    - [ ] 具体需求1
    - [ ] 具体需求2  
    - [ ] 具体需求3

    ### 🔍 验证计划：
    1. **浏览器验证**：
       - [ ] 在[浏览器]中测试[具体功能]
       - [ ] 验证[具体交互行为]

    2. **功能验证**：
       - [ ] 正常流程测试
       - [ ] 异常情况测试

    3. **性能验证**：
       - [ ] 加载时间 < 2秒
       - [ ] 交互响应 < 500ms

    ### ✅ 完成标准：
    - [ ] 浏览器实际验证通过
    - [ ] 功能完整性验证通过  
    - [ ] 代码质量验证通过

    ###问题记录：需要讲遇到的问题记录到对应的doc问题文件夹中
    ###文档记录：doc需要一个readme，并记录相关需要阅读的文档链接
    ```

    ## 🚀 开发提效要求

    ### 对Cursor的具体要求：

    1. **优先级驱动**：始终按P0→P1→P2→P3顺序开发
    2. **验证优先**：每个功能必须先通过浏览器验证再继续下一个
    3. **MVP思维**：P0、P1功能保持简洁有效，避免过度设计
    4. **渐进增强**：先实现基础功能，再逐步添加高级特性
    5. **用户体验**：所有交互必须直观、快速、可靠

    ### 代码风格参考：

    ```typescript
    // 🎯 功能导向的代码组织
    export const ProjectCard = ({ project, onEdit, onDelete }: ProjectCardProps) => {
      // P0: 基础显示逻辑
      const displayInfo = useMemo(() => ({
        title: project.title,
        status: project.status,
        progress: project.progress
      }), [project]);

      // P1: 交互逻辑
      const handleCardClick = useCallback(() => {
        router.push(`/projects/${project.id}`);
      }, [project.id]);

      // P0: 基础渲染（优先验证）
      return (
        <div className="project-card" onClick={handleCardClick}>
          <h3>{displayInfo.title}</h3>
          <span className={`status-${displayInfo.status}`}>
            {displayInfo.status}
          </span>
          {/* P1: 交互按钮 */}
          <div className="card-actions">
            <button onClick={onEdit}>编辑</button>
            <button onClick={onDelete}>删除</button>
          </div>
        </div>
      );
    };
    ```

    ---

    **📝 使用说明**：
    - 每次开发时，请明确当前任务的优先级
    - 完成P0功能后再进行P1，依此类推
    - 每个功能完成后必须进行浏览器实际验证
    - 遇到问题时，优先保证高优先级功能的稳定性

    **🔄 迭代原则**：快速交付可用功能 → 用户验证反馈 → 持续改进优化
    ```

- 编程了一段时间

    ```hcl
    作为一名资深前端工程师，我需要你对我当前的项目进行全面的工程评估和改进计划。请遵循以下系统化方法：

    **第一阶段：现状分析**
    - 使用 `codebase-retrieval` 工具分析我在的现有代码库结构和组织方式
    - 使用 `view` 工具审查 `doc/develope-method/` 目录中的当前开发方法论文档
    - 评估我的 React/Next.js 项目架构和组件模式，特别关注：
      - 组件设计模式（状态驱动 vs DOM 操作）
      - 文件组织结构和命名约定
      - 依赖管理和包管理策略
    - 评估现有测试策略（单元测试、Playwright 端到端测试）

    **第二阶段：最佳实践研究**
    - 使用 `web-search` 工具研究 2024-2025 年前端工程最佳实践，具体包括：
      - React/Next.js 项目结构和架构模式
      - AI 辅助开发工作流程和代码质量标准
      - 现代 React 应用测试策略（单元、集成、端到端）
      - 代码可维护性和技术债务管理
      - 文档和方法论维护实践
      - 性能优化和调试方法论

    **第三阶段：差距分析和优先级任务创建**
    - 对比我当前的实践与行业最佳实践
    - 识别具体的差距和改进机会
    - 使用 `add_tasks` 工具创建优先级任务列表，采用 P0-P3 优先级：
      - P0：影响开发效率或代码质量的关键问题
      - P1：可维护性的高优先级改进
      - P2：优化和增强机会
      - P3：需要设计评估的改进项目
    - 使用 `save-file` 工具在 `doc/feature/2025-01-16-engineering-assessment/` 目录中记录发现，包含技术分析

    **第四阶段：实施路线图**
    - 为每个识别的问题提供具体、可操作的建议
    - 包含与我偏好的系统化、架构优先方法一致的实施策略
    - 考虑我现有的技术栈（React、Next.js、Playwright、Mermaid）和开发模式
    - 确保建议支持我对全面文档和结构化问题解决的偏好
    - 提供具体的验证计划和成功标准

    **预期交付物：**
    1. 当前状态评估报告（保存在 `doc/feature/2025-01-16-engineering-assessment/01-current-state.md`）
    2. 最佳实践研究总结（保存在 `doc/feature/2025-01-16-engineering-assessment/02-best-practices.md`）
    3. 带有明确验收标准的优先级改进任务列表（使用任务管理工具创建）
    4. 具体下一步的实施路线图（保存在 `doc/feature/2025-01-16-engineering-assessment/03-roadmap.md`）
    5. 更新的开发方法论建议（保存在 `doc/develope-method/` 相应文件中）

    **执行要求：**
    - 专注于增强长期可维护性的实用、可实施解决方案，而非快速修复
    - 遵循我的系统化 5 阶段问题解决方法论
    - 优先考虑架构级别的根本原因分析，而非表面症状修复
    - 包含真实浏览器验证和证据驱动的分析
    - 使用我偏好的文档结构和命名约定（YYYY-MM-DD 格式）
    - 确保所有建议与 React/Next.js 虚拟 DOM 兼容，避免直接 DOM 操作

    请立即开始第一阶段的分析，并在每个阶段完成后更新任务状态。
    并将相关内容记录在合适的目录文件夹
    ```

- 一个问题一直无法修复，创建单元测试

    ```hcl
    中文跟回复我 发现一个很大的问题 我的用户表和工程表看起来没有建立链接 也就是说每个用户看到的是一样的这不对
    请专业的开发评估如何修改这里，联网查找最佳实践，逐步拆解任务实现，要满足能够创建新的工程，notion要写入数据库，删除项目时也要删除notion数据库，创建Vitest单元测试，自动跑用例 而不是每次都要我手动操作
    ```

```hcl

我觉得这两个操作栏非常重复，专业的交互设计师评估一下怎么调整，悬浮的这个操作了有时候会遮挡 不好 考虑一下一起放上面，再者下载功能目前不可用，

专业的开发工程师，各个功能点加一下单元测试，保证跑通，小屏幕适配分屏视图，在合适的区域增加一个工作台，用于放置不同内容的流程图，每个流程图需要历史记录记录版本，都存储在local storage，遵循这个工程的最佳实践 zustand状态管理
```

Examples

Tips

Related Prompts