核心很小，邊角很利

Pi 保持極簡。外面那個世界交給 Felo 技能。

Pi 刻意出貨一個很小的 agent 核心，並要你用 extension、技能、提示詞模板、主題與套件去擴充它。Felo 技能在不往核心加程式碼的前提下擴充它 —— 即時搜尋、頁面擷取、逐字稿與簡報輸出，都以單純的 Markdown 套件送達。

為 Pi 打造~/.pi/agent/skills搜尋、簡報、逐字稿、X
安裝一個技能查看取捨

極簡終端機 coding harness

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 —— 與其他 harness 相同的 SKILL.md 格式
在一個專案目錄裡試試看pi # 接著請它找一個能把頁面抓成 Markdown 的技能
極簡核心技能才是擴充點，不是再加工具
四個技能根目錄~/.pi/agent/skills、.pi/skills、.agents/skills、套件
npm 或 curl先裝 harness，再加上資料夾
沒有沙箱安裝之前先讀過每一個套件
分工

Pi 留著什麼，而技能該扛什麼

Pi 的文件對範圍講得很直接：核心刻意做小，子 agent 與 plan 模式這類功能都刻意不放進去。技能是任務知識的既定擴充點 —— 包括會離開終端機的那些任務。

Pi 核心一個 Felo 技能
它是什麼執行環境、工作階段處理、TUI、供應商與模型的串接一個把單一工作從頭到尾講清楚的 SKILL.md 套件
它怎麼變TypeScript extension、套件、設定、主題新增或移除一個資料夾 —— 不必重建，也不必重啟核心
最適合讓這個 harness 照你的方式工作讓一件可重複的工作產出可靠的結果
網路存取交給供應商和你自己加的工具去處理即時搜尋、頁面抓取與逐字稿，都附來源清單
輸出終端機優先，串流的文字與 diffMarkdown、調研筆記，以及可以直接交出去的簡報
審查負擔你要審的是會執行任意程式碼的 extension你只要在信任它之前讀完一份 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 沒有瀏覽器面板，所以影片內容平常根本碰不到。這個把字幕拉下來，交回工作階段可以 grep 的文字。

提問範例拿這場講座的逐字稿，把裡面引用的每一個 benchmark 數字挑出來。
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、一組標誌組合或一張產品照時，同一個工作階段就能生成並反覆調整，而不是丟一段提示詞叫你去別的地方跑。

提問範例替這個套件草擬三個方向的標誌，並把各個版本存成檔案。
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 或這次調查做簡報
  • 從一場講座或一支 demo 拿逐字稿
  • 發布前跑 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，所以裝一次，並把金鑰存在儲存庫之外。

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

    加上這些技能

    全域技能放在 ~/.pi/agent/skills 底下。專案技能屬於 .pi/skills，而且只在你信任這個專案之後才載入。如果你要留一個給好幾個 harness 共用的資料夾，~/.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 的一天裡，什麼變了

三個日常時刻，技能在這裡勝過再寫一個 extension。

01

照著套件現在的行為修一個 bug

stack trace 指向某個依賴，而你裝的版本比文件落後兩個版本。

提示詞抓下這個方法目前的最新文件，把簽章跟我們鎖定的版本對一下，然後修呼叫的地方。
回傳結果

一個修補，加上它所依據的那份確切文件，而不是一個編譯得過、行為卻很怪的猜測。

Felo SearchFelo YouTube Subtitling
02

一邊寫程式，一邊準備技術簡報

你得向一個不會去讀儲存庫的團隊解釋「自建還是外購」這個決定。

提示詞調研這三個服務目前的定價與限制，並起草六頁我可以改的簡報。
回傳結果

一份附來源的比較，加上一份簡報草稿，都在同一個終端機工作階段裡產出。

Felo SuperAgentFelo Slides
03

補上一場錄下來的發布活動

某家廠商的發布講座提到一項行為變更，而它從來沒進到 changelog 裡。

提示詞把逐字稿拉下來，列出提到每一項行為變更，並確認哪些會影響我們的設定。
回傳結果

一份以那段錄影為依據的檢查清單，附上你能自己去核的時間戳。

Felo YouTube Subtitling
常見問題

在 Pi 工作階段裡會被問到的問題

Pi extension 和 Felo 技能差在哪裡？
extension 是改變 harness 執行方式的 TypeScript 程式碼。技能是 agent 按需載入的 Markdown 程序。Felo 的套件是技能，所以它們不會像 extension 那樣在 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 金鑰嗎？
不需要。Felo CLI 讀的是 ~/.felo/config.json。把金鑰留在你的使用者設定裡，它就永遠不會出現在專案的提交裡。
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外掛樹 harness，用同一套技能格式Grok BotBot、技能，以及排進日程的例行任務OpenClaw 2.0給聊天優先自動化的技能