摘要

使用者痛点：很多开发者只看到 “pi 命令行编程工具”。误以为 Pi 只能用于代码生成，忽略了它的通用 Agent 框架能力。

Pi 是 earendil-works 开源的 Agent 开发框架。真正的通用能力在 pi-agent-core 这一层：一个带工具调用、状态管理和事件流的有状态 Agent 运行时官方定位可以承载任意类型 Agent，而不是专为编程场景设计的。pi-coding-agent 只是基于该运行时的第一个应用；同一套底座上，官方还在做面向 Slack/聊天场景的 pi-chat。社区也在往上装其他能力，项目本身对 npm 供应链安全下了狠功夫。并鼓励把真实的 Agent 会话数据开源，反哺整个环境。

主要优势

• 四个包，各自独立可用。编程 CLI 只是其中一个应用pi-aipi-agent-corepi-tuipi-coding-agent。不想要完整 CLI，只用底层 API 或运行时完全没问题。
• 供应链安全是一等公民，不是事后补丁直接依赖锁定精确版本、.npmrc 设置 min-release-age= 防止误装当天发布的新包、package-lock.json 作为唯一真相来源、CI 用 --ignore-scripts 安装并跑 npm audit signatures——在同类工具中相当少见。
• 权限模型诚实透明Pi 本身不带内置文件程序/进程/网络权限限制。默认以启动它的使用者权限运行，并提供 Gondolin 微虚拟机、纯 Docker、OpenShell 三种容器化方案供选择，而不是假装自己是安全的。
• 推动 Agent 会话数据开源项目鼓励使用者。

不只是编程助手：pi-agent-core 之上能长出什么

使用者痛点：很多团队需要一个通用的 Agent 运行时却找不到既支持多模型又能自行 的底座。Pi 的主要正好填补了这一空白。

pi-coding-agent 是官方基于 pi-agent-core 的第一个应用，但不是唯一。官方还维护面向 Slack/聊天场景自动化的 `，走的是完全不同方向；社区也在往 pi-agent-core` 上装其他能力，比如 pi-hermes-memory`——把 Nous Research 的 Hermes Agent 持久记忆程序移植进 Pi 环境。

# 小贴士：

• Pain Point: 误以为 Hermes 与 Pi 合并，其实两者独立； pi-hermes-memory` 是社区借鉴实现，说明 pi-agent-core` 的通用性——不同团队可以把不同来源的能力装进同一套底座里。

面向人群

• Pain Point: 被单一厂商 CLI 锁死？想要可自行 的终端编程 Agent 的开发者。
• Pain Point: 只需要统一多模型调用，却不想引入整个 Agent 框架的团队。
• Pain Point: 想在产品里嵌入通用 Agent 运行时拿 pi-agent-core` 当底座自行搭 UI 或聊天机器人。
• Pain Point: 关注 AI 工具供应链安全，需要成熟 npm 锁定/审计实践参考的团队。

快速上手

安装并运行编程 Agent CLI

npm install -g @earendil-works/pi-coding-agent
# 启动
pi
# 在任意目录进入交互式终端后直接自然语言描述任务，Agent 会调用内置工具读写文件、输入命令。

从源码本地跑

git clone https://github.com/earendil-works/pi.git
cd pi
npm install --ignore-scripts
npm run build
./pi-test.sh # 直接跑源码里的 pi，不用先发布安装

仅使用统一多模型 LLM 调用层

npm install @earendil-works/pi-ai

import { complete } from '@earendil-works/pi-ai';老实说，// 同一套接口，换 provider 只改 model 字符串
const response = await complete({
从model来看。'anthropic/claude-sonnet',messages:,});说起来，console.log;

至于Skill，让 Agent 自我

Pain Point： 缺乏简单可插拔机制导致每次功能迭代都要改代码。Pi 的 Skill 程序让你把业务逻辑当插件放进去，无需修改主要代码。

S​kill 的发现位置：

S​kill 文件结构：

name这方面，my-skill description: |

这个 skill 是做什么的、什么场景该用它

...

注意name 必须只使用小写字母、数字和连字符，与 npm 包名命名规则保持一致，以便直接对应包名分发。

S​kill 的触发方式：

• AUTOMATIC MATCHING：S​kill 的 description 会被塞进程序提示词。当使用者描述任务时如果描述与某个 skill 的 description 匹配。Agent 自动读取完整 SKILL.md 并按步骤执行，无需手动点名。话说回来，
• manual CALL：S​kill 可以通过指令 /skill:name 或 /skill:name 参数… 强制使用特定 skill。怎么说呢，
`