Pi 上的 Felo SuperAgentPi Coding Agent

套件插圖是長工作,不該佔住工作階段

一個 favicon、一組標誌鎖定組合,或一張 README 示意圖,都是有自己的階段、自己的記憶的工作。Felo SuperAgent 把這些工作放在一塊持久畫布上,所以你是偶爾去看一下,而不是一直盯著它。

  • 技能包felo-skills/felo-superagent
  • 輸入一段文字寫成的需求
  • 回來的樣子檔案,加上做出它們的那次執行
  • 狀態放在哪在畫布上,不在工作階段裡
為 Pi 而做跑在畫布上等你拍板才往下走
取得 API Key檢視平台指南
複製進來cp -r felo-skills/felo-superagent ~/.pi/agent/skills/
Pi Coding Agent 標誌
這項技能執行於

Pi Coding Agent

極簡終端機 coding harness

閱讀 Pi Coding Agent 指南

Pi 刻意保留一個很小的核心,並要你去擴充它,所以技能就是那個「增加觸及範圍、又不必多養工具」的既定做法。

載入來源
~/.pi/agent/skills/ · .pi/skills/ · 套件
安裝是
複製一個資料夾,或 pi install npm:@scope/pkg
值得知道
沒有沙箱 —— 掛上去之前先讀 SKILL.md
你會拿到什麼

一件有階段、可以打斷的工作,而不是一個轉圈圈

長時間生成最有意思的地方,是它在哪裡停下來。這一個在審美成為決定因素的時候停住 —— 這就是一個幫得上忙的工具,和一個做出你隨手就丟的東西的工具之間的差別。

  1. 執行中

    讀需求

    套件名稱、它做什麼,以及這個標誌必須成立的兩個地方:16px 的 favicon 和 README 頁首。

  2. 執行中

    三個方向,第一輪

    一個幾何字母組合、一個具象字形,以及一個用這個套件自身輸出形狀搭出來的標誌。

  3. 受阻

    等你拍板

    兩個方向通過了審查。第三個在小尺寸下讀起來像另一個產品,所以它停下來,而不是繼續在這個方向上耗力氣。

  4. 完成

    已匯出

    按儲存庫實際用到的尺寸匯出 SVG 和 PNG,每個檔案旁邊附一句理由。

固定套路

把一個小專案推到可以定案的標誌

先限制,再方向,最後才是檔案。順序對了,這次執行就短。

執行時機

儲存庫需要一個標誌 —— 一個 favicon、一組圖示、README 用的插圖 —— 而團隊裡沒有設計師。

  1. 01

    把需求寫成限制

    寫清楚它必須撐過哪些尺寸,以及它會出現在哪兩個地方。「一個現代感的標誌」沒有給這次執行任何可以核對的東西,於是它等於在為一個不明確的目標做最佳化。

  2. 02

    要方向,不要成品

    三個方向被否掉的成本,比一個你不想要的精修標誌低。第一輪是拿來選的,不是拿來出貨的。

  3. 03

    在你真正在意的尺寸上反應

    先看 16px 下的候選,其他都排在後面。多數標誌是在那裡失敗的,而在匯出之前發現,便宜得多。

  4. 04

    讓理由跟檔案放在一起

    下一個碰品牌的人需要知道這個標誌為什麼長這樣,以及哪個方向被否掉了。

留下什麼按儲存庫用到的尺寸交付 SVG 與 PNG,外加一小段說明:哪些方向被否掉、原因是什麼。

在 Pi 上安裝

掛在哪裡都行,這次執行住在別的地方

技能包很小,工作不小,所以在這裡你選哪個根目錄幾乎不重要。重要的是握住狀態的是畫布,不是工作階段。

  1. 01
    ~/.pi/agent/skills/全域

    這台機器上的每個專案。讀完之後,如果你想讓它到處都能用,就放這裡。

  2. 02
    ~/.agents/skills/共用

    其他 harness 也會讀的資料夾,所以一次 clone 同時服務 Pi 和你跑的別的東西。

  3. 03
    .pi/skills/專案

    只對這個儲存庫生效,而且只在你信任這個專案之後。還沒讀過的技能包,適合先放這裡評估。

  4. 04
    pi install npm:@scope/pkg套件

    某個套件的 skills/ 目錄,納入版本管理、可以更新。技能包一旦確定長期使用,這是比較乾淨的路。

或者只為一次工作階段載入,不用複製pi --skill /path/to/felo-superagent
實際操作

兩個讓執行保持短暫的提示

兩者都把工作停在可以審的階段,而不是讓它一路跑到一個你可能不想要的成品。

輸入這句替這個套件的圖示畫三個方向,用 16px 和 256px 各顯示一次,並在匯出前停下來。回傳內容

兩個尺寸下的三個候選,各附一句理由,停在那裡等你挑,而不是直接匯出。

輸入這句這個標誌在小尺寸下太細了。把它簡化到仍然讀得出是同一個產品。回傳內容

一個簡化版並排在原版旁邊,讓你可以清楚看到捨掉了什麼、留下來的是什麼。

確認它有用

三個訊號,說明這次執行值得繼續

圖像生成開始很便宜、審起來很貴,所以這些檢查看的是它有沒有在尊重你的時間。

1

有階段,不是一個轉圈圈

你應該看得到這次執行在哪裡、在等什麼。一件你打不斷的工作,是一件你不會想再開始的工作。

2

它會為了審美停下來

一個替你猜判斷的執行,做出來的是你會丟掉的東西。在對的時機停在受阻狀態是功能,不是失敗。

3

匯出符合清單

把交件的尺寸對一遍儲存庫要求的大小。只交一個尺寸的標誌,等於縮放還得你自己來。

常見問題

Pi 使用者問過的 Felo SuperAgent 問題

圖像生成是在本機跑的嗎?
不是。技能包透過 CLI 呼叫 Felo 的服務,所以跑 Pi 的機器只送出需求、收下檔案,沒有別的。
我可以打斷一個走錯方向的執行嗎?
那正是要在這裡用它的原因。畫布握著狀態,所以把它導回正軌是一則訊息,不是重新開始。
我要把什麼提交進儲存庫?
匯出的檔案,和解釋它們的那段說明。執行本身住在畫布上,不屬於儲存庫。
它能取代設計師嗎?
不能。它讓一個小專案走到可用的標誌,並告訴你它決定不了的部分 —— 那才是值得交給人的地方。
Pi Coding Agent 的其他技能

Pi Coding Agent 的所有 Felo 技能

這 5 項技能都是為 Pi Coding Agent 撰寫的。它們在這個平台上的用法一致,所以你可以放在同一次工作階段裡組合使用,不必重新說明自己的環境。

現成技能之外

一個 API Key,一整套 Agent 工具

從技能開始,再依 Pi 工作流程的需要組合模型、即時資料、知識與輸出工具——用的還是 Felo 技能已經在用的那個 Key。

模型

當 Agent 需要自訂推理或生成時,使用成本效益更好的 LLM 存取。

  • LLM API
  • 對話補全
  • 模型存取
瀏覽 LLM API →

即時資訊

為 Agent 提供最新的 Web 與社交訊號,而不是依賴過時的脈絡。

  • Web Search
  • X Search
  • Web Fetch
瀏覽即時資料工具 →

知識與輸出

把工作建立在可重複使用的知識上,再轉換成可分享的交付物。

  • LiveDoc
  • PPT 生成
  • 心智圖
瀏覽知識工具 →

創意工具

把工作流程從調研延伸到視覺呈現與可直接交付的 Office 成果。

  • 圖像生成
  • 頁面工具
  • Office 輸出
瀏覽平台工具 →