人工智能大模型AI Agent代码智能体【免费下载链接】mini-swe-agentThe 100 line AI agent that solves GitHub issues or helps you in your command line. Radically simple, no huge configs, no giant monorepo—but scores 74% on SWE-bench verified!项目地址https://gitcode.com/gh_mirrors/mi/mini-swe-agent点击查看免费下载本文是 mini-swe-agent 开源仓库的贡献者技术指南。mini-swe-agent 是一个百行级的 AI 软件工程代理用约 100 行核心代码即可驱动大模型完成 GitHub issue 修复与命令行编程任务其项目定位是极简、可 hack、高质量见 AGENTS.md。读完本文你将掌握项目需要哪些方向的帮助、四大组件agents / environments / models / run的扩展设计原则、本地开发环境的搭建方法、代码风格与测试编写规范、以及 commit message 与代码审查的团队约定从而以符合项目社区期望的方式提交你的第一份代码。一、哪些领域最需要贡献Areas of help官方贡献文档docs/contributing.md明确欢迎各类贡献并优先列出以下四个方向从轻量到深度递增适合不同投入程度的贡献者文档、示例与教程包括说明文档、使用示例、教程等。项目尤其缺少两类内容该库在真实项目中被使用的案例used in the wild 示例补充 cookbook 配方 中混合搭配四大组件的更多示例。更多模型支持凡是litellm不能开箱即用的模型都欢迎新增模型接口。从源码结构看模型层位于 src/minisweagent/models内置了 litellm、openrouter、portkey、requesty 等实现并在 模型选择模块 中以_MODEL_CLASS_MAPPING维护短名 → 类路径的映射新增模型类即可扩展。更多环境与部署方式例如将 mini-swe-agent 作为 GitHub Action 运行等。环境层位于 src/minisweagent/environments已有 docker、local、singularity、bubblewrap、contree、swerex 等多种实现。参与 issue 修复关注仓库 issue 中标记为good-first-issue或help-wanted的条目——注意先阅读本文与社区规范。二、设计与架构原则先理解哲学再动手contributing.md 强调mini-swe-agent 的设计目标是保持极简minimalistic、可 hackhackable、高质量high quality。这三点直接决定了你该如何写代码优先新增组件版本而非给现有组件加复杂度要扩展功能时项目偏好新增四大组件之一的新版本例如新的 agent 类、新的环境类而不是把既有组件改得越来越复杂。组件替换示例可参考 cookbook 的 Mix match 章节。组件相对自包含共享工具放utils文件夹如果新代码有可复用的工具函数放入utils子目录例如 src/minisweagent/models/utils内含 actions 解析、cache_control、retry 等模块。但要保持简单。更专门的组件放入extra文件夹如果你的组件比较特定如某个特殊环境、特殊运行工具放入extra子目录例如 src/minisweagent/run/extra。从 pyproject.toml 的依赖分组看extra下的功能通常对应可选依赖如swe-rex、modal、contree-sdk不会被默认安装。目标受众是会改代码的开发者项目的目标用户是不害怕修改一点代码尤其是 run 脚本来达成目标的人。因此并不是所有东西都需要做成配置文件可配置——配置搞不定的场景应该让开发者能轻松写一个 run 脚本用起来。run 脚本src/minisweagent/run就是项目的入口层例如最简单的 hello_world.py。模型输出要清理许多大模型会生成非常啰嗦的代码提交前请清理干净测试代码同样要求简洁可读。提交前必须跑 pre-commit安装并运行pre-commit以强制执行项目风格规范。2.1 四大组件与多态设计的源码印证仓库的 src/minisweagent/init.py 定义了三个核心 Protocol协议接口这是理解为什么可以随意换组件的关键Model负责query查询模型、format_message格式化消息、format_observation_messages把命令输出格式化为观测消息、get_template_vars、serializeEnvironment负责execute执行 agent 的动作返回输出、get_template_vars、serializeAgent负责run(task)驱动整个循环、save。由于 Python 协议与鸭子类型的存在任何实现了这些接口的类都可以无缝接入。默认实现分别是 DefaultAgent、LocalEnvironment 与 litellm 模型。而run脚本就是挑选一个 agent 一个 environment 一个 model把它们绑起来的入口例如 hello_world.py 用 typer 接收任务与模型参数然后组合DefaultAgent(LitellmModel(...), LocalEnvironment(), **yaml 配置)运行。三、开发环境搭建Development setupcontributing.md 要求先按 quickstart 的开发安装方式 完成环境搭建推荐从源码安装以便贡献git clone https://github.com/SWE-agent/mini-swe-agent.git cd mini-swe-agent pip install -e .[dev] # 安装包本体 开发依赖 pip install pre-commit pre-commit install # 安装并启用 pre-commit 钩子关于[dev]依赖可在 pyproject.toml 的 optional-dependencies 中看到完整清单主要包括pytest、pytest-cov、pytest-asyncio、pytest-xdist并行测试、pre-commit、rufflint 格式化、以及 mkdocs 相关文档构建工具。若想装齐所有可选功能可改用pip install -e .[full]会额外引入 swe-rex、modal、contree 等extra模块依赖。3.1 pre-commit 钩子都检查什么从仓库根目录的 .pre-commit-config.yaml 可以看到实际生效的钩子链钩子作用check-added-large-files/check-case-conflict/check-merge-conflict/check-symlinks/mixed-line-ending/detect-private-key/trailing-whitespace通用仓库卫生检查大文件、大小写冲突、合并冲突、尾随空白、密钥泄漏等typos对py/md/rst/yaml/toml文件做拼写检查pyproject.toml除外ruff--fixlint 并自动修复ruff-format代码格式化风格类似 Black双引号、空格缩进、magic trailing commaprettier格式化 JS/CSS 文件3.2 运行测试pytest -n auto环境就绪后在仓库根目录运行pytest -n auto-n auto借助 pytest-xdist 把测试分发到所有 CPU 核心上并行执行以加速。从 pyproject.toml 的 pytest 配置 可以看到测试约定asyncio_mode auto无需手动标记 async 测试、默认function级 asyncio fixture 作用域并定义了slow标记可用pytest -k not slow跳过慢测试。测试代码分布在 tests 目录按agents、environments、models、run、config、utils与源码结构一一对应例如 tests/agents/test_default.py、tests/run/test_swebench.py 等。四、代码风格指南把极简落到实处contributing.md 要求提交前运行 pre-commit 强制执行风格指南而更细的规则记录在 AGENTS.md 的 Style guide 章节要点如下目标 Python3.10 及以上与 pyproject.toml 的requires-python 3.10一致使用类型注解用list/dict等内建泛型而非List/Dict用pathlib而非os.path用Path.read_text()而非with ... open()结构命令行接口用typer编写run 脚本如 hello_world.py 正是如此代码注释保持最少只标注逻辑上有挑战性的地方除非明确要求不要往 README 追加内容格式化模板system prompt 等用jinja可见 default.yaml 中的模板语法配置跟踪用dataclass源码中实际用 pydantic 的BaseModel见 AgentConfig 与 LocalEnvironmentConfigpydantic 提供 dataclass 类似能力并支持默认值安全校验除非明确要求不要捕获异常——异常是向用户暴露问题的好方式写简洁、简短、极简的代码大多数情况下避免先初始化变量再传给函数直接把表达式传给函数即可。规则 11 的正反示例引自 AGENTS.md# bad多余的中间变量 a func() Class(a) # good直接传递表达式 Class(func())项目还要求行宽不超过 120 字符pyproject.toml并使用 ruff 执行Epycodestyle 错误、Fpyflakes、Iisort、UPpyupgrade、PTHuse-pathlib等一系列 lint 规则——这些正是 pre-commit 中ruff --fix强制的内容。五、测试编写规范不 mock、不琐碎、极简AGENTS.md 的 Test style 章节对测试提出了与极简代码一致的严格要求使用pytest不用unittest不要 mock/patch任何未明确要求 mock 的东西强约束避免琐碎测试每个测试至少要覆盖一个、最好多个失败点不要把断言拆成多行直接assert func() b一行完成pytest.mark.parametrize的第一个参数必须是元组不是字符串、不是列表第二个参数必须是列表不是元组。规则 4 的正反示例引自 AGENTS.md# bad result func() assert result b # good assert func() b这些约定让测试库保持短小、可读且真正有断言价值与整个仓库奖励极简代码的价值观一脉相承。六、提交信息与代码审查规范6.1 Commit message 格式贡献者需使用带前缀的约定式提交格式前缀即意图前缀适用场景ci:测试相关改动、GitHub workflow 改动dev:开发相关改动如 cursor / claude 规则更新fix(component):缺陷修复feat(component):新功能enh(component):增强改进docs:文档ref(component):重构chore:维护类任务pre-commit 钩子、imports 等描述应聚焦**变更意图intent**而非实现细节。注意硬性要求禁止在 commit message 或 trailer 中添加Co-authored-by: Cursor行。6.2 组件命名component 前缀fix/feat/enh/ref提交的括号内需使用以下组件名models— 模型接口改动litellm、anthropic、openai、portkey、openrouteragents— agent 类改动default、interactive、multimodalenv— 环境改动docker、local、singularity、bubblewrap、swerexconfig— 配置文件或配置处理改动run— run 脚本改动mini、hello_worldbenchmarks— benchmark 运行器改动swebench、inspectorcli— CLI 参数处理改动deps— 依赖更新6.3 Review 时的关注点准备提交前应标记必须解决的关键问题不要纠结风格或小改动任何可能以非预期方式引发未处理异常的问题任何逻辑错误或不一致对协议/接口的破坏性变更而没有同步更新所有实现这正是 src/minisweagent/init.py 中Model/Environment/Agent三个 Protocol 的意义——改动接口必须保证全部实现类跟上。唯一被视为次要风格问题的项是import 未放在文件顶部。七、上手前建议先读懂的源码地图作为贡献者理解下面这些文件能让你更快进入状态协议层src/minisweagent/init.py — 三大 Protocol、全局配置文件路径MSWEA_GLOBAL_CONFIG_DIR或 platformdirs 用户配置目录下的.env、版本号当前2.4.6Agent 循环src/minisweagent/agents/default.py —DefaultAgent.run循环调用stepexecute_actions(self.query())直到出现role exit的消息AgentConfig提供step_limit、cost_limit、wall_time_limit_seconds、max_consecutive_format_errors、output_path等控制参数异常控制流的细节见 控制流文档异常体系src/minisweagent/exceptions.py —InterruptAgentFlow基类派生Submitted、LimitsExceeded、TimeExceeded、UserInterruption、FormatError这些异常携带要加入轨迹的消息是用异常做控制流的具体实现模型选择src/minisweagent/models/init.py —get_model支持从参数、配置、MSWEA_MODEL_NAME环境变量解析模型名并按_MODEL_CLASS_MAPPING选择实现类GlobalModelStats支持全局成本/调用数上限MSWEA_GLOBAL_COST_LIMIT/MSWEA_GLOBAL_CALL_LIMIT环境实现src/minisweagent/environments/local.py —LocalEnvironment.execute用子进程执行 bash超时默认 30s时杀掉整个进程组防止孤儿进程并通过_check_finished识别COMPLETE_TASK_AND_SUBMIT_FINAL_OUTPUT魔法字符串触发Submittedrun 脚本范例src/minisweagent/run/hello_world.py — 最简 python 绑定示例展示 typer CLI YAML 配置 组件装配的完整套路扩展配方docs/advanced/cookbook.md — 子类化 agent / environment 实现自定义动作如执行 python 函数、遇到submit退出、动作校验的现成示例是新增组件版本哲学的实践模板。结语mini-swe-agent 的贡献流程可以浓缩为四步读懂四大组件的多态设计 → 按新增版本而非加复杂度的原则写代码 → 用 pre-commit pytest -n auto保证质量 → 按前缀(组件): 意图描述的格式提交。官方贡献文档docs/contributing.md与 AGENTS.md 共同构成了这套极简主义工程文化的完整规范——保持代码短小、可读、可 hack就是你为这个项目做的最好贡献。赞分享人工智能大模型AI Agent代码智能体【免费下载链接】mini-swe-agentThe 100 line AI agent that solves GitHub issues or helps you in your command line. Radically simple, no huge configs, no giant monorepo—but scores 74% on SWE-bench verified!项目地址https://gitcode.com/gh_mirrors/mi/mini-swe-agent点击查看免费下载相关推荐Huashu Design Launch Film 工作流指南先写万字导演稿再做30秒品牌宣传片的完整方法论Huashu Design Launch Film 工作流指南先写万字导演稿再做30秒品牌宣传片的完整方法论 Huashu Design 是一个跑在 ClaAI 技能BRVAH发布与混淆指南proguard-rules配置与Maven Central发布完整流程BRVAH发布与混淆指南proguard rules配置与Maven Central发布完整流程 BRVAHBaseRecyclerViewAndroidH移动开发UI组件Pyrefly 仓库 Agent 开发与贡献指南从架构概览到代码提交的完整规范Pyrefly 仓库 Agent 开发与贡献指南从架构概览到代码提交的完整规范 本篇技术指南以 Pyrefly 仓库中的 .llms/rules/agents开发工具静态分析IDE代码质量上一篇Unitree Go2 ROS2 SDK架构深度解析异步控制与多协议通信系统设计下一篇如何用DDrawCompat解决经典DirectX游戏在Windows 10/11上的兼容性问题创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考