Kỹ năng Felo cho Pi Coding Agent: Lõi nhỏ, Web trực tiếp
Thêm kỹ năng Felo vào Pi Coding Agent để tìm kiếm trực tiếp, phiên âm, tín hiệu X và phác thảo slide — mà không cần thêm dòng mã nào vào lõi tối giản.
Pi Coding Agent giữ lõi của mình rất nhỏ. Các sub-agent và chế độ lập kế hoạch bị loại bỏ, và giao diện bạn học ngày đầu tiên vẫn giữ nguyên đến tháng thứ sáu.
Sự tiết chế này là chủ đích. Ít thành phần chuyển động bên trong giúp giảm lỗi, giảm công việc đồng bộ, và phiên làm việc giữ nguyên hành vi qua từng quý.
Tiết chế cũng có giới hạn. Khi một tác vụ cần web trực tiếp — ghi chú phát hành hôm nay, một trang không thể dán, một bài nói chuyện hội nghị, hoặc những gì mọi người đang đăng về phiên bản bạn vừa cài — một bộ harness tối giản không thể đáp ứng.
Kỹ năng là điểm mở rộng mà Pi hướng tới, và kỹ năng Pi coding agent chỉ là các thư mục Markdown thuần túy thay vì plugin biên dịch. Bộ kỹ năng Felo giúp phiên làm việc mở rộng mà không đưa gì vào lõi.
Kỹ năng là điểm mở rộng, không phải thêm công cụ
Tài liệu của Pi nói rõ phạm vi: lõi cố tình nhỏ, các tính năng như sub-agent và chế độ lập kế hoạch bị loại bỏ. Kiến thức tác vụ nằm trong kỹ năng, agent sẽ tải khi cần.
| Pi core | Một kỹ năng Felo | |
|---|---|---|
| Bản chất | Runtime, quản lý phiên, TUI, kết nối provider và model | Một gói SKILL.md mô tả trọn vẹn một công việc |
| Cách thay đổi | Mở rộng TypeScript, package, cài đặt, theme | Thêm hoặc xóa thư mục — không cần build lại |
| Truy cập web | Phụ thuộc vào provider và công cụ bạn thêm | Tìm kiếm trực tiếp, lấy trang, phiên âm kèm danh sách nguồn |
| Gánh nặng kiểm duyệt | Bạn kiểm tra extension chạy mã tùy ý | Bạn đọc quy trình Markdown trước khi tin tưởng |
Extension là mã có quyền như agent. Kỹ năng là quy trình bạn đọc trong hai phút và có thể từ chối.
Pi tìm kỹ năng ở đâu. Bốn gốc, cộng package:
~/.pi/agent/skills— mọi dự án trên máy~/.agents/skills— vị trí chia sẻ, các harness cùng chuẩn đều đọc được.pi/skills— một repository, chỉ tải sau khi bạn tin tưởng dự án.agents/skills— tương tự, ở vị trí chia sẻ- thư mục
skills/của package, hoặc mụcpi.skillstrongpackage.json
Pi kiểm tra kỹ năng theo chuẩn Agent Skills và báo lỗi hầu hết vi phạm, nên một thư mục SKILL.md đã chạy ở harness khác chỉ cần cp -r là dùng được ở đây. Kỹ năng Pi agent là thư mục bạn sở hữu, không phải plugin biên dịch vào binary.
Gốc cấp dự án chỉ tải sau khi vượt cổng tin cậy. Cổng này bảo vệ thực sự: một repository vừa clone không thể tự ý thêm quy trình mới chỉ vì bạn chạy pi trong đó.
Extension hay kỹ năng? Bộ Felo là kỹ năng, không phải extension — không gì trong đó chạy bên trong lõi Pi.
Thêm kỹ năng. Từ thư mục dự án, sao chép bundle vào gốc kỹ năng hoặc để package mang nó:
mkdir -p ~/.pi/agent/skills
cp -r felo-skills/felo-search ~/.pi/agent/skills/
Nếu cần dùng trên nhiều máy, hãy để package mang bundle:
pi install npm:@scope/pkg
pi install git:github.com/user/repo
Bạn cũng có thể tải bundle mà không cần sao chép: pi --skill /path/to/felo-search. Tham số này cộng dồn, kể cả khi bạn bắt đầu phiên với --no-skills.
Thông tin xác thực không nằm trong repository. Cài Felo CLI một lần, lưu key vào cấu hình người dùng, mọi kỹ năng đều nhận được:
npm install -g felo-ai
felo config set FELO_API_KEY your-api-key-here
CLI đọc ~/.felo/config.json, nên key không bao giờ vào commit dự án. Người dùng Pi thường bắt đầu với một thư mục, xác nhận nghiên cứu hoạt động, rồi mới thêm kỹ năng sinh đầu ra.
Năm kỹ năng Felo nên thêm
Mỗi kỹ năng giải quyết một việc terminal không tự làm được.
Felo Search — trả lời kèm nguồn
Bước nghiên cứu mà các kỹ năng khác dựa vào. Nó truy cập web trực tiếp, trả về kết quả có ngày tháng, liên kết, sẵn sàng trích dẫn ngay trong câu trả lời bạn đang soạn.
Tìm phiên bản Node khuyến nghị cho dependency này và dẫn nguồn.
Felo Slides — bộ slide từ phiên làm việc
Người duyệt đọc slide, không đọc terminal scrollback. Dàn ý đến dưới dạng văn bản trước, trong Pi, nên bạn chỉnh luận điểm trước khi có bất kỳ slide nào. Sau đó mới tạo file, nguồn được đưa vào ghi chú diễn giả.
Tóm tắt refactor này trong năm slide: chuyển gì, hỏng gì, cần duyệt gì.
Felo YouTube Subtitling — phiên âm không cần trình duyệt
Pi không có khung trình duyệt, nên video ghi hình thường ngoài tầm với. Kỹ năng này lấy phụ đề, trả về văn bản để phiên grep, trích dẫn, kiểm tra với cấu hình của bạn.
Lấy transcript của talk này và trích mọi số liệu benchmark được nhắc.
Felo X Search — tổng hợp báo cáo trên X
Nên chạy trước khi phát hành: xem có ai dùng phiên bản này gặp lỗi giống bạn không.
Tìm lỗi của thư viện này trên X và liệt kê ba lỗi lặp lại nhiều nhất.
Felo SuperAgent — tạo ảnh ngay trong phiên
Khi dự án cần favicon, logo, hoặc ảnh sản phẩm, phiên có thể tạo và chỉnh sửa thay vì đưa prompt sang nơi khác.
Phác thảo logo cho package này theo ba hướng và lưu các biến thể thành file.
Danh mục đầy đủ: felo.ai/skills/pi-coding-agent — gồm cả Felo Web Fetch để chuyển trang thành dữ liệu có cấu trúc, và Felo LiveDoc, trả lời từ tài liệu bạn cung cấp thay vì web mở.
Ba phiên nên thử
Viết đúng như bạn sẽ gõ.
Sửa lỗi theo hành vi thư viện hiện tại
Stack trace chỉ vào dependency, phiên bản bạn ghim cách hai bản so với tài liệu — hoặc vượt trước.
Lấy tài liệu hiện tại cho method này, so chữ ký với bản ghim, và sửa call site.
Kết quả trả về là bản vá kèm tài liệu chính xác đã dùng. Không phải bản vá đoán mò rồi chạy sai khi tải nặng.
Soạn brief kỹ thuật khi đang code
Bạn cần giải thích quyết định build hay mua cho người không bao giờ mở repository.
Nghiên cứu giá và giới hạn hiện tại của ba dịch vụ này, phác thảo sáu slide để tôi chỉnh.
Bảng so sánh có nguồn và bản nháp slide, từ cùng một phiên vẫn giữ code của bạn. Bản nháp là điểm mấu chốt: dàn ý dễ sửa, còn deck hoàn chỉnh phải tạo lại sẽ tốn vòng duyệt. Slide cũng có thể tạo trực tiếp tại felo.ai/slides nếu bạn muốn làm tiếp ngoài terminal.
Theo dõi sự kiện phát hành ghi hình
Talk ra mắt của vendor nhắc thay đổi hành vi không có trong changelog.
Lấy transcript, liệt kê mọi thay đổi hành vi được nhắc, kiểm tra cái nào ảnh hưởng cấu hình của mình.
Danh sách kiểm tra dựa trên bản ghi, có timestamp để kiểm chứng — không phải tóm tắt phải tin tưởng mù quáng.
Rào chắn an toàn
Pi không có sandbox phân quyền. Điều này cần nói rõ, không để chú thích. Ghi chú bảo mật của Pi nói kỹ năng có thể hướng dẫn model chạy bất cứ thứ gì người dùng chạy được. Kỹ năng mạnh ngang tài khoản shell của bạn. Đó là lý do nên đọc trước khi cài, không phải lý do tránh kỹ năng.
Đọc bundle trước. Kỹ năng Felo là Markdown thuần. Mở SKILL.md, lướt qua, xem lệnh nào model sẽ chạy. Đó là thực hành hợp lý cho mọi kỹ năng AI coding agent; với Pi, đó là toàn bộ mô hình an toàn. Nếu bundle quá dài để đọc trong một phút, hãy coi đó là phát hiện. Việc cài chỉ là copy thư mục, gỡ cũng chỉ là xóa thư mục, không có script gỡ cài, không gì còn lại trong lõi.
Tôn trọng cổng tin cậy. .pi/skills và .agents/skills cấp dự án chỉ tải sau khi bạn tin dự án. Để gốc cấp người dùng cho bundle bạn chọn kỹ, giữ phạm vi dự án đủ nhỏ để bạn nhận ra thư mục mới.
Lưu key trong cấu hình người dùng. Felo CLI đọc ~/.felo/config.json. Nếu API key xuất hiện trong .pi/skills của dự án, đó là lỗi setup, không phải hành vi kỹ năng — và lỗi này dễ lọt vào commit.
Yêu cầu nguồn trong đầu ra. Điểm mạnh của kỹ năng so với trí nhớ là mỗi khẳng định đều có ngày tháng, nơi kiểm chứng. Nêu rõ định dạng khi chưa là mặc định.
FAQ
Khác biệt giữa extension Pi và kỹ năng Felo là gì?
Extension là mã TypeScript thay đổi cách harness chạy. Kỹ năng là quy trình Markdown agent tải khi cần. Bộ Felo là kỹ năng, không chạy bên trong lõi Pi như extension.
Pi tìm kỹ năng ở đâu?
Toàn cục ở ~/.pi/agent/skills và ~/.agents/skills; theo dự án ở .pi/skills và .agents/skills sau khi tin dự án; trong package qua thư mục skills/ hoặc mục pi.skills trong package.json.
Tôi có thể phân phối kỹ năng Felo cho team qua npm không?
Pi package hỗ trợ npm, git, và đường dẫn cục bộ. Nếu team đã cài package chia sẻ bằng pi install, bundle Felo có thể đi kèm trong package dưới thư mục skills/.
Kỹ năng Felo có cần API key trong repository không?
Không. Felo CLI đọc ~/.felo/config.json. Lưu key trong cấu hình người dùng để không bao giờ vào commit dự án.
Pi không có sandbox phân quyền. Điều này có gây vấn đề cho kỹ năng không?
Nên đọc trước khi cài. Tài liệu Pi nói rõ kỹ năng có quyền như tài khoản shell. Chỉ dùng bundle đã kiểm tra, ưu tiên cái đọc trong một phút.
Nên bắt đầu với kỹ năng Felo nào?
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 hiện tại. Các kỹ năng khác hữu ích hơn khi câu trả lời có nguồn.
Chọn kỹ năng giải quyết bế tắc bạn gặp nhiều nhất, copy thư mục đó vào ~/.pi/agent/skills, và đặt câu hỏi tiếp theo với kỳ vọng có nguồn thay vì trí nhớ. Lõi vẫn nhỏ như cũ — phiên làm việc chỉ dừng đoán mò.
Khám phá kỹ năng Felo cho Pi Coding Agent →
Bài viết này cũng có sẵn bằng English, 简体中文, 日本語, 한국어, 繁體中文, हिन्दी, Français, العربية, Русский, اردو, Bahasa Indonesia, Deutsch, Türkçe, Italiano, ไทย, Español, বাংলা and Português.