3.x 把串流 helper 改名了。每一個用舊名字匯入它的包裝層都會無聲地壞掉。
破壞性變更Pi 上的 Felo X Search
Pi Coding Agent
Pi Coding Agent確認有沒有別人撞上同一道牆
一段 stack trace 在別人升上去的那一刻就不再獨特了。Felo X Search 讀的是關於某個版本、某個 API 或某次故障的貼文，回傳那些貼文、時間，以及每一則帶著的訊號。
cp -r felo-skills/felo-x-search ~/.pi/agent/skills/
- 套件
- felo-skills/felo-x-search
- 查詢
- 關鍵字、帳號或主題
- 回傳形式
- 帶訊號標籤的貼文
- 最有用的時候
- 發布那一週
Pi 刻意保留一個很小的核心，並要你去擴充它，所以技能就是那個「增加觸及範圍、又不必多養工具」的既定做法。
- 載入來源
- ~/.pi/agent/skills/ · .pi/skills/ · 套件
- 安裝是
- 複製一個資料夾，或 pi install npm:@scope/pkg
- 值得知道
- 沒有沙箱 —— 掛上去之前先讀 SKILL.md
在 Pi 上安裝一個唯讀套件，用和其他技能一樣的方式載入
這裡沒有任何東西能發文，所以安全問題比平常小 —— 但它還是會發出網路請求，而 Pi 還是不會把任何東西關進沙箱。先讀它，再決定根目錄要放多寬。
- 01
~/.pi/agent/skills/全域這台機器上的每個專案。讀完之後想讓它到處都在，就放這裡。
- 02
~/.agents/skills/共用其他 harness 也會讀的那個資料夾，所以一份複製就能同時服務 Pi 和你跑的其他東西。
- 03
.pi/skills/專案只給這個儲存庫，而且只在你信任這個專案之後。要評估一個還沒讀過的套件時，這裡是對的地方。
- 04
pi install npm:@scope/pkg套件某個套件的 skills/ 目錄，有版控、可更新。當一個套件值得長期留下時，這是更乾淨的路。
或者只為一個工作階段載入它，不必複製
pi --skill /path/to/felo-x-search貼文被分成各種訊號，線索就不會被誤當成證據
有用的部分是那個分類。它在你花一個下午追錯討論串之前，就把可重現的回報跟一句抱怨分開，也把維護者的回答跟推測分開。
升級後我們也一樣逾時。鎖回 2.4.1 就消失了。
可重現文件首頁還寫著 2.x 的簽章。已經帶著 diff 開了 issue。
文件落後我們這邊沒問題，但我們從來沒用過那條串流路徑，所以這大概不代表什麼。
適用範圍有限訊號標籤是關於那則貼文的一種主張，所以在你照著整組結果行動之前，值得挑一兩則回去對照討論串。
一則貼文告訴不了你的三件事
社群結果天生又快又淺。在一個發布決定要靠它們之前，這些限制值得講清楚。
一則貼文是線索，不是證據
一則可重現的回報勝過一百則抱怨。訊號標籤存在的目的，就是讓你在換版本之前分得出這兩者。
聲量不等於嚴重程度
一個很吵的討論串講某個外觀上的回歸，可以把另一個安靜講資料遺失的討論串蓋掉。按貼文主張的內容排序，不要按有多少人複述它。
API 有頻率額度
把這件事跟你這套例行任務跑的頻率對一下。一個每分鐘輪詢的守望者，會整天卡在被限速上，什麼都報不出來。
把升級出貨之前值得跑的兩項檢查
要它給可重現性的排名，不要一個心情。第一個問題決定你要不要等。
在 X 上搜尋 3.x 升級後回報逾時的人，並把你查到的按看起來多可重現排序。回傳內容貼文按訊號分組，可重現的回報排在最前面，推測的部分明顯分開。
有廠商的人員在 X 上回覆這個問題嗎？連日期一起引出來。回傳內容具名維護者帶時間戳的回覆 —— 或者一句明確的說明：官方還沒有人回應。
對一組社群結果的三項檢查
這裡的捏造看起來就像一份很有自信的摘要，所以要查的是那些零件，不是它的語氣。
帳號點得開
直接到 X 上打開其中一個帳號。一個不存在的帳號，是抓到一份憑空生出來的結果最快的方法。
時間對得上版本
這些貼文相對於你問的那個版本應該是新的，而不只是相對於今天算是新的。
標籤對得上貼文
如果一則未經查證的抱怨被標成可重現，那摘要這一步做的事就超過證據撐得住的範圍了。
Pi 使用者會問的 Felo X Search 問題
它讀得了一整個討論串嗎？
可以。當底下那串討論才是重點、而不是原始貼文的主張時，就明確要它給你某一則貼文的回覆。
它能發文或回覆嗎？
不能。這個技能只讀。它沒有任何能寫進帳號的地方，這也是它適合載入到一個無人看管的工作階段的原因。
結果有多即時？
它們來自你提問當下的即時索引，這也是為什麼每一則貼文上的時間，比它們送來的順序更重要。
它不擅長什麼？
任何需要連結文章全文的事。那是抓取的工作，不是搜尋的工作，而這兩者搭配得很好。
Pi Coding Agent 的所有 Felo 技能
這 5 項技能都是為 Pi Coding Agent 撰寫的。它們在這個平台上的用法一致，所以你可以放在同一次工作階段裡組合使用，不必重新說明自己的環境。
Felo Search
Felo Slides
Felo YouTube Subtitling
Felo SuperAgent一個 API Key，一整套 Agent 工具
從技能開始，再依 Pi 工作流程的需要組合模型、即時資料、知識與輸出工具——用的還是 Felo 技能已經在用的那個 Key。
模型
當 Agent 需要自訂推理或生成時，使用成本效益更好的 LLM 存取。
- LLM API
- 對話補全
- 模型存取
即時資訊
為 Agent 提供最新的 Web 與社交訊號，而不是依賴過時的脈絡。
- Web Search
- X Search
- Web Fetch
知識與輸出
把工作建立在可重複使用的知識上，再轉換成可分享的交付物。
- LiveDoc
- PPT 生成
- 心智圖
創意工具
把工作流程從調研延伸到視覺呈現與可直接交付的 Office 成果。
- 圖像生成
- 頁面工具
- Office 輸出