AI Coding on VvVzzz Blog

go-modern-guidelines：教 AI Agent 写现代 Go

Wed, 09 Sep 2026 20:30:00 +0800

仓库：github.com/JetBrains/go-modern-guidelines · 许可：Apache-2.0 · 来源：JetBrains 官方项目

它是什么

给编码 Agent 用的现代 Go 写法指南。装上之后，Agent 会：

用 max(a, b) 而不是 if-else 取大
用 slices.Contains 而不是手写循环
用 cmp.Or(a, b, c) 而不是一串 nil 检查
知道 new(42) 取值指针、errors.AsType[T](err) 类型安全错误匹配（Go 1.26）

覆盖 Go 1.0 → 1.27 最有用的特性，包括 Go 官方 modernize analyzer 的全部目标。完整清单在 FEATURES.md。

Agent 行为约定：

从 go.mod 检测项目 Go 版本
只用 ≤ 该版本的语言/标准库特性
优先现代惯用法，而不是老写法

动机写得很准

Agent 生成「过时 Go」几乎必然，原因只有两个：

问题	含义
训练数据滞后	训练截止后加的 API（如 `errors.AsType[T]`）模型根本没见过
频率偏置	见过也不一定用：语料里 `for i := 0; i < n; i++` 远多于 `for i := range n`

指南的解法很直接：给 Agent 一份显式参考，而不是指望模型「自己想起来」。

这也和 Go 团队方向对齐：modernize 负责把旧代码改新，这份指南负责让新代码一开始就新。

形态：小 CLI + 多端插件

不是纯 Markdown 甩给模型——各 market 集成会在首次使用时 go install 一个小 CLI，装进本地缓存（如 ~/.cache/go-modern-guidelines），不改动你的项目。

要求：PATH 上有 Go toolchain，目标 Go 1.25+；更旧版本在 GOTOOLCHAIN=auto（默认）下也能拉兼容 toolchain。

支持面：

客户端	方式
Junie	`/extensions marketplace add JetBrains/go-modern-guidelines`
Claude Code	`/plugin marketplace add` + `modern-go-guidelines@goland-claude-marketplace`
Codex	`codex plugin marketplace add` + `goland-codex-marketplace`
Cursor	`cursor-agent plugin marketplace add …`
其他（OpenCode 等）	`npx skills add JetBrains/go-modern-guidelines`

Claude Code 装完后 Go 任务会自动触发；也可显式 /modern-go-guidelines:use-modern-go。

值得学的两个工程细节

1. 按 go.mod 探测版本
避免 Agent 在 Go 1.21 项目里写出 1.26 才有的 API——这是「知识」和「项目约束」分开的干净做法。

2. 构建脚本与 Agent 隔离
scripts/dev-install.sh 故意和面向 Agent 的 wrapper 分开：Agent 永远不能触发本地构建。本地调试靠 make dev-install + GO_MODERN_GUIDELINES_DEV=1，与 Claude Code / Codex / Cursor 走同一套缓存路径。

上手（Claude Code 示例）

/plugin marketplace add JetBrains/go-modern-guidelines
/plugin install modern-go-guidelines@goland-claude-marketplace

其他客户端安装与更新见仓库 README。

适合谁

用 Agent 写 Go，不想再 review「上古写法」
团队想统一「新项目直接用新惯用法」，而不是事后 modernize 改
在做 language-specific Agent guideline 时，可当范本看：动机、版本门控、多端分发、CLI 与 agent 隔离

和收藏夹里其他项目的关系

同为「给 Agent 的技能/指南」→ pptx-generator（产物向）vs 本文（语言向）
跑在各种 Harness 里 → Pi、Claude Code、Codex 等
指南/技能沉淀与检索 → OpenViking

最后更新：2026-09-09。信息基于公开 README 与仓库状态，使用前请以官方文档为准。

pptx-generator：给编码 Agent 用的 PPT 生成技能

Wed, 09 Sep 2026 20:20:00 +0800

技能路径：MiniMax-AI/skills · pptx-generator
所在仓库：MiniMax-AI/skills · 许可：MIT

它是什么

pptx-generator 是 MiniMax 官方 skills 集合里的一项 Agent Skill，覆盖 PowerPoint 全流程：

任务	做法
读 / 分析现有 PPT	`python -m markitdown presentation.pptx`
基于模板编辑	XML 工作流（见 `references/editing.md`）
从零创建	PptxGenJS，按页面类型生成 slide 模块再编译

它不是「让模型随便画几页」，而是一套有约束的生成规范：设计系统、五类页面、主题契约、页码规则、QA 流程都写死在 skill 里。

为什么值得看

1. 五类页面 + 视觉多样性

所有 slide 必须归入五种类型之一：

Cover 封面
TOC 目录
Section Divider 分节页
Content 内容页
Summary 总结页

并明确要求：不要连续多页用同一 layout——避免 Agent 生成「十页长得一样」的 PPT。

2. Theme 对象契约（强制）

编译脚本向每页传入固定五色主题：

Key	用途
`primary`	最深色，标题
`secondary`	深色强调、正文
`accent`	中间调强调
`light`	浅色强调
`bg`	背景

禁止自创 background / text / muted 等 key。Agent 被死死绑在统一主题模型上，多页并行生成时才不会各画各的。

3. 一页一文件，可并行

每页是独立可运行的 JS：

function createSlide(pres, theme) {
 const slide = pres.addSlide();
 // ...使用 theme.primary / theme.bg 等
 return slide;
}
module.exports = { createSlide, slideConfig };

函数必须同步（不能 async）
文件可单独 node slide-01.js 预览
有 subagent 时最多 5 页并发生成
最后 compile.js 统一写入 output/presentation.pptx

这是「结构化输出 + 模块化并行」在文档生成上的干净落地。

4. 设计系统不是空话

references/ 里拆得很细：

文件	内容
`slide-types.md`	五类页面 + 额外 layout 模式
`design-system.md`	色板、字体、Sharp/Soft/Rounded/Pill 风格配方、排版间距
`editing.md`	模板编辑、XML、常见坑
`pitfalls.md`	QA 流程、PptxGenJS 陷阱
`pptxgenjs.md`	完整 API 参考

中文固定 Microsoft YaHei，英文默认 Arial；16:9（10" × 5.625"）；页码徽章除封面外必有，且只显示当前页码（不是 3/12）。

5. 和「只会改 Markdown 的 Skill」不同

多数 Agent Skill 只动文本。这个 skill 管的是二进制办公文档：生成、改、读，还带 QA 门槛。属于 productivity 类 skill 里工程化程度较高的样本。

上手（Claude Code）

claude plugin marketplace add https://github.com/MiniMax-AI/skills
claude plugin install minimax-skills

依赖：

pip install "markitdown[pptx]" # 读 PPT
npm install -g pptxgenjs # 从零创建

Cursor / Codex / OpenCode 的安装方式见仓库 README。

触发词：PPT、PPTX、PowerPoint、presentation、slide、deck。

同仓库其他技能（顺带一提）

MiniMax skills 里还有同一思路的办公套件：minimax-pdf、minimax-xlsx、minimax-docx，以及前端/全端/移动端/shader 等开发技能。如果你要做「Agent 生成 Office 全家桶」，可以整包接入再按需挑。

适合谁

想让 Claude Code / Codex 直接产出结构稳定、风格统一的 PPT，而不是随机排版
需要「模板编辑 + 从零生成 + 读回分析」三条链路
在研究 Agent Skill 怎么管二进制产物、怎么做多页并行、怎么定 theme 契约

和收藏夹里其他项目的关系

Skill 被 Multica 等平台当作可复用剧本 → Multica
运行这些 Skill 的编码 Agent → Pi、Claude Code 等
Skill 本体的知识/记忆沉淀 → OpenViking

最后更新：2026-09-09。信息基于公开 SKILL.md 与仓库 README，使用前请以官方为准。

OpenViking：AI Agent 的上下文数据库

Wed, 09 Sep 2026 20:15:00 +0800

仓库：github.com/volcengine/OpenViking · 站点：openviking.ai · 许可：主项目 AGPL-3.0（CLI / examples 为 Apache-2.0）

它是什么

OpenViking 是火山引擎开源的 AI Agent 上下文数据库（Context Database）。

它把三类东西统一进一个 viking:// 虚拟文件系统：

Memories：用户偏好、会话沉淀
Resources：项目文档、仓库、网页等知识
Skills：可复用技能

Agent 用 ls / tree / find 像开发者翻目录一样定位上下文，而不是对黑盒向量库发一句 query、拿回一个莫名其妙的片段。

设计上最有意思的几点

三层内容抽象。写入时就拆好：

层	内容	量级
L0 Abstract	一句话摘要，快速判相关	~100 tokens
L1 Overview	核心信息与使用场景	~2k tokens
L2 Details	全文，按需读	原始数据

目录自己也带 L0/L1，可以先判「这个目录相关吗」再决定下不下去——直接砍 token。

目录递归检索。向量搜索先定位最高分目录，再逐层下钻，结果保留周边上下文。

检索可观察。每次查询留下「目录浏览轨迹」。结果不对时，你能看到是哪条路径出来的，而不是只能耸耸肩。

会话变记忆。session commit 后异步抽取用户偏好与 Agent 经验进长期记忆。

官方集成面广。Claude Code、Codex、OpenClaw、Hermes、Cursor、OpenCode、pi、MCP clients、LangChain/LangGraph 等。

开源版不阉割。无功能开关、无需账号激活；商业版答的是「谁运维、跑在哪」，不是「能不能用」。

官方 benchmark 摘要

在 LoCoMo（长对话用户记忆）和 tau2-bench（多轮 Agent 任务）上：

接上 OpenViking 后，多个 Agent 集成记忆准确率从原生 24–57% 拉到 80–83%
输入 token 下降 34.3–91.0%，查询延迟下降约 58–66%
经验记忆在 tau2-bench 上带来零售 +6.87pp、航空 +11.87pp 的任务成功率提升

（评测配置与复现脚本见仓库 benchmark/ 与官方报告。）

上手

需要 Python 3.10+。

pip install openviking --upgrade
openviking-server init # 交互配置 provider / 模型
openviking-server doctor
openviking-server

# 另一终端
ov status
ov add-resource https://github.com/volcengine/OpenViking
ov ls viking://resources/
ov find "what is openviking"

init 支持火山引擎、OpenAI、Codex OAuth、Kimi、GLM、本地 Ollama 等。

浏览器可先玩 OpenViking Studio，无需安装。

适合谁

Agent 跨会话失忆，同一天重复解释上下文
知识库/项目文档希望 Agent 确定性浏览而不是纯向量搜
需要可调试、可审计的检索轨迹
想把会话沉淀成可复用的长期记忆与 Skills

注意：主项目是 AGPL-3.0，对外提供服务前先看清传染范围。

和收藏夹里其他项目的关系

给 Pi、Claude Code 等编码 Agent 补记忆
和 Multica 的 Skills 体系可互补（Multica 管工作流剧本，OpenViking 管知识/记忆存储）
herdr / CodexHost 管「Agent 跑在哪」，OpenViking 管「Agent 记得什么」

最后更新：2026-09-09。信息基于公开 README 与仓库状态，使用前请以官方文档为准。

Multica：让人和 AI Agent 当队友的工作区

Wed, 09 Sep 2026 20:14:00 +0800

仓库：github.com/multica-ai/multica · 站点：multica.ai · 许可：Apache-2.0 附加条件（见 LICENSE）

它是什么

Multica 的 slogan 是 Agents that show up on the board。

你已经同时在跑 Claude Code、Codex 和另外三个 Agent；每个住在自己的终端 tab 里，会话结束就失忆，同一天要你重复讲第四遍上下文。Agent 越多，你的时间越多花在「看着它们」。

Multica 把 Agent 和人类队友放进同一个工作区：

给 Agent 派一个 Issue（像派给同事）
Agent 自己接活，在你控制的 runtime 上跑
过程中评论、求助、汇报
结果进 review，人拍板才合并

意图、运行、决策、diff 都挂在同一个 Issue 上——不用重建上下文，也没有人说「OK」就不进 main。

关键能力

26 种 Agent CLI。Claude Code、Codex、Cursor、Copilot、Kimi、OpenCode、Pi、Qwen Code、DeepSeek Harness… 换 provider 是下拉框，不是迁移。Multica 不带模型，驱动你已装好并登录的 CLI。

Agent 即队友。每个 Agent 有名字、provider、runtime，像同事一样上板；Squads 把人和 Agent 编队，leader 路由工作。

你的机器当 runtime。daemon 跑在你的笔记本或云主机上，代码不出去。

过程可观测。执行日志可回放每次工具调用、命令、错误；token 用量按 Agent / Issue 统计；失败可自动重试或停下说明原因。

Review gate。工作落进 review 而不是 main；Inbox 只在 Agent 需要你决策时才打扰。

自托管。Docker Compose 或 Helm；支持 GitHub / GitLab / Gitea / Forgejo；Slack、飞书、钉钉、企微、Telegram 触发；Web / 桌面 / iOS。

Skills。把解过的问题沉淀成每个 Agent 都能复用的 playbook。

架构速览

Web / Desktop / iOS
 │
 ▼
 Next.js frontend ──► Go backend (Chi + WS) ──► PostgreSQL 17
 │
 WebSocket tasks
 │
 Agent daemon ←── 你机器上的本地进程
 │
 Claude Code · Codex · Cursor · Pi · …

上手

无需终端：注册 multica.ai，或下载 Desktop（会自动把本机注册为 runtime）。

自托管：

curl -fsSL https://raw.githubusercontent.com/multica-ai/multica/main/scripts/install.sh | bash -s -- --with-server
multica setup self-host

前提是跑 Agent 的机器上至少装好并登录一个受支持的 Agent CLI。

适合谁

已经被多个编码 Agent 的「babysitting 成本」淹没
想要 Issue → 自动执行 → 人审合并的闭环，而不是聊天窗口
需要团队级权限、审计、自托管、多 Git host
想把踩过的坑做成 Skills 给所有 Agent 复用

和收藏夹里其他项目的关系

常被派活的 Agent → Pi
本地多会话终端运行时 → herdr
本地会话的计划/代码评审 → Plannotator
给 Agent 补长期记忆与知识 → OpenViking
想在 Codex Desktop 里操作多 Harness → CodexHost

延伸阅读

Multica 的 Go 后端演进里有不少值得学的工程设计（不变量、边界、证据），本博客另有长文分析：从 Multica 的 Go 后端演进看高级工程设计。

最后更新：2026-09-09。信息基于公开 README 与仓库状态，使用前请以官方文档为准。

Plannotator：编码 Agent 的计划与代码评审台

Wed, 09 Sep 2026 20:13:00 +0800

仓库：github.com/backnotprop/plannotator · 站点：plannotator.ai · 许可：Apache-2.0 / MIT 双许可

它是什么

Plannotator 是一个本地、浏览器里的 Agent 评审界面。它通过各 harness 的 hooks 和 slash 命令直接接入：

Agent 提出 plan、或写完代码时，工作自动在浏览器打开
你做可视化标注、批注、建议修改
反馈结构化送回 Agent，它照着改

覆盖三大场景：Markdown/计划评审、代码 diff 评审、HTML 产物标注。

支持的 Agent

Claude Code、Codex、Copilot CLI、Gemini CLI、OpenCode、Kiro、Droid、Amp、Pi。

安装器会自动检测已装 Agent 并配置 hooks、skills、slash 命令。也可以 --minimal 只装二进制。

核心流程

Plan review（无需命令）

Agent 调用 ExitPlanMode
 → PermissionRequest hook
 → 本地 server 读 plan
 → 浏览器打开评审 UI
 → 你标注并 approve / deny
 → Approve：继续执行
 → Deny：结构化反馈给 Agent

Code review

/plannotator-review
 → git diff（或按 URL 拉 PR/MR）
 → 浏览器 diff 视图
 → 标注、stage/unstage
 → 反馈回 Agent；LGTM 即通过

支持 Git、GitButler、Jujutsu、Perforce，以及 GitHub PR / GitLab MR URL。

几个设计细节

隐私默认本地。不收集使用遥测；plan、diff、标注、历史默认留在本机。分享、Ask AI 等网络能力边界在文档里写得很清楚。

终端版。Herdr Annotate 把同类评审带进终端，标注存同一数据目录，浏览器版与终端版可叠加。

安全发布。二进制带 SHA256 sidecar，有 SLSA provenance 与 CycloneDX SBOM attestation，可选安装时校验。

Obsidian / VS Code 集成。已批准的 plan 可自动存进 vault；VS Code 可在编辑器里看 diff 和标注。

上手

# macOS / Linux / WSL
curl -fsSL https://plannotator.ai/install.sh | bash

然后在 Agent 里：

/plannotator-last # 标注 Agent 上一条回复
/plannotator-review # 审当前 diff
/plannotator-annotate README.md

Plan mode 不需要命令——下次 Agent 提 plan 会自动打开。

Pi 用户也可以跳过安装器：pi install npm:@plannotator/pi-extension。

适合谁

不想在终端里干瞪纯文本 plan，希望「看图说话」再放行
需要 PR 级 diff 评审，且意见要直接喂回当前 Agent 会话
团队想把 plan 决策归档、可回溯

和收藏夹里其他项目的关系

在终端里同样评审 → herdr + herdr-annotate
被评审的 Agent 常是 → Pi / Claude Code / Codex
想把评审放进更大工作流（Issue→Agent→Review）→ Multica

最后更新：2026-09-09。信息基于公开 README 与仓库状态，使用前请以官方文档为准。

CodexHost：在 Codex Desktop 里跑其他 Harness

Wed, 09 Sep 2026 20:12:00 +0800

仓库：github.com/BytePioneer-AI/codex-host · 许可：MIT

它是什么

CodexHost 的出发点很直接：Codex Desktop 的桌面交互很好，但 Codex 不是唯一优秀的 Harness。

它让你在官方 Codex Desktop 窗口里选择真正执行任务的 Agent——Pi、Claude Code、OpenCode、Oh My Pi、Grok、DeepSeek Harness、Antigravity CLI 等——同时保留 Codex 的原生界面体验，并支持跨 Agent 委派协作。

设计上最值得学的一点

多数「多 Agent 客户端」走 ACP（Agent Client Protocol）快速接入，但工具状态、审批、权限、Diff、提问等原生能力会被削平。

CodexHost 故意不走这条路：

层	做法
Desktop	CDP / Electron Inspector 在官方 Codex Desktop 上增强，不重做聊天壳、不改官方安装包
协议	CLI Shim 透明接入官方 app-server，Codex 请求原样转发
Harness	按各自原生接口：Pi 走官方 RPC，Claude Code 走 Agent SDK / CLI
编排	委派时为目标 Harness 创建独立 Native Session，创建与结果观察分离

目标是保真，不只是「能聊」：流式、工具状态、可靠 Patch、原生审批和提问，尽量来自 Harness 自己。

主要能力

流式回复、工具状态、Edit Diff、提问/取消、Model/Thinking 选择、工具审批、Fork、上下文压缩、斜杠命令、修订上一条消息
跨 Agent 协作：让 claude-code 独立审查、让 pi 排查偶发失败、让 omp 实现功能——各自独立 Thread
多账号与额度：统一管理多个账号；macOS 菜单栏 / Windows 任务栏显示剩余配额
远程：SSH 连接 Mac/Linux 远程节点上的 Harness；Windows 侧有实验性 Remote Control
Mermaid 等图表可视化渲染

上手

npm install -g @codexhost/cli
codexhost

或从 Releases 下载安装包（macOS / Windows）。需要本机已装官方 Codex Desktop。

适合谁

喜欢 Codex Desktop 的交互，日常又在 Pi / Claude Code 等之间切换
想在一个窗口里让多个 Agent 分工协作
需要在本地桌面操作远程机器上的 Harness

和收藏夹里其他项目的关系

被接入的常见 Harness → Pi
更偏终端 pane 运行时、而不是桌面壳 → herdr
想把 Agent 当队友派 Issue 而不是本地会话 → Multica
接入后的 plan/diff 评审 → Plannotator

最后更新：2026-09-09。信息基于公开 README 与仓库状态，使用前请以官方文档为准。

herdr：给编码 Agent 用的终端运行时

Wed, 09 Sep 2026 20:11:00 +0800

仓库：github.com/herdrdev/herdr · 站点：herdr.dev · 许可：Apache-2.0

它是什么

herdr 官方定位是 the runtime your coding agents live on。它不是又一个终端模拟器，而是一层 Agent 会话运行时：

你继续用现有终端（iTerm、Ghostty、Windows Terminal…）
herdr 在后台起一个 server，所有 Agent pane 挂在上面
关掉客户端、断 SSH，Agent 还在跑；ctrl+b q detach，herdr reattach

Rust 单二进制，无 Electron，约 10MB 量级。

核心能力

Detach 不停工。后台服务托管终端；机器或 server 重启后能恢复保存的布局，受支持的 Agent 会话可 resume（原进程本身不跨重启存活）。

多机一窗。本地工作区和已保存的 SSH 机器合在一个窗口，Agent 列表统一，各自可独立重连。

状态感知。每个 pane 标记 working / blocked / idle；Agent 停下来等人回答时，herdr 会明确告诉你，不用一个个窗口翻。

Agent-native。Agent 可以通过 CLI 和 Socket API 驱动 herdr：spawn pane、互相 prompt、等另一个 Agent 真的 blocked。这是「Agent 编排 Agent」的基础设施位。

原样运行现有 Agent。Claude Code、Codex、Cursor、OpenCode、Grok 等——不包装、不替换，只接管它们的终端。

键盘鼠标双一等公民。tmux 风格 prefix，也支持点击、拖拽、分屏；按场景选，不绑死工具。

插件市场。可扩展 pane 与工作流；Plannotator 的 Herdr Annotate 就是典型插件——在终端里做 Markdown/回复标注并回传 Agent。

上手

curl -fsSL https://herdr.dev/install.sh | sh
# 或 brew install herdr

herdr # 在工作目录启动
# 跑 Agent、分屏、走开；ctrl+b q detach，herdr reattach

完整文档：herdr.dev/docs

适合谁

同时开多个编码 Agent，需要知道「哪个在等你」
SSH 远程跑 Agent、笔记本合盖后继续干活
希望 Agent 之间能通过 socket/CLI 互相协作
偏好纯终端、不想再换一个 Electron 桌面壳

和收藏夹里其他项目的关系

在 herdr 里做 plan/diff 标注 → Plannotator（herdr-annotate 插件）
想要看板/Issue 派工而不是终端 pane → Multica
想在图形桌面里跑多 Harness → CodexHost
常跑的那个 Agent 本体可能是 → Pi

最后更新：2026-09-09。信息基于公开 README 与仓库状态，使用前请以官方文档为准。

Pi：可自我扩展的 AI 编码 Agent 工具包

Wed, 09 Sep 2026 20:10:00 +0800

仓库：github.com/earendil-works/pi · 站点：pi.dev · 许可：MIT

它是什么

Pi 是一个开源 AI Agent 工具包，核心交付物是「可自我扩展的编码 Agent」。它不是单一 CLI，而是一组分层清晰的包：

包	职责
`@earendil-works/pi-ai`	统一多 provider LLM API（OpenAI / Anthropic / Google…）
`@earendil-works/pi-agent-core`	Agent 运行时：工具调用、状态管理
`@earendil-works/pi-coding-agent`	交互式编码 Agent CLI
`@earendil-works/pi-tui`	差分渲染的终端 UI 库
`@earendil-works/chord`	应用组装运行时：服务、复制状态、RPC、插件

社区里常见的 pi-mono 指的就是这套 monorepo；官方现在以 earendil-works/pi 为主仓库。

为什么值得看

分层可复用。很多编码 Agent 把「模型接入 + 循环 + TUI + 产品逻辑」揉在一起。Pi 把这些拆开：你可以只用 pi-ai 做多模型统一调用，也可以嵌 pi-agent-core 自己包一层产品，或者直接用完整 CLI。

生态被广泛对接。Multica 把它列为一等 runtime；Plannotator 有官方 pi-extension；CodexHost 用 Pi 官方 RPC 接入。当多个基础设施项目都选择「原生适配」而不是「ACP 削平」时，说明它的协议边界设计得比较干净。

供应链认真。直接依赖锁死精确版本、save-exact + min-release-age、CLI 包发布 shrinkwrap、安装默认 --ignore-scripts、定时 npm audit。在 Agent 工具链里这种严谨度不多见。

权限与边界

Pi 不内置文件系统 / 进程 / 网络 / 凭证权限系统，默认以启动它的用户权限运行。需要更强边界时官方给了三条路：

Gondolin 扩展：pi 和 provider 认证留在 host，内置工具与 ! 命令路由进本地 Linux micro-VM
纯 Docker：整个 pi 进程跑在本地容器
OpenShell：策略控制的沙箱里跑

选型时要把「默认全权 + 外置沙箱」和 Claude Code 内置审批模式对比清楚。

上手

npm install -g @earendil-works/pi-coding-agent
# 或按官方文档用独立二进制

文档在 pi.dev/docs，也支持直接问 Agent 自己「你怎么工作」。

和收藏夹里其他项目的关系

想给 Pi 加计划/代码评审 → Plannotator
想多 Agent 并行、会话持久化 → herdr
想在 Codex Desktop 里跑 Pi → CodexHost
想把 Pi 当队友派 Issue → Multica
想给 Pi 加长期记忆 → OpenViking

最后更新：2026-09-09。信息基于公开 README 与仓库状态，使用前请以官方文档为准。

开源仓库收藏夹

Thu, 30 Jul 2026 00:00:00 +0800

当前收录两条线：AI Coding Agent 生态（本体、终端运行时、桌面宿主、评审、协作、记忆），以及 Agent Skills（让 Agent 产出结构化办公文档等）。

flowchart LR
 A["编码 Agent
Pi"] --> B["跑在哪
herdr / CodexHost"]
 A --> C["怎么审
Plannotator"]
 A --> D["怎么派活
Multica"]
 A --> E["记得什么
OpenViking"]
 A --> F["怎么做 PPT
pptx-generator"]
 A --> G["怎么写现代 Go
go-modern-guidelines"]

编码 Agent

Pi — earendil-works/pi

开源 AI Agent 工具包与可自我扩展的编码 Agent。统一多模型 API、Agent 循环、终端 UI 拆成可复用包；社区生态活跃，被 Multica / Plannotator / CodexHost 原生对接。

终端运行时

herdr — herdrdev/herdr

给编码 Agent 用的终端运行时。不替换终端，接管 Agent 的 pane：detach 仍在跑、多机一窗、working/blocked/idle 一眼可见、CLI + Socket API 供 Agent 互相编排。Rust 单二进制。

桌面宿主

CodexHost — BytePioneer-AI/codex-host

在 Codex Desktop 里直接跑 Pi、Claude Code 等其他 Harness。用 CDP 增强官方桌面、按各 Harness 原生协议接入，保留流式/Diff/审批，而不是削平成 ACP。

计划与代码评审

Plannotator — backnotprop/plannotator

本地浏览器里的 Agent 评审台。标注 plan / 文档 / HTML，审 diff 与 PR，反馈一键送回 Claude Code、Codex、Pi 等。默认本地、不收集遥测。

人机协作工作区

Multica — multica-ai/multica

可自托管的开源工作区：给 Agent 派 Issue，它自己接活、汇报、求助，结果交回人 review。支持 26 种 Agent CLI，执行日志可回放，Review gate 保证进 main 前有人拍板。

上下文与记忆

OpenViking — volcengine/OpenViking

面向 AI Agent 的上下文数据库。记忆 / 资源 / Skills 统一成 viking:// 虚拟文件系统；L0/L1/L2 三层按需加载；检索轨迹可观察。火山引擎开源。

Agent Skills

pptx-generator — MiniMax-AI/skills · pptx-generator

给编码 Agent 用的 PPT 技能：PptxGenJS 从零生成、XML 编辑模板、markitdown 读回分析。五类页面 + 强制 theme 契约 + 一页一文件可并行，设计系统写进 references。属 MiniMax-AI/skills 官方技能集。

go-modern-guidelines — JetBrains/go-modern-guidelines

JetBrains 官方指南，教编码 Agent 写现代 Go：显式覆盖 Go 1.0–1.27 惯用法，对抗训练滞后与频率偏置；按 go.mod 探测版本。Junie / Claude Code / Codex / Cursor / skills.sh 均可装。

维护约定

角色	文章	内容
总导航	本文	一句话定位 + 链接
详解	分类「开源仓库」下各篇	完整介绍

新增仓库：先加详解文（短 slug），再在本页对应分区加一条
详解大改时，同步更新本页 lastmod