[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-981":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":13,"stars7d":16,"stars30d":17,"stars90d":15,"forks30d":15,"starsTrendScore":18,"compositeScore":19,"rankGlobal":9,"rankLanguage":9,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":23,"hasPages":21,"topics":24,"createdAt":9,"pushedAt":9,"updatedAt":25,"readmeContent":26,"aiSummary":27,"trendingCount":15,"starSnapshotCount":15,"syncStatus":28,"lastSyncTime":29,"discoverSource":30},981,"autoresearch","smallnest\u002Fautoresearch","smallnest","autodevelop： autoresearch for software development",null,"Shell",542,61,3,1,0,10,72,9,9.38,"MIT License",false,"master",true,[],"2026-06-12 02:00:21","# Autoresearch for Software Development\n![](docs\u002Fautoresearch.png)\n\n> 全自动化软件开发工具，你只需负责喝茶和睡觉。\n> 一觉醒来，Features 全自动高质量的实现了。\n\n![宣传视频](docs\u002Fautoresearch-promo-cn.gif)\n\n基于 [karpathy\u002Fautoresearch](https:\u002F\u002Fgithub.com\u002Fkarpathy\u002Fautoresearch) 思想实现的通用的全自动化开发工具。支持 **GitHub Issue**、**本地 Issue** 和**百度 iCafe** 四种模式，适用于任意 Git 项目（Go、Node.js、Python、Rust、Java 等）。\n\n使用 autoresearch 实现本项目 Issue#2：\n[![asciicast](https:\u002F\u002Fasciinema.org\u002Fa\u002FKdHGFHK6pcelUdPg.svg)](https:\u002F\u002Fasciinema.org\u002Fa\u002FKdHGFHK6pcelUdPg)\n\n---\n\n## 目录\n\n- [快速开始](#快速开始)\n- [前置条件](#前置条件)\n- [项目架构](#项目架构)\n- [工作流程](#工作流程)\n- [本地 Issue 模式](#本地-issue-模式)\n- [百度 iCafe 模式](#百度-icafe-模式)\n- [阿里云效 Codeup 模式](#阿里云效-codeup-模式)\n- [工具配置](#工具配置)\n- [与 ralph 对比](#与-ralph-对比)\n\n---\n\n## 快速开始\n\n```bash\n# 下载项目\ngit clone git@github.com:smallnest\u002Fautoresearch.git\n\n# 处理当前目录项目的 Issue#10\nautoresearch\u002Frun.sh 10\n\n# 处理指定目录项目的 Issue#10\nautoresearch\u002Frun.sh -p \u002Fpath\u002Fto\u002Fproject 10\n\n# 指定最大迭代次数为 16 次\nautoresearch\u002Frun.sh -p \u002Fpath\u002Fto\u002Fproject 10 16\n\n# 调整达标线为 90 分\nPASSING_SCORE=90 autoresearch\u002Frun.sh 10\n\n# 指定启用的 agents 及顺序（首个 agent 做初始实现）\nautoresearch\u002Frun.sh -a claude,codex 10\n\n# 继续处理 Issue#42，追加 10 次迭代\nautoresearch\u002Frun.sh -c 42 10\n\n# 处理本地 Issue #8（从 .autoresearch\u002Fissues\u002F 读取）\nautoresearch\u002Frun.sh --issues-dir=.autoresearch\u002Fissues 8\n\n# 百度 iCafe 模式（卡片 #22210）\nautoresearch\u002Frun.sh --issue-source=baidu --space=cloud-iCafe 22210\n\n# 阿里云效 Codeup 模式（Issue #42）\nautoresearch\u002Frun.sh --issue-source=codeup --codeup-token=xxx --codeup-org=123 --codeup-repo=456 42\n```\n\n## 前置条件\n\n需要安装以下工具（按需安装）：\n\n```bash\ngh auth status          # GitHub CLI（仅 GitHub 模式需要）\nicafe-cli whoami        # iCafe CLI（仅百度模式需要）\nicode-cli whoami        # iCode CLI（仅百度模式需要）\ncurl --version          # 阿里云效 Codeup 模式需要 curl\nwhich claude            # Claude Code CLI\nwhich codex             # OpenAI Codex CLI\nwhich opencode          # OpenCode CLI\n```\n\n项目需有对应语言的构建工具（Go\u002FNode\u002FPython\u002FRust\u002FJava）。\n\n---\n\n## 项目架构\n\n![](docs\u002Farchitecture.png)\n\n核心流程：\n\n| 组件 | 说明 |\n|------|------|\n| **GitHub Issue \u002F 本地 Issue \u002F 百度 iCafe \u002F 阿里云效 Codeup** | 触发输入 |\n| **run.sh** | 核心运行器 |\n| **Claude \u002F Codex \u002F OpenCode** | 三个 Agent 轮转审核 |\n| **Score ≥ 85?** | 评分门控 |\n| **PASS** | 自动创建 PR → 合并 → 关闭 Issue |\n| **FAIL** | 进入下一轮迭代修复 |\n\nAgent 轮转公式：`(iter − 1) % N`\n\n---\n\n## 工作流程\n\n### 单 Issue 流程\n\n```\nIssue → 首个 Agent 实现 → 轮转审核+修复 → 自动 PR → 合并 → 关闭 Issue\n```\n\n- **迭代 1**: `-a` 列表中的第一个 agent 初始实现\n- **迭代 2+**: 所有启用的 agents 按顺序轮流审核并修复\n- 评分达标（默认 ≥ 85）后自动创建 PR、合并、评论并关闭 Issue\n\n### 推荐工作流：从 PRD 到自动实现\n\n完整端到端工作流：**PRD 生成 → Issue 拆分 → autoresearch 实现**\n\n```\nPRD 生成 → Issue 拆分与创建 → 选择 Issue → autoresearch 实现 → 选择下一个 Issue → ...\n```\n\n![](docs\u002Fworkflow.png)\n\n#### Step 1: 生成 PRD\n\n使用 `\u002Fprd` skill 生成交付需求文档：\n\n```\n\u002Fprd 为本项目创建一个桌面 app\n```\n\n#### Step 2: 拆分为 GitHub Issues\n\n让智能体基于 PRD 拆分 Issue：\n\n```text\n基于 PRD 中的 User Stories 拆分为细粒度 Issue，并在 GitHub 上创建这些 issue。\n\n拆分原则：\n- 每个 Issue 可在单次开发会话中完成\n- 有明确的验收标准（checkbox）\n- 标注依赖关系\n```\n\n#### Step 3: 选择 Issue 并自动实现\n\n```bash\n.\u002Frun.sh 22\n```\n\nautoresearch 会：\n1. 规划阶段：拆分 subtasks（如需要）\n2. 迭代实现：首个 agent 实现 → 轮转审核 → 修复 → 评分\n3. 质量门禁：Build\u002FLint\u002FTest + LLM 评分 ≥ 85\n4. 自动收尾：创建 PR → 合并 → 评论 Issue → 关闭 Issue\n\n#### 完整示例\n\n以本项目 Desktop App 为例：19 个 Issues (#22 ~ #40) 从 PRD 到全部实现。\n\n详细过程见 [docs\u002Fdesktop-app-prd-to-issues.md](docs\u002Fdesktop-app-prd-to-issues.md)。\n\n---\n\n## 本地 Issue 模式\n\n除了从 GitHub 拉取 Issue，autoresearch 还支持从项目本地目录读取 Issue 文件，无需 GitHub 即可运行。适合本地项目、内网项目或不想创建 GitHub Issue 的场景。\n\n### 快速开始\n\n```bash\n# 1. 创建 issues 目录\nmkdir -p .autoresearch\u002Fissues\n\n# 2. 创建 Issue 文件（命名格式：issue-NNN-描述.md）\ncat > .autoresearch\u002Fissues\u002Fissue-008-add-login.md \u003C\u003C 'EOF'\n# 添加登录功能\n\n实现用户登录页面，包括：\n- 用户名\u002F密码输入框\n- 表单验证\n- 登录 API 调用\n- 错误提示\nEOF\n\n# 3. 运行（自动检测本地文件）\n.\u002Frun.sh 8\n```\n\n### Issue 文件格式\n\n- **位置**：`$PROJECT_ROOT\u002F.autoresearch\u002Fissues\u002F`（默认）或 `--issues-dir` 指定\n- **命名**：`issue-NNN-描述.md`，编号补零到 3 位（如 `issue-008-add-login.md`）\n- **内容**：第一个 `# 标题` 行作为 Issue 标题，其余内容作为 Issue 正文\n- **匹配**：CLI 传入的编号 `8` 会匹配 `issue-008-*.md` 或 `issue-8-*.md`\n\n### 运行结束后\n\n- 代码提交到本地分支（不推送远程、不创建 PR、不合并）\n- 处理结果自动追加到 Issue 文件末尾：\n\n```markdown\n---\n\n## 自动处理结果\n\n- **评分**: 92\u002F100\n- **迭代次数**: 3\n- **实现方式**: autoresearch 多 agent 迭代 (claude codex opencode)\n- **分支**: feature\u002Fissue-8\n- **完成时间**: 2026-04-27 15:30:00\n- 子任务: 2\u002F2 完成\n\n...日志内容...\n\n该 Issue 已由 autoresearch 自动实现。\n```\n\n### 命令行参数\n\n```bash\n# 自动检测模式（默认目录下有匹配文件即生效）\n.\u002Frun.sh 8\n\n# 手动指定 issues 目录\n.\u002Frun.sh --issues-dir=.autoresearch\u002Fissues 8\n\n# 指定项目路径 + 本地模式\n.\u002Frun.sh -p \u002Fpath\u002Fto\u002Fproject --issues-dir=.autoresearch\u002Fissues 8\n\n# 组合其他参数\n.\u002Frun.sh --issues-dir=.autoresearch\u002Fissues 8 10   # 最多迭代10次\n```\n\n### 与 GitHub 模式对比\n\n| | GitHub 模式 | 本地模式 | 百度 iCafe 模式 |\n|---|---|---|---|\n| Issue 来源 | `gh issue view` | 本地 `.md` 文件 | `icafe-cli card get` |\n| 需要 `gh` CLI | 是 | 否 | 否 |\n| 需要 GitHub remote | 是 | 否 | 否 |\n| 需要 `icafe-cli` \u002F `icode-cli` | 否 | 否 | 是 |\n| 推送\u002FPR\u002F合并 | 自动执行 | 不执行 | `push_cr` + `submit_review` |\n| 评论\u002F关闭 Issue | 自动执行 | 不执行 | 自动执行 |\n| 结果记录 | PR 评论 + 关闭 Issue | 追加到文件末尾 | CR 评论 + 关闭卡片 |\n\n### 模式自动切换\n\n两种模式完全兼容，互不影响：\n\n- 有匹配的本地 Issue 文件 → 自动进入本地模式\n- 没有本地文件 → 走 GitHub 流程（`gh issue view` → push → PR → merge → close）\n\n同一项目可以混合使用：\n\n```bash\n.\u002Frun.sh 8    # .autoresearch\u002Fissues\u002Fissue-008-*.md 存在 → 本地模式\n.\u002Frun.sh 42   # 没有对应的本地文件 → GitHub 模式\n```\n\n---\n\n## 百度 iCafe 模式\n\n百度模式使用 [iCafe](https:\u002F\u002Ficafe.baidu.com\u002F)（卡片管理）和 [iCode](https:\u002F\u002Ficode.baidu.com\u002F)（代码评审）替代 GitHub Issue\u002FPR 流程，适合百度内部项目。\n\n### 前置条件\n\n```bash\n# 安装并登录 icafe-cli\nicafe-cli login\n\n# 安装并登录 icode-cli\nicode-cli login\n\n# 项目 git remote 需指向 icode.baidu.com\ngit remote -v\n# origin  https:\u002F\u002Ficode.baidu.com\u002Fpath\u002Fto\u002Frepo (fetch)\n```\n\n### 快速开始\n\n```bash\n# 显式指定 baidu 模式 + 空间\n.\u002Frun.sh --issue-source=baidu --space=cloud-iCafe 22210\n\n# 指定最大迭代次数\n.\u002Frun.sh --issue-source=baidu --space=cloud-iCafe 22210 16\n\n# 指定 CR 目标分支（默认自动检测远程 HEAD，回退到 master）\n.\u002Frun.sh --issue-source=baidu --space=cloud-iCafe --target-branch=develop 22210\n\n# 使用环境变量设置空间\nexport ICAFE_SPACE=cloud-iCafe\n.\u002Frun.sh --issue-source=baidu 22210\n```\n\n### 自动检测\n\n如果同时满足以下两个条件，即使不指定 `--issue-source=baidu`，也会自动切换到百度模式：\n\n1. Git remote 包含 `icode.baidu.com`\n2. `--space` 参数或 `ICAFE_SPACE` 环境变量已设置\n\n```bash\n# 在 iCode 仓库中，设置环境变量即可自动识别\nexport ICAFE_SPACE=cloud-iCafe\n.\u002Frun.sh 22210  # 自动检测为 baidu 模式\n```\n\n### 工作流程\n\n```\niCafe 卡片 → Agent 实现 → 轮转审核+修复 → icode-cli push_cr → 评分 +2 → 合入 → 关闭卡片\n```\n\n与 GitHub 模式的主要区别：\n\n| 步骤 | GitHub 模式 | 百度 iCafe 模式 |\n|------|------------|----------------|\n| 获取 Issue | `gh issue view` | `icafe-cli card get` |\n| Commit 消息 | `feat: implement issue #N` | `{space}-{seq} [{type}] {title}` |\n| 创建 PR | `gh pr create` | `icode-cli git push_cr` |\n| 合并 | `gh pr merge` | `icode-cli api submit_review` |\n| 关闭 Issue | `gh issue close` | `icafe-cli card update --status 已关闭` |\n| 评论 | `gh issue comment` | `icafe-cli comment create` |\n\n### 命令行参数\n\n| 参数 | 说明 |\n|------|------|\n| `--issue-source=baidu` | 指定百度模式（也可自动检测） |\n| `--space=\u003CprefixCode>` | iCafe 空间前缀代码（baidu 模式必需） |\n| `--target-branch=\u003Cname>` | iCode CR 目标分支（默认自动检测） |\n| `ICAFE_SPACE` | 环境变量，等效于 `--space` |\n\n### 项目自定义配置\n\n在项目目录下创建 `.autoresearch\u002F`：\n\n```\n.autoresearch\u002F\n├── agents\u002F\n│   ├── codex.md          # 自定义 Codex 指令\n│   ├── claude.md         # 自定义 Claude 指令\n│   └── opencode.md       # 自定义 OpenCode 指令\n├── issues\u002F               # 本地 Issue 文件（issue-NNN-描述.md）\n├── program.md            # 自定义实现规则与约束\n├── workflows\u002F            # 各 Issue 详细记录（自动生成）\n└── results.tsv           # 处理结果日志（自动生成）\n```\n\n### 命令行参数\n\n| 参数 | 默认值 | 说明 |\n|------|--------|------|\n| `-p \u003Cpath>` | 当前目录 | 项目路径 |\n| `-a \u003Cagents>` | `claude,codex,opencode` | 指定启用 agents 及顺序 |\n| `-c` | 关闭 | 继续模式，从上次中断的迭代继续 |\n| `--issues-dir=\u003Cpath>` | `.autoresearch\u002Fissues` | 本地 Issue 目录（启用本地模式） |\n| `--issue-source=\u003Cmode>` | `github` | Issue 来源：`github` \u002F `local` \u002F `baidu` |\n| `--space=\u003CprefixCode>` | - | iCafe 空间前缀代码（baidu 模式必需） |\n| `--target-branch=\u003Cname>` | 自动检测 | iCode CR 目标分支 |\n| `PASSING_SCORE` | 85 | 达标评分线（百分制） |\n| `MAX_CONSECUTIVE_FAILURES` | 3 | 连续失败停止阈值 |\n| `MAX_RETRIES` | 5 | 单次 agent 调用重试次数 |\n\n### 裁剪 program.md\n\n`program.md` 包含多种语言的规范模板。使用前应根据目标项目语言裁剪，只保留相关规范以减少 token 消耗。\n\n**示例**：Go 后端项目只需保留「通用规范」和「Go 代码规范」章节，删除 Python\u002FTypeScript\u002FRust\u002F前端等无关章节。\n\n### 文件说明\n\n| 文件 | 用途 |\n|------|------|\n| `run.sh` | 主脚本 |\n| `lib\u002Fagent_logic.sh` | agent 列表解析与轮转共享逻辑 |\n| `program.md` | 默认实现规则与约束 |\n| `agents\u002F*.md` | Agent 提示词模板 |\n| `tests\u002Ftest_agent_logic.sh` | agent 选择与顺序逻辑测试 |\n\n\n---\n\n## 阿里云效 Codeup 模式\n\n阿里云效 Codeup 模式使用 [Codeup](https:\u002F\u002Fcodeup.aliyun.com\u002F)（代码托管）替代 GitHub Issue\u002FPR 流程，适合使用阿里云效的企业项目。\n\n### 前置条件\n\n```bash\n# 需要 Codeup Access Token\n# 在 Codeup 控制台 -> 设置 -> Access Token 中创建\nexport CODEUP_TOKEN=your_token_here\n\n# 需要组织 ID 和仓库 ID\n# 在 Codeup 项目设置页面可以看到\nexport CODEUP_ORG_ID=your_org_id\nexport CODEUP_REPO_ID=your_repo_id\n```\n\n### 快速开始\n\n```bash\n# 显式指定 codeup 模式\n.\u002Frun.sh --issue-source=codeup --codeup-token=xxx --codeup-org=123 --codeup-repo=456 42\n\n# 使用环境变量\nexport CODEUP_TOKEN=xxx\nexport CODEUP_ORG_ID=123\nexport CODEUP_REPO_ID=456\n.\u002Frun.sh --issue-source=codeup 42\n\n# 指定 MR 目标分支\n.\u002Frun.sh --issue-source=codeup --codeup-branch=develop 42\n\n# 批量处理所有未关闭的 Issues\n.\u002Frun_all.sh --issue-source=codeup --codeup-token=xxx --codeup-org=123 --codeup-repo=456\n```\n\n### 工作流程\n\n```\nCodeup Issue -> Agent 实现 -> 轮转审核+修复 -> 创建 MR -> 合入 -> 关闭 Issue\n```\n\n与 GitHub 模式的主要区别：\n\n| 步骤 | GitHub 模式 | 阿里云效 Codeup 模式 |\n|------|------------|---------------------|\n| 获取 Issue | `gh issue view` | Codeup REST API |\n| 创建 PR | `gh pr create` | Codeup REST API (Create MR) |\n| 合并 | `gh pr merge` | Codeup REST API (Merge MR) |\n| 关闭 Issue | `gh issue close` | Codeup REST API (Close Issue) |\n| 评论 | `gh issue comment` | Codeup REST API (Add Note) |\n\n### 命令行参数\n\n| 参数 | 说明 |\n|------|------|\n| `--issue-source=codeup` | 指定阿里云效 Codeup 模式 |\n| `--codeup-token=\u003Ctoken>` | Codeup Access Token（也可用 `CODEUP_TOKEN` 环境变量） |\n| `--codeup-org=\u003Corg_id>` | Codeup 组织 ID（也可用 `CODEUP_ORG_ID` 环境变量） |\n| `--codeup-repo=\u003Crepo_id>` | Codeup 仓库 ID（也可用 `CODEUP_REPO_ID` 环境变量） |\n| `--codeup-branch=\u003Cname>` | Codeup MR 目标分支（默认自动检测） |\n\n---\n\n## 与 ralph 对比\n\n[ralph](https:\u002F\u002Fgithub.com\u002Fsnarktank\u002Fralph) 是类似的自动化开发工具。\n\n### 核心差异\n\n| 维度 | **autoresearch** | **ralph** |\n|------|-----------------|-----------|\n| **驱动方式** | GitHub Issue \u002F 本地 Issue \u002F 百度 iCafe | PRD（`prd.json`） |\n| **Agent 模型** | 多 Agent 轮转交叉审核 | 单 Agent 反复迭代 |\n| **质量门禁** | 硬门禁（Build\u002FLint\u002FTest）+ 软门禁（LLM 评分） | 纯工具链检查 |\n| **审核机制** | 不同 Agent 交叉审核 | 无独立审核 |\n| **端到端** | Issue → PR → 合并 → 关闭（全自动闭环） | 止步于代码完成 |\n| **Continue 模式** | 支持 `-c` 恢复 | 无 |\n| **UI 验证** | 浏览器截图 + LLM 视觉验证 | `dev-browser` skill |\n\n### 各自优势\n\n**autoresearch 优势：**\n- 双轨质量门禁覆盖更广\n- 多 Agent 交叉审核提供不同视角\n- GitHub 端到端自动化闭环，也支持本地项目、百度 iCafe\u002FiCode 和阿里云效 Codeup 运行\n- 上下文溢出自动交接\n- Continue 模式支持中断恢复\n\n**ralph 优势：**\n- PRD 驱动，语义更丰富\n- 四通道记忆形成完整知识体系\n- 确定性质量门禁更稳定\n- Skills 插件系统可扩展\n- 内置流程序可视化\n\n---\n\n## 类似项目\n\n- [snarktank\u002Fralph](https:\u002F\u002Fgithub.com\u002Fsnarktank\u002Fralph)\n- [karpathy\u002Fautoresearch](https:\u002F\u002Fgithub.com\u002Fkarpathy\u002Fautoresearch)（原版思想）\n- [达尔文.skill](https:\u002F\u002Fgithub.com\u002Falchaincyf\u002Fdarwin-skill): 使用 autoresearch 优化Skill, 花叔出品\n- [TheGreenCedar\u002Fcodex-autoresearch](https:\u002F\u002Fgithub.com\u002FTheGreenCedar\u002Fcodex-autoresearch): A codex plugin for running optimization loops inside a codebase. \n- [pi-autoresearch](https:\u002F\u002Fgithub.com\u002Fdavebcn87\u002Fpi-autoresearch): Autonomous experiment loop extension for pi agent\n- [good night, have fun](https:\u002F\u002Fgithub.com\u002Fkunchenguid\u002Fgnhf): gnhf is a ralph, autoresearch-style orchestrator that keeps your agents running while you sleep ","autoresearch 是一个全自动化软件开发工具，旨在通过自动化流程实现高质量的软件功能开发。其核心功能包括支持多种模式（GitHub Issue、本地 Issue、百度 iCafe 和阿里云效 Codeup），能够处理任意 Git 项目（如 Go、Node.js、Python、Rust、Java 等）。技术上，该工具利用了多个智能 Agent（如 Claude、Codex 和 OpenCode）进行代码生成和审核，并通过评分机制确保代码质量达标后自动创建 Pull Request 并合并。适合需要提高开发效率、减少人工干预的软件开发场景，尤其适用于有明确需求文档和可拆分任务的项目中使用。",2,"2026-06-11 02:40:39","CREATED_QUERY"]