GitHub Trending

GitHub 热门项目

值得一看的开源项目,每个都有中文详解:它是什么、亮点在哪、怎么上手。点开任意一项看详情。

每天自动收录新项目 · 共 80 个项目

  1. 给 AI 编程助手用的工程技能集

    mattpocock/skills

    作者把自己日常做真实工程用的 AI 助手技能整理出来,帮你在动手前和 AI 对齐需求、建立共享术语、补上测试和调试反馈,避免只靠感觉写代码。

    本周 +9,664318kAgent 技能11月8日收录

    用 Claude Code、Codex 这类编程助手写代码的人,常遇到几种相似的挫败:AI 没弄懂你要什么,输出啰嗦,代码跑不起来,项目越写越乱。GitHub 项目 mattpocock/skills 就是作者把自己日常做真实工程时用的 AI 助手技能整理出来,帮你在动手前和 AI 对齐需求、建立共享术语、补上测试和调试反馈,而不是只靠感觉写代码。这些技能刻意做得小、易改、可组合,能配合任何模型使用。

    实际用法围绕几个命令展开。/grill-me 和 /grill-with-docs 会在动手前让 AI 反过来追问你的需求,后者还会帮你建立一份共享术语表,把项目里的行话固定下来,并把难以解释的决策记录成 ADR(架构决策记录,用来留存关键设计选择的文档)。/tdd 引导红-绿-重构的测试循环,也就是先写一个失败的测试再让它通过,然后整理代码;/diagnosing-bugs 把调试最佳实践做成分阶段流程。和 GSD、BMAD、Spec-Kit 这类接管整个流程的方案不同,它不夺走你的控制权,出问题也容易排查。

    上手方式是按你用的助手选一种安装:Claude Code、Codex、GitHub Copilot、Gemini CLI 各有对应命令,其他助手可以用 npx skills 安装,注意每个助手只装一种,否则技能会重复出现。装好后在每个仓库里运行一次 /setup-matt-pocock-skills,它会问你用哪种 issue 跟踪工具、打标签的习惯,以及文档保存位置。之后就可以按需调用这些技能,也可以随意改造成自己的。

    claude plugin install mattpocock-skills@claude-plugins-official
    npx skills@latest add mattpocock/skills -a
  2. 给编程助手装上开发方法论

    obra/superpowers

    让 AI 编程助手先问清需求、写规格和计划,再按任务分派子代理写代码并审查,避免一上来就乱写。

    本周 +4,466314kAgent 技能11月8日收录

    很多开发者用 AI 编程助手时都遇到过同一个问题:刚说一句需求,助手就开始噼里啪啦写代码,方向偏了再返工。GitHub 项目 obra/superpowers 想解决的就是这个毛病。它是一套面向 AI 编程助手的软件开发方法论,由一组可组合的“技能”和初始指令组成,让助手在动手前先停下来,问清你真正想做什么。

    它的工作方式从你启动助手那一刻开始。助手会先把需求聊成一份规格说明,再拆成小段给你确认,每段短到能真正读完;你认可设计后,它生成一份足够清晰的实施计划,强调红绿 TDD(先写失败的测试再写代码让它通过)、YAGNI(用不到的功能先不做)和 DRY(避免重复代码)。你说开始后,它用子代理逐个完成任务并检查审查,技能自动触发,不需要你手动调用。

    和常见做法相比,差别在于它把“先想清楚再写”变成了流程的一部分,而不是靠你反复提醒。子代理驱动开发让助手能按计划连续工作较长时间而不跑偏,每个任务完成后都有审查环节。这套技能会随对话自动生效,你不需要记住什么时候该调用哪一个。

    上手方式按你使用的工具而定:Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot CLI、OpenCode、Qwen Code 等都有对应入口,从各自的插件市场或仓库安装即可。如果你同时用多个工具,需要为每个工具单独安装一次。

    安装完成后正常启动助手开始对话就行,Superpowers 会自己接管流程。使用前最好想清楚自己要做什么,因为它的第一步就是追问需求,准备得越具体,后面的规格和计划就越贴近你的预期。

    /plugin install superpowers@claude-plugins-official
  3. 让 Claude 按固定流程完成专项任务的技能包

    anthropics/skills

    把完成某类任务所需的指令、脚本和资源打包成文件夹,让 Claude 按可重复的方式处理文档、数据分析和自动化任务。

    本周 +2,796189kAgent 技能11月8日收录

    Anthropic 在 GitHub 上公开了 anthropics/skills 仓库,把完成某类任务所需的指令、脚本和资源打包成一个独立文件夹,也就是所谓的“技能”(skill),让 Claude 按可重复的方式处理文档、数据分析和自动化任务。它要解决的是普通提示词难以稳定复现同一类工作的问题:与其每次从头描述要求,不如把做法固化成一份可加载的资料。

    每个技能的核心是一个 SKILL.md 文件,开头用 YAML 头信息写明名称和描述,正文写 Claude 需要遵循的指令、示例和准则。和普通提示词相比,技能是自包含的文件夹,能带上脚本和资源,Claude 会在需要时动态加载。仓库里的技能覆盖创意设计、开发技术、企业沟通和文档处理等方向,docx、pdf、pptx、xlsx 这几个文档技能正是 Claude 文档能力背后的实现,已开源供参考。仓库还提供 Agent Skills 规范和技能模板,可以当作写自己技能的起点。

    在 Claude Code 里,可以把仓库添加为插件市场,再安装 document-skills 或 example-skills 使用;安装后直接点名某个技能即可,比如让 Claude 用 PDF 技能提取表单字段。这些技能也能在 Claude.ai 和 API 中使用,付费方案已自带示例技能。需要留意的是,仓库中的技能仅用于演示和教学,实际效果可能不同,关键任务前要在自己的环境里充分测试。

    /plugin marketplace add anthropics/skills
    /plugin install document-skills@anthropic-agent-skills
    /plugin install example-skills@anthropic-agent-skills
  4. 给 AI 编程助手加结构化流程的工具包

    github/spec-kit

    让 AI 编程助手按固定流程干活:写规格、修 bug、评估想法,提供现成模板和可复用组件,也能换成你自己的流程。

    本周 +4,280149kAgent 技能11月8日收录

    Spec Kit 是一个开源工具包,给 AI 编程助手配上结构化的流程、可复用的模板和可查的结果,主要解决 AI 写代码时缺少章法的问题。它提供三种现成入口:按规格开发功能、诊断并修复 bug、评估一个想法值不值得做。这三种入口互相独立,不是必须按顺序走的阶段,用户按需要挑一个开始即可。

    以按规格开发为例,流程从写规格开始,再依次生成计划、任务和代码,最后反复实现与收敛,直到系统报告已收敛。修 bug 流程会先评估原因,再做范围明确的修复,最后验证原始症状是否消失,结论分为已验证、部分完成和失败三种。想法评估则收集证据,给出继续、待澄清或放弃的结论,不需要先有代码。

    和只给提示词的做法相比,Spec Kit 把模板、命令、术语和流程都做成可替换的层,通过集成、扩展、预设、工作流、包等机制组合使用。它可以连接或切换不同的编程助手,也能把流程接到外部工具上,还能搜索社区目录里的组件,或自建私有目录。目录里的内容不代表经过审核,安装前要自己看源码。

    上手前需要准备 Python 3.11 及以上版本、uv 包管理工具,以及一个受支持的 AI 编程助手,在 Linux、macOS 或 Windows 上都能用。用命令安装 CLI 并初始化项目后,在项目目录里启动编程助手,就能在对话中逐个运行流程命令,每步检查结果再继续。

    uv tool install specify-cli
    specify init my-project --integration copilot
    cd my-project
  5. 让编程助手跨会话记住上下文

    thedotmack/claude-mem

    编程助手每次新会话都从零开始,重复读文件、重复问问题。它记录会话过程并压缩成记忆,下次自动带回相关上下文。

    本周 +7,482115kAgent 技能11月8日收录
    thedotmack/claude-mem 介绍图
    图片来自项目 README

    很多用编程助手写代码的人都有类似体验:每开一个新会话,助手就像失忆一样,重新读同样的文件、问同样的问题,甚至把之前一起修好的错误再犯一遍。GitHub 项目 thedotmack/claude-mem 就是冲着这个痛点来的。它会在助手干活时把会话内容记录下来,用 AI 压缩整理成记忆,下次会话再把相关上下文自动带回来,让新会话接着上次的进度继续。

    它的做法相当于在助手旁边再跑一个负责记笔记的代理:会话过程中持续收集观察记录,下次会话先给出一份精简索引,需要细节时再按需展开,避免一次性把上下文塞满。项目还提供 mem-search 技能,按索引、时间线、细节三步检索项目历史,助手只为真正打开的内容花 token(模型处理文本的计量单位)。它支持 Claude Code、Codex、Cursor、OpenCode 等十余种助手,其中 Copilot CLI、Goose、Roo Code 和 Warp 只能搜索记忆,不记录会话。

    上手方式是在终端运行安装命令,安装器会找出机器上已有的助手并询问要接入哪些,按提示选择后重启对应工具即可。记忆默认存在本机的 ~/.claude-mem 目录,云同步需要主动开启;匿名使用统计默认打开,可以用命令关闭。安装过程中还会要求登录并选择记忆提供方,也可以跳过登录直接指定提供方。

    需要留意的是,用 npm 全局安装只会得到 SDK 库,不会注册插件钩子,也不会启动后台服务,所以应通过 npx claude-mem install 或 Claude Code 内的插件市场命令安装。装好后从第一次提问起就会产生观察记录,同一项目里的第二次会话就能带着上次的记忆开始。

    npx claude-mem install
  6. 给编程助手补上设计词汇和审查能力

    pbakaus/impeccable

    让 AI 编程助手按明确指令调整界面设计,并用规则检测常见的 AI 生成设计套路和可用性问题。

    本周 +7,623106kAgent 技能11月8日收录
    pbakaus/impeccable 介绍图
    图片来自项目 README

    用 AI 编程助手写页面的人常会遇到一种情况:不管提什么需求,生成出来的界面总是那几副面孔,到处是 Inter 字体、紫蓝渐变、卡片套卡片。GitHub 项目 pbakaus/impeccable 就是冲着这个来的,它给编程助手配了一套设计词汇,让开发者能具体说出想要什么效果,并在代码交付前把常见的 AI 生成设计套路和可用性问题挑出来。

    它的用法是先做一次初始化。在项目根目录运行安装命令、重载编程工具后执行 /impeccable init,工具会读取你的代码,只追问它推断不出的信息,比如产品面向谁、要完成什么,然后写成 PRODUCT.md,后续命令都参考这份背景。之后就是点名一个命令加一个目标,比如让它审查定价卡片、把落地页调安静、打磨设置页。命令共 24 个,分调整风格、审查、收尾打磨、浏览器实时迭代几类,critique 按可用性原则打分并排出修复优先级,audit 检查无障碍、性能、主题和响应式问题。

    和依赖大模型判断的做法不同,它内置 62 条确定性规则来识别 AI 生成设计的典型痕迹,也顺带发现内边距过窄、标题层级跳级这类质量问题,不需要 API key。这些规则还能脱离助手单独跑,在终端或 CI 里扫描目录、扫描渲染后的页面,或输出 JSON 和 GitHub Actions 注解。live 模式则打开你正在运行的开发服务器,加一层浮层,选中元素后原地切换变体,满意就写回源码。

    上手门槛不高,支持 Claude Code、Cursor、Codex CLI、GitHub Copilot 等多种编程工具,在 Codex 里改用 $impeccable 调用。它最适合已经存在的界面,指着一个页面或组件反复迭代,窄目标的效果好过整页粗看。使用前需要准备好项目代码和本地开发环境,live 模式只改本地检出,不要注入已部署的站点。

    npx impeccable install
  7. 抓网页和爬整站的 Python 框架

    D4Vinci/Scrapling

    把快速请求、隐身浏览器、页面解析和并发爬取合到一个 Python 库里,从抓单个页面到爬整站都能覆盖。

    本周 +8,71299.5k文档与数据11月8日收录

    Scrapling 是一个 Python 网页抓取框架,把快速 HTTP 请求、隐身浏览器、页面解析和并发爬取合进同一个库。它要解决的是抓数据时工具太分散的问题:静态页面、需要渲染 JavaScript 的页面,以及页面背后 API 调用返回的数据,都能用一套代码处理,从抓几个字段到采集整个网站都覆盖。

    实际用起来,它提供 CSS、XPath、文本和正则搜索来定位页面元素,还能把结果输出成干净的 Markdown。爬虫部分沿用类似 Scrapy 的 Spider 写法,支持多会话、代理轮换、自动重试、暂停续跑,以及 AutoThrottle 自动调节延迟——也就是根据网站响应快慢自己调整请求间隔,减少被封。隐身浏览器可以处理 Cloudflare 验证。它还能通过 MCP 服务器和命令行交给 AI 代理使用。

    上手门槛不高,用 pip 安装后,从 fetchers 导入 Fetcher 抓取第一个页面即可。想爬整站时再写 Spider,结果可导出 JSON、CSV 等格式。使用前需要准备 Python 环境,涉及隐身浏览器和代理轮换时还要配置相应资源。

    对想用 AI 辅助抓取的开发者来说,MCP 服务器和命令行让 AI 代理能直接浏览页面、提取数据,省去自己拼装多个工具的麻烦。

    from scrapling.fetchers import Fetcher
    page = Fetcher.get('https://quotes.toscrape.com/')
  8. 用手机和桌面控制本机 AI 编程代理

    pingdotgg/t3code

    把电脑上已装好的 AI 编程代理统一管起来,用手机、网页或桌面应用远程操控,不用守在电脑前。

    本周 +17,10051.7kAI 编程11月8日收录

    T3 Code 是 pingdotgg 团队做的一个「代理控制台」,用来统一操控你电脑上已经装好的 AI 编程代理。它本身不提供模型,而是对接你已有的订阅,包括 Claude Code、Codex、Cursor、Grok Build、OpenCode、Google Antigravity 和 fx,只要这些代理在本机装好并登录,T3 Code 就能接管它们。作者说做这个项目是因为现有方案没达到他们的标准,他们想要性能好、能远程用、真正开放的工具。

    它提供 iOS、Android 手机应用、网页应用和基于 Electron 的桌面应用四种客户端。Electron 是一套用网页技术做桌面软件的框架。实际用起来,你可以在手机上或另一台机器上远程指挥本机的代理干活,不必守在电脑前;它也能作为后台服务常驻运行,随时待命。此外它还支持通过 MCP 连接其他代理,MCP 可以理解为让不同 AI 工具互相通信的通用接口。和常见做法相比,它不绑定某一家模型,而是把你手头已有的代理集中到一个界面里管理。

    上手前要先准备好至少一个代理:装好 Codex CLI 并运行 codex login,或装好 Claude Code 并运行 claude auth login,Cursor、Grok Build、OpenCode、fx 也各有对应的登录命令,Antigravity 则需要在设置里启用并用 Google 账号登录。然后在命令行运行安装脚本,Windows 用 PowerShell 版本,之后执行 t3 启动服务并打开本地网页应用。想让它常驻后台可以用 t3 service install,升级用 t3 update,不想安装也可以先用 npx t3@latest 试一次。项目目前还很早期,作者提醒会有 bug,也基本不接受大型功能贡献。

    curl -fsSL https://t3.codes/install.sh | sh
  9. 让 AI 生成的网页不再一眼假

    Nutlope/hallmark

    给 Claude Code、Cursor 等 AI 编程工具加一层设计约束,避免生成套路化的网页,并在真实浏览器里检查那些一看就是机器做的痕迹。

    本周 +6,62450.6kAgent 技能11月8日收录
    Nutlope/hallmark 介绍图
    图片来自项目 README

    很多用 Claude Code、Cursor 这类 AI 编程工具的人都有同感:让模型做个网页,出来的东西一眼就能看出是机器做的。Together AI 推出的 Hallmark 就是冲着这个问题去的,它是一个设计技能,给这些工具加一层约束,让生成的页面不再套路化,并在真实浏览器里检查那些机器味很重的痕迹。

    它的做法是先守住一批硬性底线,比如对比度、焦点、减少动效、不编造事实、手机布局不能坏,过了这道关就不再插手,把剩下的交给具体页面。它从五十个主题里挑三个,每个主题是一套材质而非固定版式,再围绕访客来页面要做的事搭结构,让动作落在该在的位置。检查分三档:Floor 不通过就不交付,Reflex 是模型容易踩的默认套路、有理由可以记录在案后推翻,Finish 只影响细节、不拦发布。最后还有一个全新上下文的审阅者把关。

    它盯的正是那些典型毛病:每个标题上方都加小字、标题里只有一个彩色词、整页空框或全是照片、首屏放不下、每页结尾都塞邮件订阅、表单说谢谢却没真的发出去。它能在真实浏览器里按八种宽度检查,也可以指向 URL 或开发服务器自动截图。想重设计或只做审计,可以按名字调用,重设计会保留原有内容。

    上手用 npx 把它装到全局或当前项目,然后在 AI 工具里输入 /hallmark 或直接描述要做的页面即可。需要 Node 18 或更高版本;浏览器检查和截图还要另装 puppeteer-core 和 Chrome,没有它们静态检查照样能跑。如果它没有自动触发,在指令里点名让它用 Hallmark 就行。

    npx skills add nutlope/hallmark -g
  10. 给 AI 代理用的浏览器命令行工具

    vercel-labs/agent-browser

    让 AI 代理通过一条条 shell 命令操作浏览器:打开网页、读取页面元素、点击和填写,每步都能看到结果再继续。

    本周 +1,47647.2k智能体11月8日收录

    agent-browser 是 vercel-labs 推出的一个命令行工具,用 Rust 编写,目的是给 AI 代理配一个能一步步驱动的浏览器。它解决的是代理操作网页时“看不见结果”的问题:每条命令执行后,代理都能重新读取页面,确认这一步是否生效,再决定下一步。浏览器在命令之间保持打开,所以整个流程由一串简短的 shell 调用组成,代理不必自己维护复杂的浏览器状态。

    实际用法围绕一个叫 snapshot 的命令展开。它把页面读成紧凑的文本快照,每个可交互元素都带一个类似 @e1 的引用,代理按引用去点击、填写、按键或滚动,然后再读一次页面核对结果。引用只代表快照那一刻的页面,页面跳转或结构变化后要重新快照。除了引用,也支持 CSS、文本、XPath 和语义定位器;如果目标被弹窗遮挡或不可见,点击会直接报错而不是假装成功。

    在运作方式上,CLI 把每条命令发给一个后台守护进程,由它通过 Chrome DevTools Protocol(一套浏览器调试接口)控制浏览器。每个 --session 有独立的守护进程和浏览器,默认一小时后没有命令就关闭无头浏览器并退出。默认浏览器是 Chrome for Testing,也能连接正在运行的 Chrome,或换用其他引擎和云浏览器服务。它还自带与版本匹配的 skills,让代理加载核心用法说明,并提供 MCP 服务器供 MCP 客户端接入。

    上手前需要先全局安装并下载浏览器,然后依次执行 open、snapshot、click 就能跑通。Linux 上安装时加上 --with-deps 可以一并装好系统库,不想安装也可以用 npx 直接运行。如果希望代理自动掌握用法,可以把它的 skill 装进代理环境,或在 AGENTS.md 里写明首次使用前先运行 skills get core。

    npm install -g agent-browser
    agent-browser install
    agent-browser open example.com
  11. 把 Claude Code 变成游戏开发工作室

    Donchitos/Claude-Code-Game-Studios

    给单个 Claude Code 会话套上真实工作室的分工结构,用 49 个专职智能体和 74 个工作流技能,帮你管住设计、代码和 QA 流程。

    本周 +5,71936.8kAgent 技能11月8日收录

    用 AI 单独做游戏很自由,但一个聊天会话本身没有结构:没人拦着你写死数值、跳过设计文档,也没人做 QA 和设计评审。GitHub 项目 Donchitos/Claude-Code-Game-Studios 想补上这一环,它是一套给 Claude Code 用的模板,把一次普通对话变成有分工的游戏开发团队,用 49 个专职智能体(各自负责一类工作的子角色)和 74 个工作流技能管住设计、代码和 QA 流程。

    它模仿真实工作室搭了三层结构:导演层守住整体愿景,部门主管管好各自领域,专员做具体工作,每个角色都有明确职责和升级路径。覆盖设计、程序、美术、音频、叙事、QA 和制作,并内置 Godot 4、Unity、Unreal Engine 5 三套引擎专员。日常操作靠斜杠命令完成,比如 /start 起步、/design-system 做系统设计、/dev-story 开发故事、/story-done 收尾,另有 15 个钩子(在提交、推送等节点自动触发的检查)和 14 条按文件路径生效的编码规则。

    它和常见做法的一个区别是较真:凡是改动玩家可见内容的故事,必须启动游戏、实际观察并留存截图才算完成,光跑通解析检查不算数。模型分配上,导演层用 Opus,部分主管和专员用 Sonnet,其余继承你当前会话的模型,所以大部分角色跑在你已经在用的模型上。作者也坦言,提高严谨度会多写文档,换来的是可追溯性而非更好的游戏。

    上手方式不复杂:克隆模板仓库,装好 Claude Code、Python 3 和 Bash,在 Claude Code 里输入 /start 开始。Python 3 用来读取 project.yaml,缺了它各项设置会悄悄回落到默认值;Bash 负责运行钩子,Windows 上随 Git for Windows 提供。仓库本身不附带成品游戏,它是给你开新项目用的起点。

  12. 给 AI 智能体装上 Google 云技能

    google/skills

    这个仓库把 Google 产品和 Google Cloud 的使用方法整理成 Agent Skills,让 Claude Code、Codex 这类智能体在写代码、搭架构、排查问题时能直接按官方做法来。

    今日 +44323.6kAgent 技能11月8日收录

    Google 官方在 GitHub 上维护了一个名为 skills 的仓库,把 Google 产品和 Google Cloud 的使用方法整理成 Agent Skills,也就是给智能体看的技能包。它要解决的是智能体缺少特定平台知识的问题:Claude Code、Codex 这类工具在写代码、搭架构、排查问题时,一旦涉及 Google 技术栈,往往只能靠零散提示词猜测,容易走弯路,而这个仓库让它们直接按官方做法来。

    这些技能按产品和场景拆成一个个独立条目,覆盖 Google Cloud 入门、IAM 认证授权、AI/ML、基础设施、数据库与分析、开发者工具、应用开发和运维监控等方向。比如基础设施里有 GKE、Cloud Storage 相关技能,数据库与分析里有 BigQuery、AlloyDB,AI/ML 方向则包含 Gemini、Genkit 等内容。相比随手写几段提示词,这种组织方式覆盖面更系统,智能体遇到具体任务时能取到对应的那一份。

    使用方式是通过 npx 命令安装,npx 是 Node.js 自带的包执行工具。运行安装命令后,按提示选择具体技能或全部技能,指定要配置的目标智能体,再决定装到当前项目还是全局。之后可以用更新命令把已安装的技能升级到最新版本,并顺带清理过时技能。上手前需要准备 Node.js 环境,如果环境里没有 npx,装上 Node.js 即可获得 npm 和 npx。

    npx skills add google/skills
    npx skills update
  13. AI 自动审查代码改动的 PR 助手

    The-PR-Agent/pr-agent

    在 PR 里自动生成描述、审查代码、提出改进建议,还能回答关于这次改动的问题,帮开发者省下重复的代码审查时间。

    本周 +1,57615.5kAI 编程11月8日收录
    The-PR-Agent/pr-agent 介绍图
    图片来自项目 README

    PR-Agent 是一个由 AI 驱动的代码审查工具,由 Qodo 捐给社区维护,和 Qodo 自家的商业产品不是一回事。它直接以评论形式工作在 Pull Request(PR,即合并代码前的改动请求)上,能自动生成改动描述、审查代码、提出改进建议,还能回答你关于这次改动的问题,帮开发者省下重复的代码审查时间。

    实际使用时,你在 PR 评论里输入 /describe、/review、/improve 这类命令,或者用 /ask 直接提问,它就会给出结果。每个工具只调用一次大模型,大约 30 秒完成,成本较低。它用 PR 压缩策略处理大改动,提示词以 JSON 形式配置,团队可以按需要调整审查类别和行为。它支持 GitHub、GitLab、BitBucket、Azure DevOps、Gitea,可跑在命令行、GitHub Actions、Docker 或自托管环境,模型可选 OpenAI、Claude、Gemini、DeepSeek 等。

    上手推荐用 GitHub Action:在仓库里加一个 workflow 文件,配置 OPENAI_KEY 和 GITHUB_TOKEN 即可。也可以本地用命令行运行,先安装 pr-agent 并设置 OPENAI_KEY,再指定 PR 地址执行 review 等命令。自托管时数据只在你和所选模型服务商之间流转,提示词和行为都能按团队需要自行调整。

    pip install "pr-agent[github]"
    export OPENAI_KEY=your_key_here
    pr-agent --pr_url https://github.com/owner/repo/pull/123 review
  14. 用命令行管理 Git worktree 跑并行 AI 智能体

    max-sixty/worktrunk

    Git 原生 worktree 操作麻烦,Worktrunk 用三条核心命令把 worktree 管得像分支一样简单,方便同时跑多个 AI 智能体。

    本周 +2,29212.0kAI 编程11月8日收录

    同时跑多个 AI 智能体时,最怕它们在同一份代码里互相踩脚。Git 自带的 worktree(工作树,让同一个仓库在不同目录下各检出一份代码)能给每个智能体一个独立工作目录,但原生用法很别扭:光是新建一个就要把分支名敲三遍,先 git worktree add -b feat ../repo.feat,再 cd 进去。max-sixty 的 Worktrunk 就是来解决这个麻烦的,它是一款命令行工具,把 worktree 管得像分支一样简单。

    Worktrunk 用分支名来定位 worktree,目录路径按可配置模板自动算出来,核心命令只有 wt switch、wt list、wt merge、wt remove 四条。切换、创建、列出状态、清理都各一条命令搞定,wt switch -c -x claude feat 甚至能一步建好工作树并直接启动 Claude。它还有钩子(在创建、合并前后自动执行命令)、从 diff 生成提交信息、一条命令完成 squash 与合并清理、交互式选择器,以及让多个工作树共享构建缓存、给每个工作树分配独立端口跑开发服务器。

    对并行跑智能体的开发者来说,典型用法是开几个工作树、各起一个智能体:wt switch -x claude -c feature-a -- '添加用户认证',再换 feature-b、feature-c 各跑一个任务,互不干扰。wt list 会显示每个分支的改动、领先提交数和 CI 状态,当前所在的工作树用 @ 标出。相比原生 git 需要手动 cd 和清理,Worktrunk 把这些步骤收进同一条命令里。

    上手门槛不高:macOS 和 Linux 可用 Homebrew 执行 brew install worktrunk,或用 Cargo 执行 cargo install worktrunk,装完再运行 wt config shell install 做 shell 集成,让命令能切换目录。Windows 用户通过 Winget 安装时会以 git-wt 的名字出现,以避开 Windows Terminal 的 wt 命令冲突。装好后从四条核心命令用起,再按需配置钩子即可。

    brew install worktrunk && wt config shell install
    wt switch --create feature-auth
    wt switch -x claude -c feature-a -- 'Add user authentication'