repo-engineer

repo-engineer 是一个自主的仓库工程师，充当经过验证、使用工具的编码智能体。给定一个小型仓库和一项工程任务，它会检查仓库、制定计划、通过经过校验的工具编辑文件、运行测试套件、观察失败、重新规划，并且只有在验证套件全部通过时才宣布成功。核心设计规则是：规划者提议，运行时裁决——LLM 或脚本化策略只输出工具调用提议，而确定性状态机会根据模式校验每次调用、检查权限、把每条路径限制在工作区内、强制执行步数和重新规划预算，除测试套件外不信任任何东西。该系统通过模式校验、使用白名单命令前缀的无 shell 工具，以及重新运行套件的 VERIFY 状态，解决了 AI 智能体演示中常见的失败模式，如格式错误的工具调用、任意的 shell 访问和未经验证的声明。它包含两种基准模式：使用 ScriptedPlanner 的确定性模式，在隔离的工作区副本中运行四项软件工程任务；以及使用 LLMPlanner 和 gemini-2.5-flash 的真实 LLM 模式。结果分别记录在 results/benchmark_results.json 和 results/llm_benchmark_results.json 中。该项目用 Python 实现，没有第三方运行时依赖，并附有技术报告和测试。