lijianfei.com

双层架构体系及方法是一种非常系统化且高效的开发和问题解决策略，尤其在面对复杂需求时，通过明确分工和资源优化，能显著提升效率。

一、架构核心思想解析

1. 双层角色分工：

   • Claude（软件架构师）：负责高层次设计与问题拆解，类似于技术总监的角色。
   • bolt.new（执行开发者）：执行具体的开发任务，直接转化 Claude 提供的设计和策略。

2. 明确职责：

   • Claude 聚焦于规划、设计、优化，避免进入实现细节。
   • bolt.new 专注于快速执行、精确实现 Claude 提供的指令。

3. 目标：降低 token 消耗的同时，提升非开发者解决复杂技术问题的能力。

二、优化策略细化

1. 文件结构管理

• 文件地图（fileNames.md）：

  • 目标：将项目全局文件和文件夹结构清晰可见。
  • 格式建议：

    src/
      components/
        Header.jsx - 顶部导航栏组件
        Footer.jsx - 页脚组件
      utils/
        api.js - API 请求工具函数
    assets/
      images/ - 存放图片资源
    README.md - 项目介绍及启动指南
    

  • 额外内容：对于大型项目，可添加文件间的依赖关系说明。

• 组件功能说明：

  • 为每个组件、模块提供一段简短的描述，便于快速理解用途和定位。

2. Claude 项目设置

在 Claude 中为项目设置专门环境，形成一个闭环：

• 必要内容：

  • 完整的文件结构描述。
  • 功能需求文档（Functional Requirement Document, FRD），包括用户流程、系统行为。
  • 按用户流程分组的需求：以场景驱动，明确每个功能点对应的用户需求。

• 用途扩展：

  • 使用 Claude 来生成优化的 bolt.new 提示，确保开发者执行更加精准。
  • Claude 可以充当代码审查员，帮助快速定位 Bug 或逻辑问题。

3. 问题解决流程

• 系统提示（System Prompt）：

  • 定义上下文，例如：

    "你是 Claude，当前项目是一个电商平台，包含前端和后端模块。以下是文件结构，请协助分析问题并优化开发提示。"

• 执行提示（Action Prompt）：

  • 提出具体问题，例如：

    "用户反馈订单详情页加载缓慢，请检查相关组件并建议优化方案。"

• Claude 输出内容：

  • 文件相关性分析：定位问题涉及的文件。
  • 优化指令：为 bolt.new 生成更高效的提示。
  • 操作步骤：提供可行的修复方案。

4. Token 使用优化

• .bolt/ignore：

  • 配置忽略文件列表，避免对不必要文件进行分析。
  • 示例配置：

    node_modules/
    dist/
    *.log
    

• 合并多次对话：

  • 通过提前规划问题，将多次询问压缩到一次对话内，减少 context token 的消耗。
  • 例如，将 3-4 个相关问题合并成一组。

• 定期清理无用内容：

  • 定期清理无关的上下文信息，只保留核心问题描述和目标。

三、优势进一步提升

1. 开发路径更清晰：

   • 文件结构文档和需求分组提供了清晰的参考，减少了开发过程中的迷失时间。

2. Token 使用效率提高：

   • 通过忽略文件和系统提示优化，能有效减少 token 消耗。

3. 支持复杂项目需求：

   • 双层架构能灵活应对需求变更，Claude 的架构能力与 bolt.new 的执行能力相辅相成。

通过这种方法，非技术背景的用户可以通过 Claude 和 bolt.new 的配合，更加从容地解决复杂开发问题，并进一步优化 token 使用效率，是一个极具实践价值的开发策略。