Lõi nhỏ, cạnh sắc

Pi giữ tối giản. Skill Felo lo phần thế giới bên ngoài.

Pi mang một lõi agent cố tình thu nhỏ và yêu cầu bạn mở rộng bằng extension, skill, prompt template, theme và package. Skill Felo mở rộng nó mà không thêm mã vào lõi — tìm kiếm trực tiếp, trích xuất trang, bản ghi và đầu ra bản trình bày đều đến dưới dạng gói Markdown thuần.

Dành cho Pi~/.pi/agent/skillsTìm kiếm, bản trình bày, bản ghi, X
Cài một skillXem các đánh đổi

Harness lập trình terminal tối giản

01Cài Pi
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
02Thư mục gốc của skill
~/.pi/agent/skills, ~/.agents/skills, .pi/skills, .agents/skills
03Cài bằng package
pi install npm:@scope/pkg hoặc pi install git:github.com/user/repo
04Chuẩn
Agent Skills — cùng định dạng SKILL.md như các harness khác
Thử ngay trong thư mục dự ánpi # sau đó yêu cầu một skill lấy trang về dưới dạng Markdown
Lõi tối giảnskill là điểm mở rộng, không phải thêm công cụ
Bốn thư mục gốc skill~/.pi/agent/skills, .pi/skills, .agents/skills, gói
npm hoặc curlcài harness trước, rồi thêm thư mục
Không sandboxđọc từng gói trước khi cài
Phân chia nhiệm vụ

Pi giữ gì, và skill nên mang gì

Tài liệu của Pi nói thẳng về phạm vi: lõi được cố tình thu nhỏ, còn những tính năng như sub-agent hay plan mode bị bỏ ra ngoài. Skill chính là điểm mở rộng dự kiến cho tri thức công việc — kể cả những việc vượt ra khỏi terminal.

Lõi PiMột skill Felo
Bản chấtRuntime, xử lý phiên, TUI, hạ tầng provider và modelMột gói SKILL.md mô tả trọn vẹn một công việc
Cách thay đổiExtension TypeScript, package, cài đặt, themeThêm hoặc bỏ một thư mục — không build lại, không khởi động lại lõi
Hợp nhất vớiGiúp harness hành xử theo cách bạn làm việcGiúp một công việc lặp lại cho kết quả đáng tin
Truy cập webPhụ thuộc vào provider và công cụ bạn thêmTìm kiếm trực tiếp, lấy nội dung trang và bản ghi kèm danh sách nguồn
Đầu raƯu tiên terminal, văn bản và diff dạng luồngMarkdown, ghi chú nghiên cứu và bản trình bày để bàn giao
Công sức reviewBạn phải kiểm tra các extension chạy mã tùy ýBạn đọc một quy trình Markdown trước khi tin dùng
Skill gợi ý

Năm skill Felo giữ cho lõi Pi không bị cản trở

Pi nạp skill từ ~/.pi/agent/skills, ~/.agents/skills, thư mục cấp dự án .pi/skills và .agents/skills, hoặc từ thư mục skills/ của một package. Cần gì thì thêm vào, phần còn lại cứ để ngoài.

Felo Search

Trả lời kèm nguồn
Nghiên cứuNguồn

Pi cố tình tối giản, nên skill là cách bạn mở rộng tầm với mà không thêm công cụ phải chăm. Kết quả đến kèm ngày và liên kết, sẵn sàng để dẫn ngay trong cùng câu trả lời.

Ví dụ yêu cầuTìm phiên bản Node được khuyến nghị cho dependency này và dẫn nguồn bạn đã đọc.
cp -r felo-skills/felo-search ~/.pi/agent/skills/
Mở trang Felo Search →

Felo Slides

Bản trình bày từ diff
Đầu raBản trình bày

Người review đọc bản trình bày chứ không đọc màn hình terminal cuộn mãi. Skill này biến những gì phiên tìm được thành slide mà không rời khỏi luồng làm việc của Pi.

Ví dụ yêu cầuTóm tắt lần refactor này trong năm slide: đã chuyển gì, hỏng gì, phần nào cần review.
cp -r felo-skills/felo-slides ~/.pi/agent/skills/
Mở trang Felo Slides →

Felo YouTube Subtitling

Bản ghi không cần trình duyệt
VideoBản ghi

Pi không có khung trình duyệt, nên nội dung video thường nằm ngoài tầm với. Skill này lấy phụ đề và trả về văn bản để phiên làm việc grep được.

Ví dụ yêu cầuLấy bản ghi của bài nói này và rút ra mọi con số benchmark được nhắc tới.
cp -r felo-skills/felo-youtube-subtitling ~/.pi/agent/skills/
Mở trang Felo YouTube Subtitling →

Felo X Search

Điều mọi người báo trên X
Tín hiệuMạng xã hội

Đáng chạy trước một bản phát hành: kiểm tra xem người khác dùng phiên bản này có gặp đúng lỗi bạn đang nhìn không.

Ví dụ yêu cầuTìm trên X các lỗi từ phiên bản thư viện này và liệt kê ba lỗi được nhắc nhiều nhất.
cp -r felo-skills/felo-x-search ~/.pi/agent/skills/
Mở trang Felo X Search →

Felo SuperAgent

Hình ảnh thương hiệu và sản phẩm
Hình ảnhThương hiệu

Khi dự án cần favicon, bộ logo hay ảnh sản phẩm, chính phiên đó có thể tạo và chỉnh sửa thay vì đưa bạn một prompt để chạy nơi khác.

Ví dụ yêu cầuPhác thảo logo cho package này theo ba hướng và lưu các biến thể thành tệp.
cp -r felo-skills/felo-superagent ~/.pi/agent/skills/
Mở trang Felo SuperAgent →
Danh mục đầy đủ

Chọn skill Felo để cài trên Pi

Pi nạp skill từ một thư mục do bạn quản lý, nên thêm một skill chỉ là một lần sao chép. Hãy chọn công việc bạn muốn xử lý tiếp: nghiên cứu, trích xuất, bản trình bày, bản ghi, theo dõi mạng xã hội hoặc một quy trình chạy dài.

Thêm vào Pi

Felo Search

Nghiên cứu web trực tiếp với nguồn trích dẫn được

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

Felo Web Fetch

Biến trang thành dữ liệu có cấu trúc, dùng lại được

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

Felo LiveDoc

Câu trả lời dựa trên tài liệu của chính bạn

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

Felo YouTube Subtitling

Bản chép lời từ talk, demo và đánh giá

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

Felo X Search

Theo dõi bài đăng và trả lời trên X

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

Felo Slides

Tạo bộ slide từ một câu lệnh

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

Felo Content to Slides

Biến ghi chú và URL thành dàn ý slide

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

Felo SuperAgent

Luồng công việc dài hạn giữ nguyên bộ nhớ

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

Website Screenshot Agent

Lưu trang thành ảnh chụp và Markdown

cp -r felo-skills/doc-screenshot-agent ~/.pi/agent/skills/

Felo Twitter Writer

Soạn nháp bài đăng X từ tư liệu của bạn

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

Felo Landing Page

Tạo landing page từ bản brief

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

Apple Buy Advisor

Nghiên cứu sản phẩm Apple trước khi mua

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

Muốn giới hạn theo dự án? Hãy sao chép vào .pi/skills/ và tin tưởng dự án khi Pi hỏi.

Lộ trình áp dụng

Người dùng Pi thêm skill Felo thế nào

Người dùng Pi thường cài một thư mục skill trước, giữ phiên mở, và chỉ thêm các skill đầu ra khi phần nghiên cứu đã chạy tốt.

Cài một thư mục skill

Pi đọc skill từ lớp người dùng, từ dự án hoặc từ package, nên hãy bắt đầu với phạm vi hẹp nhất.

  • ~/.pi/agent/skills cho mọi dự án trên máy
  • .pi/skills chỉ cho một kho mã
  • Thư mục skills/ của một package khi cả nhóm dùng chung thiết lập

Chạy yêu cầu nghiên cứu đầu tiên

Giá trị thể hiện ngay lần đầu phiên làm việc trả lời kèm nguồn thay vì phỏng đoán.

  • So một dependency đang ghim với ghi chú phát hành hôm nay
  • Kiểm tra cảnh báo bảo mật trước khi merge
  • Giữ câu trả lời trong terminal, không mở thêm tab trình duyệt

Thêm các skill đầu ra

Khi nghiên cứu đã chạy tốt, chính phiên đó có thể tạo ra thứ mà cả nhóm thực sự đọc.

  • Slide từ diff hoặc từ quá trình điều tra
  • Bản ghi từ một bài nói hoặc buổi demo
  • Báo cáo từ X trước khi phát hành, hình ảnh khi dự án cần biểu trưng
Cài đặt

Sao chép một thư mục, hoặc thêm nó dưới dạng package

Hai con đường: cách sao chép trực tiếp chạy được ở mọi nơi, còn package Pi là lựa chọn gọn gàng hơn khi bạn muốn cùng một gói trên nhiều máy.

  1. 01

    Cài Pi và đăng nhập

    Dùng npm install hoặc trình cài bằng shell, sau đó chạy pi trong một thư mục dự án và xác thực bằng /login hoặc API key của provider.

    Terminal
    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

    Chuẩn bị thông tin xác thực Felo

    Skill gọi Felo CLI, nên hãy cài CLI một lần và lưu key bên ngoài kho mã.

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

    Thêm các skill

    Skill dùng toàn cục nằm dưới ~/.pi/agent/skills. Skill theo dự án thuộc về .pi/skills và chỉ được nạp sau khi bạn tin tưởng dự án. Nếu muốn một thư mục dùng chung cho nhiều harness, ~/.agents/skills cũng dùng được.

    Terminal
    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/

    Bạn cũng có thể nạp một gói mà không cần sao chép: pi --skill /path/to/felo-search. Cờ này vẫn được cộng thêm ngay cả khi bạn khởi động với --no-skills.

  4. 04

    Kiểm tra Pi đã nạp gì

    Pi kiểm tra skill theo chuẩn Agent Skills và báo phần lớn lỗi vi phạm. Hãy hỏi danh sách skill, rồi chạy đúng công việc bạn quan tâm.

    Hỏi Pi
    Phiên này có những skill nào? Sau đó dùng felo-search
    để lấy ghi chú phát hành cho driver cơ sở dữ liệu của chúng ta.
Thực tế

Một ngày làm việc với Pi thay đổi những gì

Ba khoảnh khắc thường ngày mà một skill thắng một extension khác.

01

Sửa lỗi theo hành vi hiện tại của thư viện

Stack trace trỏ vào một dependency, còn phiên bản bạn cài đang chậm hơn tài liệu hai bản phát hành.

PromptLấy tài liệu hiện tại cho phương thức này, so chữ ký hàm với phiên bản đang ghim, và vá chỗ gọi.
Kết quả trả về

Một bản vá kèm đúng tài liệu làm căn cứ, thay vì một phỏng đoán biên dịch được nhưng hành xử kỳ lạ.

Felo SearchFelo YouTube Subtitling
02

Chuẩn bị bản tóm tắt kỹ thuật trong lúc viết mã

Bạn cần giải thích quyết định tự xây hay mua cho một nhóm không đọc kho mã.

PromptNghiên cứu giá và giới hạn hiện tại của ba dịch vụ này và soạn sáu slide để tôi chỉnh sửa.
Kết quả trả về

Một bản so sánh có nguồn và một bản nháp slide, tạo ra ngay trong cùng phiên terminal.

Felo SuperAgentFelo Slides
03

Cập nhật một sự kiện phát hành đã ghi hình

Bài nói ra mắt của một nhà cung cấp nhắc tới thay đổi hành vi chưa từng xuất hiện trong changelog.

PromptLấy bản ghi, liệt kê mọi thay đổi hành vi được nhắc tới, và kiểm tra xem thay đổi nào ảnh hưởng đến cấu hình của chúng ta.
Kết quả trả về

Một danh sách kiểm tra dựa trên bản ghi, kèm mốc thời gian bạn kiểm chứng được.

Felo YouTube Subtitling
Câu hỏi

Những câu hỏi thường gặp trong một phiên Pi

Extension của Pi và skill Felo khác nhau thế nào?
Extension là mã TypeScript làm thay đổi cách harness chạy. Skill là quy trình Markdown mà agent nạp theo nhu cầu. Gói Felo là skill, nên chúng không chạy bên trong lõi Pi như một extension.
Pi tìm skill ở những đâu?
Toàn cục ở ~/.pi/agent/skills và ~/.agents/skills; theo dự án ở .pi/skills và .agents/skills sau khi dự án được tin tưởng; và bên trong package qua thư mục skills/ hoặc một mục pi.skills trong package.json.
Tôi có thể phát hành skill Felo cho cả nhóm qua npm không?
Package của Pi hỗ trợ npm, git và đường dẫn cục bộ. Nếu nhóm bạn đã cài các package dùng chung bằng pi install, gói Felo có thể đi kèm trong chính package đó dưới một thư mục skills/.
Skill Felo có cần API key trong kho mã không?
Không. Felo CLI đọc ~/.felo/config.json. Hãy giữ key trong cấu hình người dùng để nó không bao giờ lọt vào một commit của dự án.
Pi không có sandbox quyền. Điều đó có thành vấn đề với skill không?
Đó là lý do để đọc trước khi cài. Ghi chú bảo mật của chính Pi nói rằng skill có thể yêu cầu model chạy mọi thứ mà người dùng chạy được. Hãy chỉ dùng những gói bạn đã xem qua, và ưu tiên gói đọc một phút là xong.
Tôi nên bắt đầu với skill Felo nào?
Hãy bắt đầu với felo-search nếu công việc của bạn phụ thuộc vào phiên bản, giá hoặc cảnh báo bảo mật hiện tại.

Giữ lõi nhỏ. Thêm đúng khả năng bạn cần.

Sao chép một thư mục vào ~/.pi/agent/skills, khởi động lại phiên, và hỏi Pi điều gì đó cần đến web trực tiếp.

Felo AI là nhà phát hành skill độc lập. Pi do Earendil Inc. duy trì.

Vượt ra ngoài các skill có sẵn

Một API key. Trọn bộ công cụ cho agent.

Bắt đầu từ một skill, rồi ghép các model, dữ liệu trực tiếp, tri thức và công cụ đầu ra mà quy trình Pi Coding Agent của bạn cần — với đúng chiếc key mà các skill Felo đã dùng.

Model

Dùng quyền truy cập LLM tiết kiệm chi phí khi agent cần tự suy luận hoặc tạo nội dung.

  • LLM API
  • Chat completions
  • Truy cập model
Khám phá LLM API →

Tri thức và đầu ra

Đặt công việc trên nền tri thức dùng lại được, rồi biến thành sản phẩm có thể chia sẻ.

  • LiveDoc
  • Tạo PPT
  • Sơ đồ tư duy
Khám phá công cụ tri thức →

Công cụ sáng tạo

Mở rộng quy trình từ nghiên cứu đến hình ảnh và kết quả dùng được ngay trong Office.

  • Tạo hình ảnh
  • Công cụ trang
  • Đầu ra Office
Khám phá công cụ nền tảng →