使用 Go 语言开发Pi coding agent, 以AI自主的方式

使用 Go 语言开发Pi coding agent, 以AI自主的方式

💡 原文中文,约4200字,阅读约需10分钟。
📝

内容提要

作者用一周时间、零手写代码,靠AI主导开发出Go版pi coding agent——pigo。它对齐pi行为,编译为无依赖单一二进制,可当日常工具或SDK,支持headless、repl、tui三种模式,具备Skills、Prompt模板、Plugin、Hook等扩展层。开发采用goal-workflow方法,经/prd、/goal、/graph等技能迭代实现,验证了AI主导软件工程的可行性。

🔎

延伸解读

pigo 的定位与适用场景

pigo 是 pi coding agent 的 Go 语言复刻版,行为对齐 pi,但用 Go 重写以利用类型系统、并发和清晰包边界。编译后为无运行时依赖的单一二进制,既可日常使用,也可作为 SDK 集成到 Go 程序。支持 headless、repl、tui 三种模式,适合脚本、CI 或交互式开发。

扩展机制:四层能力与 Hook

pigo 通过扩展在不改源码的前提下增加能力,分为四层:Skills/斜杠命令(带 frontmatter 的 markdown 文件)、Prompt 模板、Plugin(独立进程、JSON-RPC 通信、任何语言可写)、以及从 npm 安装 pi 生态包。Hook 可在关键节点插入逻辑,如工具执行前询问目录信任,或在自主模式下提醒模型目标。

goal-workflow 开发方法

作者用一周时间、零手写代码,完全由 AI 主导开发 pigo。流程为 /prd 生成需求文档,/to-issues 拆解任务卡片,/graph 或 /loop-it 实现。其中 /graph 适合并行,用 git worktree 并发处理多个 issue,若检测到冲突会建议改用 /loop-it 串行。每个 issue 完成后通过 /note-it 总结,形成可回溯的开发历史。

TUI 实现的挑战与借鉴

pigo 的 TUI 基于 bubbletea + lipgloss 实现,与谷歌 antigravity 所用框架相同。开发中踩过不少坑:多行输入、图片粘贴、按终端宽度换行、视口滚动、主题配色、状态提示、Markdown 渲染等。这些细节多借鉴自 Claude Code,需要逐个特性打磨,且 TUI 代码量可能超过 agent core。

❓

Q&A

pigo 是什么?它和 pi coding agent 有什么关系?

pigo 是一个类似 pi coding agent 的 AI coding agent,使用 Go 语言开发。它是 pi 的 Go 复刻版,行为上尽量和 pi 对齐,但每个模块都用 Go 重写,编译后是一个无运行时依赖的单一二进制,既能当日常 coding agent 使用,也能作为 SDK 集成到 Go 程序中。

pigo 支持哪些运行模式?

pigo 支持三种模式:headless 模式(加 -p),只输出最终结果,适合写脚本、接 CI;repl 模式,带状态的交互式命令行,边聊边改代码;tui 模式,使用 bubbletea + lipgloss 实现,与谷歌 antigravity 使用的框架一样。

pigo 提供了哪些扩展能力?

pigo 的扩展分四层:Skills / 斜杠命令(带 frontmatter 的 markdown 文件就是一条 /命令)、Prompt 模板(通过 /模板名称调用)、Plugin(独立进程、用 JSON-RPC 通信,任何语言都能写,天然隔离)、以及从 npm 直接安装 pi 生态的包(pigo install)。此外还有 Hook,可以在关键节点插入操作,比如工具执行前询问目录是否可信,或在自主模式下每轮提醒模型目标。

pigo 是如何开发出来的?用了什么方法?

pigo 由作者一人花一周时间、零手写代码、完全让 AI 主导实现。开发采用 goal-workflow 方法,流程为 /prd → /goal → /review-it → /ship-it,并使用 /loop-it 或 /graph skill 让 Claude Code 自动批量实现。每个步骤都保存了历史,包括 tasks 目录的需求文档、GitHub issues 任务卡片、实现总结文档和架构图等。

goal-workflow 中的 /loop-it 和 /graph 有什么区别?

/loop-it 适合串行实现,可以避免代码冲突;/graph 将任务拆解成图,按照 wave 的方式阶段性并行实现,采用 git worktree 方式并发实现一个 wave 中的多个 issues。如果 /graph 发现多个 issues 会并发修改相同代码容易造成冲突,它会建议改用 loop-it 实现。

pigo 的未来规划有哪些?

pigo 的未来规划包括:参考 oh-my-pi 和 claude code、codex、opencode、kimi code、mimo code、qoder 等 coding agent 的优秀特性并移植到 pigo 中;增加 remote control 功能,转移到手机上远程控制;支持桌面版应用;支持作为 agent runtime 更好地为应用服务。

🏷️

标签

➡️

继续阅读