Pi Agent 配置指南:打造你的专属 AI 编程助手 ✍ Kieran Zhang🕐 2026-05-31📦 8.1 KB 🟢 已读 𝕏 文章列表 文章介绍了 Openclaw 背后的极简编码智能体框架 Pi。与开箱即用的工具不同,Pi 主张极简内核,通过 Extension、Prompt Templates 和 Packages 进行高度定制。文章详细讲解了如何编写拓展、创建模板以及管理包生态,并推荐了 10 个实用的 Pi 包和配置方案,适合喜欢深度定制和折腾的开发者。 PiOpenClaw编程助手配置指南TypeScriptDevOps工具与效率 # Pi Agent 配置指南:打造你的专属 AI 编程助手 **作者**: Kieran Zhang **日期**: 2026-05-15T05:23:49.000Z **来源**: [https://x.com/ninthbit_ai/status/2060711641378119824](https://x.com/ninthbit_ai/status/2060711641378119824) ---  > 在玩 pi 的过程中,感觉又回到了折腾 neovim 的时期,这种自己构建乐高玩具的过程,无论何时都深深吸引着我。 ## 什么是 Pi ? pi 又叫 pi coding agent,如果你没有听说过它,那你一定听说过 openclaw。而 pi 则是 openclaw 背后的编码智能体框架。极简的设计哲学,是大家对它最大的共识。 所以我们先来了解一下,pi 的能力边界是什么。 一切都围绕着极简二字,0 配置的 pi agent 只支持 4 种工具:bash、read、write 和 edit,没有 mcp 、没有 sub-agents、没有 plan mode 、没有 permision popups。一切都没有,都需要自己配置。看到这,如果你想要一个开箱即用的 coding agent ,那么可以转向 Codex 和 Claude Code。  正如作者的设计原则中所说,Pi 保持内核精简,将工作流相关行为推向了拓展、skills、提示词模板以及包中。后文中我将重点介绍这些可定制化的部分,以及如何搭建起属于自己的 Harness。 ## 什么是 Extension ? 这是 Pi 框架中的第一个抽象,扩展是 TypeScript 模块,用于扩展 Pi 的行为。它们可以订阅生命周期事件、注册可由 LLM 调用的自定义工具、添加命令等。位置在 .pi/agent/extensions/* 目录下,Pi 会自动发现这些拓展,或者可用 /reload 命令进行热更新。 下面会重点讲拓展的关键能力: 1. 自定义工具/自定义命令:分别通过 pi.registerTool() 和 pi.registerCommand() 注册大模型自定义工具和斜杠命令。 2. 事件拦截:阻止或修改工具调用、注入上下文、自定义压缩。Pi 提供了非常丰富的生命周期(LifeCycle)事件用来注册,基本可以满足大部分需求。官方文档 3. 用户交互/界面渲染:Pi 也允许用户自定义交互逻辑和渲染逻辑,比如写一个提问 QA 的问答框、自定义 Editor 样式或者写一个等待模型输出时的小游戏(例如:贪吃蛇、飞机大战等) 4. 会话持久化:通过 pi.appendEntry() 存储重启后仍保留的状态。可以用来做一个类似 todo 的拓展。 如何写一个 Pi 拓展? 在 AI 时代,我们不必再像 neovim 时期,自己动手写 lua 代码,最简单的方式或许就是和 Pi 说清楚你的需求,让它自己去写一个,并且通过热加载马上生效。所以你可以对 Pi 说: > 我想写一个叫做 permision-gate 的 Pi Extension,作用是 Prompts for confirmation before dangerous bash commands (rm -rf, sudo, etc.) 再比如,我想通过插件形式,完全实现像 Claude Code 格式的 hooks 功能,你可以对 Pi 说: > 我想写一个叫做 CC-hooks 的插件,用来将 Pi 原生的事件拦截能力,包装成像 Claude Code Hooks 一样的用法。 ## 什么是 Prompt Templates ? 其实这个更像 Claude Code 的自定义斜杠命令,而上面拓展中的自定义命令更加的强大,可以调用 Pi 内部提供的 API。 格式:一个带 front-matter 的 markdown 文件 front-matter:包括 description 和 argument-hint,这两个都是可选的,会显示在下拉菜单中的描述和参数。 模板还支持位置参数和切片,比如用 $1 和 $2 以及 ${@:N} 这种使用方式,具体说明见 模板参数 。 ## 什么是 Pi Package ? Pi Package 是 Pi 的另一抽象,简单来说就是 extensions, skills, prompt templates, or themes 的集合,这让 Pi 的配置可以很方便的通过 git 或者 npm 分享和安装。说起来有点像发行版的概念,但又不完全是,因为 Pi Package 可以多个共存,这是 Pi 配置可分享的最小单元。 但是便捷背后也意味着可能出现的安全隐患,Pi 作者特意强调了安全问题:Pi 包以完整系统权限运行。扩展程序可执行任意代码,技能则能指示模型执行包括运行可执行文件在内的任何操作。所以安装第三方包前请务必先审查源代码。  当然,Pi 包的创建也可以直接通过 Pi 去完成,官方文档 参考这里 ## Pi Package 推荐 截至 2026 年 5 月,pi.dev/packages 已收录 3,328+ 个包。这里我推荐 10 个自己安装的。文末会给出我搜集的 awesome-pi-list 仓库供大家选择。 1. context-mode:节省 98% 上下文窗口,提供沙箱代码执行、FTS5 知识库和意图驱动搜索,Pi 用户几乎必装。 2. pi-subagents:子代理任务委派,支持链式调用、并行执行和 TUI 交互确认,让一个主代理调度多个子代理协作完成复杂任务。 3. pi-mcp-adapter:MCP (Model Context Protocol) 适配器,让 Pi 能连接外部 MCP 服务器,扩展工具能力(数据库、API、文件系统等)。 4. pi-web-access:Web 搜索、URL 抓取、GitHub 仓库克隆、PDF 提取、YouTube 视频理解,弥补 Pi 无法访问网络的短板。 5. pi-lens:实时代码反馈 —— LSP、linter、formatter、类型检查、结构分析。 6. pi-simplify:自动审查最近变更代码的清晰度、一致性和可维护性,代码质量守门员。 7. @juicesharp/rpiv-todo:给模型一个持久化 TODO 列表,以实时覆盖层渲染,即使 /reload 或上下文压缩也能保留。 8. @plannotator/pi-extension:交互式计划审查与批注,支持对代理消息做标注、审查代码/PR,适合复杂任务前的方案评审。 9. @narumitw/pi-goal:/goal 模式,保持代理工作直到任务完成。 10. @narumirw/statusline:丰富的状态栏,显示模型、工具、git 分支、上下文使用、token 总计、费用和时间。 推荐 @9hills 老师的 pi agnet 配置 > **九原客@9hills**: [原文链接](https://x.com/9hills/status/2055157180253536295) > > 经过好几周的摸索和各种尝试,pi agent 的配置基本稳定,之前发了一个 list,没有解释不太友好,这次发个全量带注释的。 > 避雷:如果需要开箱即用的 Coding Agent,请不要用 Pi,Claude Code/Codex 更适合你。 > >  下面是我收录的列表仓库 > **Kieran Zhang@ninthbit_ai**: [原文链接](https://x.com/ninthbit_ai/status/2060709020265312511) > > Pi Agent Package 数量已经超过 3300 个了。 > 官方 Catalog 其实已经有点难逛,我整理了一份 Awesome Pi Package List,专门收录值得安装和持续维护的 Package。 > 欢迎补充和 PR。 > https://github.com/BubblePtr/awesome-pi… ## 相关链接 - [Kieran Zhang](https://x.com/ninthbit_ai) - [@ninthbit_ai](https://x.com/ninthbit_ai) - [12K](https://x.com/ninthbit_ai/status/2060711641378119824/analytics) - [官方文档](https://pi.dev/docs/latest/extensions#events) - [模板参数](https://pi.dev/docs/latest/prompt-templates#arguments) - [参考这里](https://pi.dev/docs/latest/packages) - [pi.dev/packages](https://pi.dev/packages) - [@juicesharp/rpiv-todo](https://x.com/@juicesharp/rpiv-todo) - [@plannotator/pi-extension](https://x.com/@plannotator/pi-extension) - [@narumitw/pi-goal](https://x.com/@narumitw/pi-goal) - [@narumirw/statusline](https://x.com/@narumirw/statusline) - [@9hills](https://x.com/@9hills) - [May 15](https://x.com/9hills/status/2055157180253536295) - [42K](https://x.com/9hills/status/2055157180253536295/analytics) - [13h](https://x.com/ninthbit_ai/status/2060709020265312511) - [159](https://x.com/ninthbit_ai/status/2060709020265312511/analytics) - [Upgrade to Premium](https://x.com/i/premium_sign_up) - [9:15 PM · May 30, 2026](https://x.com/ninthbit_ai/status/2060711641378119824) - [12.1K Views](https://x.com/ninthbit_ai/status/2060711641378119824/analytics) - [View quotes](https://x.com/ninthbit_ai/status/2060711641378119824/quotes) --- *导出时间: 2026/5/31 10:24:25*
A Awesome OpenClaw Skills 新手必备指南 本文介绍了 OpenClaw 的精选公共技能库 Awesome OpenClaw Skills。该列表从 3000 多个技能中筛选出 1715+ 个高质量技能,剔除低质量内容。文章为新手推荐了开发效率、浏览器自动化、任务管理、DevOps 等核心类别的实用技能,帮助用户轻松构建高效的工具集。 技术 › Openclaw ✍ Geek🕐 2026-02-06 OpenClaw技能推荐DevOps工具与效率生产力新手指南自动化合集
使 使用 Kimi K3 构建公司操作系统的指南 本文详细介绍如何仅利用 AI Agents 和 Kimi K3 模型构建完整的公司操作系统。文章阐述了公司 OS 的核心要素,包括词汇表、数据源、心跳机制及操作界面,并提供了具体的构建原理和 Prompt,旨在解决多 Agent 协同中的状态管理和权限控制问题。 技术 › Agent ✍ Avid🕐 2026-07-22 Kimi K3AI Agent公司操作系统构建指南ReactTypeScriptDevOps
个 个人开发者的生产级 AI 堆栈 文章探讨了 AI 时代单人开发者面临的挑战,指出虽然 AI 加速了从想法到原型的过程,但并未解决从原型到生产环境的安全和运维问题。通过分析失败案例和成功者(如 OpenClaw 作者)的实践,强调了建立构建循环、防御层和自动化运维系统的重要性。 技术 › Agent ✍ Rohit🕐 2026-07-21 AI开发独立开发安全DevOpsAgentOpenClaw生产力架构
C Claude Skills: 如何通过 Anthropic 的新功能节省 Token 并提升效率 文章介绍了 Anthropic 推出的 Claude Skills 功能,通过文件夹和 YAML 配置实现渐进式披露,显著减少 Token 消耗和重复解释。详细说明了技能的构建规则、命名规范、测试方法及分发策略,帮助用户将聊天机器人转化为高效的专业工程团队。 技术 › Skill ✍ Mr. Buzzoni🕐 2026-07-17 ClaudeSkillTokenAnthropicDevOps工具与效率LLMMCPAgent
一 一文超详细讲透GitHub:从注册、搜索到部署与协作的全流程指南 这是一篇面向 AI 编程爱好者的 GitHub“保姆级”教程。文章从开源概念与 Git/GitHub 区别讲起,详细涵盖账号注册、双重认证(2FA)、仓库创建、高效搜索技巧、仓库结构解析、Issue 提交流程以及本地 Git 操作。作者重点介绍了如何利用 AI 编程工具(如 Cursor)简化 Git 命令,并讲解了 Fork 与 Pull Request 的开源协作机制,最后分享了项目部署至 GitHub Pages 和 Vercel 的方法。 技术 › DevOps ✍ 老王霸 AI Lab🕐 2026-07-02 GitHub教程Git开源版本控制DevOps部署VercelCursor工具与效率
全 全网 Codex Skill 指南:精选资源与安装教程 本文系统梳理了 Codex 的 Skill 生态,指出安装核心 Skill(如 create-plan、gh-fix-ci)是将其从聊天机器人升级为工程团队的关键。文章汇总了必 Star 的官方与社区仓库,按场景(规划、CI/CD、测试、前端等)分类精选了神级 Skill,并提供了保姆级的安装与调用教程,最后分享了自定义 Skill 及进阶组合玩法,帮助开发者最大化利用 AI 编程工具。 技术 › Codex ✍ AYi🕐 2026-06-17 CodexOpenAIAIEngineeringSkill教程DevOpsCI/CD自动化工具效率编程助手
A Agent 工作流构建:Skills + Interpreters 实践 本文介绍了“解释器技能”的概念,这是对 Agent 技能的扩展,允许在技能中包含 TypeScript 模块。Agent 可以在行为适用时导入并运行这些代码,就像执行工作流一样。这种机制结合了 SKILL.md 的指令逻辑和解释器的代码执行能力,使 Agent 能够处理更复杂的任务,如生成子代理、调用工具,并确保关键流程的确定性和可复用性。 技术 › Agent ✍ Hunter Lovell🕐 2026-05-30 LLMAgentSkillsInterpretersTypeScriptWorkflowDeep AgentsDevOps
H Hermes Agent 完全指南:从零到自进化的 AI 员工 这是一份 Hermes Agent 的深度实操指南,涵盖了安装、模型选择、平台配置及最佳实践。文章对比了 Hermes 与 OpenClaw、Claude Code 的差异,强调了其本地化记忆、自我改进能力和多平台支持优势。核心内容涉及通过 Cron 和 /goal 命令实现全天候自主任务执行,助你打造一个能持续进化的 AI 员工。 技术 › Agent ✍ YanXbt🕐 2026-05-28 HermesAI AgentLLM自动化自我进化OpenClawClaude教程模型选择DevOps
用 用 Claude Code 简化 80% 日常工作的三件事 本文介绍了如何通过构建 Claude Code 系统来大幅提升开发效率。作者分享了三个核心实践:建立行为规范(如使用 CLAUDE.md)、定义特定角色(如 Explore 和 Plan)以及利用 /goal 命令实现自动化。通过这些方法,可以将项目维护成本降至最低,实现真正的“人负责判断,系统负责执行”。 技术 › Claude Code ✍ 老金🕐 2026-05-26 Claude Code自动化LLM开发效率promptagent编程规范DevOps工具与效率
M Mercury Agent:真正的智能体应该自带电池,而非依赖插件 文章探讨了 AI Agent 的设计哲学,批评了那些需要为读取文件、Git 操作等基础功能专门配置技能或插件的智能体。作者介绍了 Mercury Agent 的设计理念,即“开箱即用”,强调核心智能体应内置文件系统、Shell、Git、Web 获取及内存管理等能力,同时在权限、预算控制和进度追踪上保持严格边界,通过“可控代理”实现能力与安全的平衡。 技术 › Agent ✍ Zaid🕐 2026-05-17 AgentMercuryOpenclaw设计哲学权限管理工具使用LLMDevOps
C Claude Code新版本 + CodeGraph + MCP 组合拳!大型代码库直接起飞! 文章介绍了Claude Code 2.1.142、CodeGraph与MCP的“组合拳”方案,有效解决了大型代码库探索中tool call过多、上下文爆炸等问题。通过CodeGraph构建语义知识图谱,结合MCP持久化记忆与新版优化,实现了Tool call减少92%、代码探索速度提升71%的显著效果,并提供了详细的安装配置流程与实战场景指南。 技术 › Claude Code ✍ loveabit🕐 2026-05-16 Claude CodeCodeGraphMCPLLMAI编程DevOps工具与效率Agent技术选型代码优化
从 从 0 开始:用 Hooks 打造自动化 Claude Code 工作流 文章深入介绍了 Claude Code 的 Hooks 机制,这是一种在 Claude 生命周期固定节点自动执行 Shell 命令的功能。通过配置 PostToolUse、PreToolUse 等五个关键事件,开发者可以实现自动格式化、拦截危险命令、发送桌面通知和强制 Git 提交规范等自动化流程。文章提供了具体的配置示例和代码,建议将关键流程从 Prompt 转移到环境机制中,以确保代码质量和开发效率。 技术 › Claude Code ✍ Vince 聊开发🕐 2026-05-14 Claude CodeHooks自动化工作流DevOps配置指南Shell脚本LLM开发工具