开源工具包repomix提取代码框架信息

第一阶段：环境准备 (仅需做一次)

核心原则：不要使用系统级 (apt/sudo) 的 Node.js，避免权限和版本问题。一切都在 Conda 环境内闭环。

1. 激活 Conda 环境

   conda activate leapsim# 替换为你的环境名

2. 安装 Node.js (推荐 v18 或 v20)

   condainstall-c conda-forgenodejs=20

3. 安装 Repomix 工具

   npminstall-g repomix

第二阶段：提取代码骨架 (每次项目变更后执行)

核心原则：使用 XML 格式（AI 易读），去除空行（省 Token），并通过忽略文件保持干净。

1. 进入项目根目录

   cd/path/to/your/project

2. 配置忽略文件 (可选但推荐)
   如果不想把垃圾文件喂给 AI，新建.repomixignore并写入：

   node_modules/** .git/** __pycache__/** *.lock *.log

3. 一键打包代码

   repomix --style xml --remove-empty-lines

   • 产出物：repomix-output.xml

第三阶段：AI 交互提示词 (Prompt Engineering)

拿到 XML 文件后，分两步与 AI 交互。

1. 第一步：让 AI 建立“大脑索引” (理解架构)

目的：让 AI 读完代码后，生成一份它自己的“理解文档”，防止它读了后边忘前边。

Prompt 模板：
“我上传了一份名为repomix-output.xml的文件，这是我项目的完整代码快照。

请阅读该文件，并扮演一位资深架构师，为我生成一份【项目核心架构文档】。文档需包含：

1. 目录结构树：关键文件及其作用。
2. 核心类与关系：主要 Class 的职责，以及它们是如何交互的。
3. 数据流向：核心业务数据（如电机角度、控制指令）是如何在系统中流转的。
4. 技术栈与依赖：关键的第三方库和协议说明。

注意：请不要输出代码细节，我需要的是高层的逻辑梳理，作为后续开发的上下文参考。”

2. 第二步：基于索引进行开发 (编写代码)

目的：在 AI 理解架构的基础上，下达具体指令。

Prompt 模板：
“基于你刚才对repomix-output.xml的理解（以及生成的架构文档），我需要增加一个新功能。

需求描述：
[在这里写你的需求，例如：在 main.py 中增加一个校准模式，让电机进入低刚度状态]

具体要求：

1. 指出需要修改哪些文件。
2. 请给出具体的修改代码片段（diff 格式或完整函数）。
3. 解释你的代码是如何调用底层的DynamixelClient或leap_hand_utils的。
4. 确保新代码符合项目中已有的代码风格和命名规范。”

配套的 Prompt（提示词）：

请阅读该文件，并基于此生成一份高层架构文档（README style）。文档应包含：

项目目录结构：用树状图表示。

核心模块说明：解释主要文件的作用。

数据流向：核心业务逻辑是如何在各个文件间流转的。

生成这份文档后，后续我会有具体的功能修改需求。”