小核心，硬边界

Pi 保持极简，外部世界交给 Felo 技能

Pi 刻意只带一个很小的智能体内核，让你用扩展、技能、提示词模板、主题和包去扩展它。Felo 技能不往内核里加一行代码就完成扩展——实时搜索、网页提取、字幕和演示文稿输出都以纯 Markdown 技能包的形式进来。

为 Pi 打造~/.pi/agent/skills搜索、演示文稿、字幕、X
安装技能看看取舍

极简终端编码框架

01安装 Pi
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
02技能根目录
~/.pi/agent/skills, ~/.agents/skills, .pi/skills, .agents/skills
03包安装
pi install npm:@scope/pkg 或 pi install git:github.com/user/repo
04标准
Agent Skills——与其他框架相同的 SKILL.md 格式
在项目目录里试一下pi # 然后让它找一个能把页面抓成 Markdown 的技能
极简内核扩展点是技能，而不是更多工具
四个技能根目录~/.pi/agent/skills、.pi/skills、.agents/skills、包
npm 或 curl装好框架，再往里加文件夹
没有沙箱每个技能包都先读再装
分工

Pi 保留什么，技能该承担什么

Pi 的文档把边界讲得很直接：内核刻意做小，子智能体和 plan 模式这类功能都不做。需要任务知识的地方就靠技能来扩展——包括那些离开终端的任务。

Pi 内核一个 Felo 技能
它是什么运行时、会话处理、TUI、供应商与模型管线一份把某项工作端到端讲清楚的 SKILL.md 技能包
怎么改它TypeScript 扩展、包、设置、主题加一个文件夹或删一个文件夹——不用重新构建，也不用重启内核
最适合让框架按你的工作方式运转让一项重复性任务稳定产出可靠结果
联网能力取决于供应商和你自己加的工具带来源清单的实时搜索、网页抓取和字幕
输出终端优先，流式文本和 diff可以交接出去的 Markdown、调研笔记和幻灯片
审查负担你要审计会执行任意代码的扩展你只要读一份 Markdown 流程，再决定信不信
技能推荐

五个不会碍着 Pi 内核的 Felo 技能

Pi 会从 ~/.pi/agent/skills、~/.agents/skills、项目级的 .pi/skills 和 .agents/skills，或某个包的 skills/ 目录加载技能。需要什么放什么，用不上的就别放。

Felo Search

带来源的答案
研究来源

Pi 刻意的极简意味着，加技能就是加触角，而不是加一堆需要你照看的工具。结果带日期、带链接，可以直接在同一条回复里引用。

提问示例查一下这个依赖推荐的 Node 版本，并注明你是在哪里读到的。
cp -r felo-skills/felo-search ~/.pi/agent/skills/
打开 Felo Search 页面 →

Felo Slides

从 diff 生成演示文稿
输出演示文稿

评审的人看演示文稿，不看终端滚屏。这个技能把会话查到的东西变成幻灯片，而且不用离开 Pi 的工作流。

提问示例把这个重构总结成五页幻灯片：改动了什么、弄坏了什么、需要评审什么。
cp -r felo-skills/felo-slides ~/.pi/agent/skills/
打开 Felo Slides 页面 →

Felo YouTube Subtitling

不用浏览器也能拿到字幕
视频字幕

Pi 没有浏览器面板，视频内容本来够不着。这个技能拉取字幕，交回会话可以直接检索的文本。

提问示例把这场分享的字幕拿来，抽出它引用的每一个基准测试数字。
cp -r felo-skills/felo-youtube-subtitling ~/.pi/agent/skills/
打开 Felo YouTube Subtitling 页面 →

Felo X Search

X 上的人都在反馈什么
信号社交

发布前值得跑一次：看看在同一个版本上的人是不是也撞上了你正盯着的那条报错。

提问示例搜索 X 上这个库版本相关的报错，列出重复最多的三条。
cp -r felo-skills/felo-x-search ~/.pi/agent/skills/
打开 Felo X Search 页面 →

Felo SuperAgent

品牌与产品配图
图像品牌

项目需要 favicon、Logo 组合或产品图时，同一个会话就能生成并反复修改，而不用丢给你一段提示词去别处跑。

提问示例给这个包画三个方向的 Logo，并把方案存成文件。
cp -r felo-skills/felo-superagent ~/.pi/agent/skills/
打开 Felo SuperAgent 页面 →
完整目录

选择要装进 Pi 的 Felo 技能

Pi 从你自己的文件夹加载技能，所以加一个就是复制一次。挑你接下来想让它处理的任务：调研、提取、演示文稿、字幕、社交监听，或长时间运行的工作流。

在 Pi 上添加

Felo Search

可引用来源的实时网络调研

cp -r felo-skills/felo-search ~/.pi/agent/skills/

Felo Web Fetch

把网页变成可复用的结构化数据

cp -r felo-skills/felo-web-fetch ~/.pi/agent/skills/

Felo LiveDoc

以你自己的资料为依据回答

cp -r felo-skills/felo-livedoc ~/.pi/agent/skills/

Felo YouTube Subtitling

讲座、演示和评测的字幕

cp -r felo-skills/felo-youtube-subtitling ~/.pi/agent/skills/

Felo X Search

追踪 X 上的帖子和回复

cp -r felo-skills/felo-x-search ~/.pi/agent/skills/

Felo Slides

一句话生成演示文稿

cp -r felo-skills/felo-slides ~/.pi/agent/skills/

Felo Content to Slides

把笔记和链接变成演示大纲

cp -r felo-skills/felo-content-to-slides ~/.pi/agent/skills/

Felo SuperAgent

保留记忆的长期工作流

cp -r felo-skills/felo-superagent ~/.pi/agent/skills/

Felo Twitter Writer

用你自己的素材起草 X 帖子

cp -r felo-skills/felo-twitter-writer ~/.pi/agent/skills/

Felo Landing Page

从需求说明生成落地页

cp -r felo-skills/felo-landingpage ~/.pi/agent/skills/

Apple Buy Advisor

买前的 Apple 产品调研

cp -r felo-skills/apple-buy-advisor ~/.pi/agent/skills/

想改成项目级？复制到 .pi/skills/，Pi 询问时信任该项目即可。

采用路径

Pi 用户怎么加上 Felo 技能

Pi 用户通常先装一个技能文件夹，会话保持开着，等调研确实跑通之后才补上输出类技能。

先装一个技能文件夹

Pi 会从用户层、项目或包里读取技能，所以先从范围最窄的开始。

  • ~/.pi/agent/skills 对本机所有项目生效
  • .pi/skills 只对一个仓库生效
  • 团队共享配置时用某个包的 skills/ 目录

跑第一次调研提问

会话第一次用来源而不是猜测回答你的时候，价值就出现了。

  • 把锁定的依赖和今天的发版说明对一遍
  • 合并之前先看一眼安全公告
  • 让答案留在终端里，而不是某个浏览器标签页

加上输出类技能

调研跑通之后，同一个会话就能产出团队真正会看的东西。

  • 从 diff 或调研过程生成幻灯片
  • 从分享或演示里取字幕
  • 发布前看 X 上的反馈，项目需要标识时生成图像
安装

复制一个文件夹，或者把它作为包加进来

两条路：直接复制到哪都能用，而当你想把同一个技能包装到多台机器上时，Pi 的包是更干净的选择。

  1. 01

    安装 Pi 并登录

    用 npm install 或 shell 安装脚本，然后在项目目录里运行 pi，用 /login 或供应商的 API Key 完成认证。

    终端
    npm install -g --ignore-scripts @earendil-works/pi-coding-agent
# or
curl -fsSL https://pi.dev/install.sh | sh

# then, in a project directory
pi
  2. 02

    准备 Felo 凭据

    技能调用的是 Felo CLI，所以装一次，把 Key 存在仓库之外。

    终端
    npm install -g felo-ai
felo config set FELO_API_KEY your-api-key-here
  3. 03

    添加技能

    全局技能放在 ~/.pi/agent/skills 下。项目技能放在 .pi/skills，只在你信任该项目之后加载。如果你为多个框架保留同一个共享文件夹，~/.agents/skills 也可以。

    终端
    git clone https://github.com/Felo-Inc/felo-skills.git

# Every project on this machine
mkdir -p ~/.pi/agent/skills
cp -r felo-skills/felo-search ~/.pi/agent/skills/

# Or just this repository
mkdir -p .pi/skills
cp -r felo-skills/felo-search .pi/skills/

    你也可以不复制、直接加载技能包：pi --skill /path/to/felo-search。即使启动时带了 --no-skills，这个参数也会额外追加。

  4. 04

    看看 Pi 加载了什么

    Pi 会按 Agent Skills 标准校验技能，并报出大部分不合规的地方。先要一份技能列表，再跑你真正关心的那个任务。

    问 Pi
    这个会话里有哪些技能可用？然后用 felo-search
拉取我们数据库驱动的发布说明。
实际用法

用一天 Pi 会话，会有什么不同

三个日常场景，技能比另一个扩展更合适。

01

对照库的当前行为修一个 bug

堆栈指向某个依赖，而你装的版本比文档落后两个版本。

提示词抓取这个方法当前的文档，把签名和锁定的版本对一下，然后改掉调用处。
返回结果

一个补丁，外加它所依据的那份确切文档，而不是一个能编译但行为古怪的猜测。

Felo SearchFelo YouTube Subtitling
02

一边写代码一边准备技术简报

你要向一个不会去读仓库的团队解释自研还是采购的取舍。

提示词调研这三个服务当前的定价和限制，起草六页我能直接改的幻灯片。
返回结果

一份带来源的对比和一份幻灯片草稿，都在同一个终端会话里产出。

Felo SuperAgentFelo Slides
03

补上一场录播的发布活动

某家供应商的发布会提到了一个行为变更，但它从没进过更新日志。

提示词把字幕拉下来，列出提到的每一项行为变更，并检查哪些会影响我们的配置。
返回结果

一份基于录像的清单，时间戳可以自己核对。

Felo YouTube Subtitling
常见问题

Pi 会话里常被问到的问题

Pi 扩展和 Felo 技能有什么区别？
扩展是改变框架运行方式的 TypeScript 代码。技能是智能体按需加载的 Markdown 流程。Felo 技能包属于后者，所以它们不会像扩展那样在 Pi 内核里执行。
Pi 会去哪些地方找技能？
全局在 ~/.pi/agent/skills 和 ~/.agents/skills；项目被信任之后在本项目的 .pi/skills 和 .agents/skills；以及在包内部，通过 skills/ 目录或 package.json 里的 pi.skills 字段。
能用 npm 把 Felo 技能发给团队吗？
Pi 包支持 npm、git 和本地路径。如果你们团队已经用 pi install 安装共享包，Felo 技能包可以放在同一个包的 skills/ 目录里一起走。
Felo 技能需要在仓库里放 API Key 吗？
不需要。Felo CLI 读取 ~/.felo/config.json。把 Key 放在你的用户配置里，它就永远不会进入项目提交。
Pi 没有权限沙箱，这对技能来说是个问题吗？
它是你必须先读再装的理由。Pi 自己的安全说明也写着，技能可以指示模型执行用户能执行的任何东西。只留下你审查过的技能包，优先选一分钟就能读完的那些。
我该从哪个 Felo 技能开始？
如果你的工作依赖当前版本、价格或安全公告，就从 felo-search 开始。

让内核保持小，需要什么能力就加什么

把一个文件夹复制到 ~/.pi/agent/skills，重启会话，然后问 Pi 一个需要实时联网的问题。

在 GitHub 获取技能阅读 Pi 技能文档

Felo AI 是独立的技能发行方。Pi 由 Earendil Inc. 维护。

现成技能之外

一个 API Key，一整套 Agent 工具

从技能开始，再按 Pi Coding Agent 工作流的需要组合模型、实时数据、知识和输出工具——用的还是 Felo 技能已经在用的那个 Key。

模型

当 Agent 需要自定义推理或生成时，使用性价比更高的 LLM 接入。

  • LLM API
  • 对话补全
  • 模型接入
浏览 LLM API →

实时信息

为 Agent 提供最新的 Web 与社交信号，而不是依赖过时的上下文。

  • Web Search
  • X Search
  • Web Fetch
浏览实时数据工具 →

知识与输出

把工作建立在可复用的知识之上，再转化为可以分享的交付物。

  • LiveDoc
  • PPT 生成
  • 思维导图
浏览知识工具 →

创意工具

把工作流从调研延伸到视觉呈现和可直接交付的 Office 成果。

  • 图像生成
  • 页面工具
  • Office 输出
浏览平台工具 →
浏览 API 平台 →阅读 API 文档 →

继续浏览其他平台

DeepSeek Harness采用相同技能格式的插件树框架Grok Bot机器人、技能与定时例程OpenClaw 2.0面向对话优先自动化的技能