Skip to main content

Felo 技能適用於 Pi Coding Agent:精簡核心,連接網路

· 閱讀時間約 9 分鐘
Felo Search Tips Buddy
Committed to answers at your fingertips

將 Felo 技能加入 Pi Coding Agent,取得即時搜尋、逐字稿、X 訊號與簡報草稿功能,無須為精簡核心新增任何程式碼。

Cover: a very small solid core at the centre of a wide translucent mesh of lines reaching far outward

Pi Coding Agent 的核心設計精簡。子代理與規劃模式刻意不納入,第一天學到的操作介面,六個月後依然維持不變。

這種精簡是設計重點。核心內部元件減少,除錯工作減輕,同步負擔降低,會話行為在下個季度依然一致。

精簡有其界線。當任務需要即時網路資訊——今日的發佈說明、無法貼上的網頁、會議演講、大家對你剛安裝版本的討論——精簡核心無法處理。

技能是 Pi 預期你使用的擴充點,Pi coding agent 技能以純 Markdown 資料夾呈現,不是編譯插件。Felo 的技能包讓會話取得這些能力,核心本身不需變動。

技能是擴充點,不是額外工具

Pi 文件明確界定範圍:核心刻意精簡,子代理與規劃模式等功能不納入。任務知識屬於技能,代理在任務需要時載入技能。

Four skill root folders converging on one central point, with one folder sitting behind a trust gate

Pi coreA Felo skill
What it isRuntime, session handling, TUI, provider and model plumbingA SKILL.md bundle describing one job end to end
How it changesTypeScript extensions, packages, settings, themesAdd or remove a folder — no rebuild
Web accessLeft to the provider and the tools you addLive search, page fetching, and transcripts with source lists
Review burdenYou audit extensions that run arbitrary codeYou read a Markdown procedure before you trust it

擴充是程式碼,擁有與代理同等權限。技能是你能在兩分鐘內讀完並決定是否採用的流程。

Pi 尋找技能的位置。 四個根目錄,加上套件:

  • ~/.pi/agent/skills — 機器上所有專案共用
  • ~/.agents/skills — 共用位置,符合標準的代理皆可讀取
  • .pi/skills — 單一儲存庫,僅在你信任專案後載入
  • .agents/skills — 同上,於共用位置
  • 套件的 skills/ 目錄,或 package.jsonpi.skills 欄位

Pi 依據 Agent Skills 標準驗證技能,並回報大部分違規情形,因此在其他代理已運作的 SKILL.md 資料夾,只需 cp -r 即可在此使用。Pi agent 技能是你擁有的資料夾,不是編譯進二進位檔的插件。

專案層級根目錄僅在信任提示後載入。這道門檻有其作用:剛複製的儲存庫不會因你在其中執行 pi 而直接新增流程給你的會話。

擴充或技能? Felo 技能包是技能,不是擴充——它們不會在 Pi 核心內執行任何程式碼。

如何加入技能。 在專案目錄中,複製技能包到技能根目錄,或讓套件攜帶:

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

若同一技能包需在多台機器使用,讓套件攜帶:

pi install npm:@scope/pkg
pi install git:github.com/user/repo

也能直接載入技能包,無需複製:pi --skill /path/to/felo-search。這個旗標可疊加,即使用 --no-skills 開啟會話也能加入。

憑證不進儲存庫。 安裝 Felo CLI 一次,將金鑰存入使用者設定,每個技能都能讀取:

npm install -g felo-ai
felo config set FELO_API_KEY your-api-key-here

CLI 讀取 ~/.felo/config.json,金鑰不會進入專案提交。Pi 使用者通常先用一個資料夾,確認研究功能可用,再加入產出技能。

五個值得加入的 Felo 技能

每個技能都能處理終端機無法單獨完成的任務。

Felo Search — 答案附來源

其他技能依賴的研究步驟。連接即時網路,回傳有日期與連結的結果,方便在同一回覆中引用。

找出這個依賴推薦的 Node 版本,並附上閱讀來源。

Felo Slides — 會話產生簡報

審查者閱讀簡報,不看終端機回溯。大綱先以文字形式進入 Pi,你能先調整論點,然後才產生檔案,來源也會納入講者備註。

用五張投影片摘要這次重構:哪些移動、哪些損壞、哪些需要審查。

Felo YouTube Subtitling — 無需瀏覽器取得逐字稿

Pi 沒有瀏覽器面板,錄影通常無法取得。這個技能抓取字幕,回傳文字,會話能 grep、引用、比對設定。

取得這場演講的逐字稿,列出所有引用的效能數字。

Felo X Search — X 上的用戶回報

發佈前值得執行:找出是否有其他人在這個版本遇到同樣錯誤。

搜尋 X 上這個函式庫版本的錯誤,列出最常見的三個。

Felo SuperAgent — 會話產生圖片

專案需要 favicon、logo 或產品照時,會話能直接產生並調整,不需另行輸入提示。

為這個套件設計三種方向的 logo,並將各版本存檔。

完整目錄:felo.ai/skills/pi-coding-agent——包含 Felo Web Fetch(將網頁轉為結構化資料)、Felo LiveDoc(從你提供的文件回答,而非開放網路)。

三種值得執行的會話

以你實際輸入的方式撰寫。

根據現行函式庫行為修正錯誤

堆疊追蹤指向依賴,固定版本比文件落後兩個版本——或領先。

抓取這個方法的現行文件,比對簽名與固定版本,修正呼叫處。

回傳的是修補檔與其依據的文件,不是能編譯但在負載下表現異常的猜測。

邊寫程式邊準備技術簡報

你需要向不會開啟儲存庫的人說明自建與購買的決策。

研究這三個服務的現行價格與限制,草擬六張可編輯的投影片。

同一會話產生有來源的比較與簡報草稿,草稿階段調整成本低,完成簡報需重新產生則增加審查週期。投影片也可直接在 felo.ai/slides 編輯,方便離開終端機繼續作業。

追蹤錄影發佈活動

廠商發表會提到行為變更,卻未寫入 changelog。

抓取逐字稿,列出所有提到的行為變更,檢查哪些影響設定。

根據錄影整理的檢查清單,附上可驗證的時間戳,不需憑信任接受摘要。

防護措施

Pi 沒有權限沙盒。 這是誠實的部分,應放在正文而非註腳。Pi 的安全說明指出,技能能指示模型執行使用者能執行的任何操作。技能權限等同你的 shell 帳號。這是安裝前閱讀的理由,不是避免技能的理由。

先讀技能包。 Felo 技能是純 Markdown。打開 SKILL.md,瀏覽內容,檢查模型會執行哪些指令。這是 AI coding agent 技能的基本安全做法,在 Pi 上更是全部安全機制。若技能包一分鐘讀不完,這就是發現。安裝只需複製資料夾,移除也只需刪除資料夾,無需卸載腳本,核心內不留殘餘。

遵守信任門檻。 專案層級 .pi/skills.agents/skills 僅在你信任專案後載入。使用者層級根目錄留給你刻意選擇的技能包,專案範圍保持精簡,方便辨識新資料夾。

金鑰存於使用者設定。 Felo CLI 讀取 ~/.felo/config.json。若 API 金鑰出現在專案的 .pi/skills,這是設定錯誤,不是技能行為——這種錯誤容易進入提交。

要求產出附來源。 技能優於回憶的關鍵在於每個主張都有日期與查證位置。若格式非預設,請明確要求。

FAQ

Pi 擴充與 Felo 技能有何不同?

擴充是 TypeScript 程式碼,能改變代理運作方式。技能是 Markdown 流程,代理按需載入。Felo 技能包屬於技能,不會像擴充一樣在 Pi 核心內執行。

Pi 尋找技能的位置?

全域在 ~/.pi/agent/skills~/.agents/skills;專案層級在 .pi/skills.agents/skills,需專案信任後載入;套件內則透過 skills/ 目錄或 package.jsonpi.skills 欄位。

能用 npm 將 Felo 技能分發給團隊嗎?

Pi 套件支援 npm、git 與本地路徑。若團隊已用 pi install 安裝共用套件,Felo 技能包可放在同一套件的 skills/ 目錄。

Felo 技能需要將 API 金鑰放進儲存庫嗎?

不需要。Felo CLI 讀取 ~/.felo/config.json。金鑰存於使用者設定,不會進入專案提交。

Pi 沒有權限沙盒,這對技能有問題嗎?

這是安裝前閱讀的理由。Pi 文件明確指出技能擁有 shell 帳號全部權限。僅安裝你已審查的技能包,優先選擇能在一分鐘內讀完的。

應該從哪個 Felo 技能開始?

若你的工作仰賴現行版本、價格或公告,建議先用 Felo Search。其他技能在答案附來源後更實用。


挑選最常遇到瓶頸的技能,將資料夾複製到 ~/.pi/agent/skills,下次提問時期待有來源而非回憶。核心維持原本精簡——會話不再猜測。

探索 Pi Coding Agent 的 Felo 技能 →


本文也提供以下語言版本:English简体中文日本語한국어हिन्दीFrançaisالعربيةРусскийاردوBahasa IndonesiaDeutschTiếng ViệtTürkçeItalianoไทยEspañolবাংলাPortuguês