Kỹ năng Felo cho DeepSeek Harness: Nguồn trực tiếp không cần build plugin
Thêm kỹ năng Felo vào cây plugin dsh để nghiên cứu theo ngày, tín hiệu X, bản chép lời và slide — chỉ cần gói SKILL.md, không cần build plugin.
DeepSeek Harness đặt một giả định và giữ nó ở mọi nơi: mọi thứ đều là plugin. Công cụ, mô hình, lưu trữ phiên, giao diện Web UI và kỹ năng đều được gắn vào cùng một cây plugin và giải quyết qua chuỗi scope, thay vì được nối vào vòng lặp agent.
Giả định đó giúp dsh phát triển mà không rối rắm. Khả năng bạn thêm vào là khả năng bạn có thể thay thế, giới hạn cho một repository hoặc xóa mà không ảnh hưởng đến vòng lặp xung quanh.
Nó không cung cấp cho agent thông tin về thế giới bên ngoài thư mục bạn checkout. Một phiên dsh có thể đọc mã của bạn cả ngày mà vẫn không biết changelog thư viện tuần này nói gì, trang giá hiện tại ra sao hoặc một buổi hội thảo tháng trước đã trình bày gì.
Kỹ năng Felo lấp đầy khoảng trống đó, và chúng đến đúng cách dsh mong đợi: gói SKILL.md đơn giản, chỉ cần thả vào cây plugin. Không cần build plugin. Không cần SDK. Chỉ cần sao chép một thư mục vào root mà dsh đã theo dõi, tải lại phiên, và công cụ kỹ năng có thể gọi nó như bất kỳ khả năng nào khác.
Kỹ năng cũng là plugin — chỉ nhỏ hơn
dsh gắn mọi khả năng như một plugin, và kỹ năng cũng theo ý tưởng đó ở quy mô nhỏ hơn. Một kỹ năng là một thư mục với SKILL.md mô tả khi nào dùng, chạy gì và trả về gì.
Sự phân chia này có chủ đích. Plugin thêm công cụ và dịch vụ — nhà cung cấp mô hình, backend lưu trữ, giao diện UI. Kỹ năng là hướng dẫn agent tải khi cần, nên không tốn tài nguyên cho đến khi có nhiệm vụ phù hợp.
Harness sở hữu vòng lặp; kỹ năng sở hữu kiến thức cho một công việc. Một plugin DeepSeek Harness truy cập web mở là build bạn duy trì. Một kỹ năng truy cập web mở là thư mục bạn thả vào và xóa chỉ với một lệnh.
Ba root, và chỉ một cấp
dsh đọc kỹ năng từ ba vị trí, và nơi bạn đặt gói sẽ quyết định ai nhận được nó.
| Root | Scope | Dùng cho |
|---|---|---|
<projectRoot>/.dsh/skills | Một repository | Ưu tiên phát hiện cao nhất — quy tắc nghiên cứu riêng cho repo |
<dshHome>/skills | Máy này | Khả năng mọi dự án nên thấy |
~/.agents/skills | Thư mục agent dùng chung | Gói đã kiểm duyệt bạn muốn có ở mọi phiên |
Hai chi tiết quyết định một gói có thực sự được tải hay không.
Chỉ thư mục con trực tiếp. dsh quét mỗi root chỉ một cấp. Gói ở skills/felo-search được phát hiện; cùng gói ở skills/research/felo-search sẽ không thấy. Đây là lý do phổ biến nhất khiến kỹ năng sao chép không xuất hiện, nên kiểm tra trước khi debug.
Tên dạng kebab-case. Cả gói thư mục (<name>/SKILL.md) và file đơn (<name>.md) đều được chấp nhận, nên kỹ năng một file vẫn dùng được, nhưng tên phải viết thường và có dấu gạch ngang. Tên khác sẽ bị bỏ qua.
Ba lệnh, rồi đặt câu hỏi
Kỹ năng Felo là gói di động, và Felo CLI quản lý xác thực cho tất cả. Một key dùng cho tìm kiếm, lấy trang, bản chép lời và tạo slide.
npm install -g felo-ai
felo config set FELO_API_KEY your-api-key-here
Sau đó clone repository công khai và sao chép thư mục bạn muốn.
git clone https://github.com/Felo-Inc/felo-skills.git
cd felo-skills
Ưu tiên theo phạm vi dự án, để một repository thử kỹ năng mà không thay đổi mọi phiên trên máy.
mkdir -p .dsh/skills
cp -r felo-skills/felo-search felo-skills/felo-slides .dsh/skills/
Phạm vi người dùng khi bạn quyết định giữ lại.
mkdir -p ~/.agents/skills
cp -r felo-skills/felo-search ~/.agents/skills/
Tải lại phiên và xác nhận công cụ kỹ năng đã thấy nó.
Liệt kê các kỹ năng bạn có thể gọi, rồi dùng felo-search để so sánh các mức giá hiện tại của hai nhà cung cấp đang đánh giá và trích dẫn nguồn đã dùng.
Nhà cung cấp kỹ năng theo dõi các root đã tồn tại, nên gói mới thường xuất hiện ở lần đọc catalog tiếp theo. Nếu không thấy, hãy bắt đầu phiên mới. Web UI cũng dùng registry này: chạy npx @deepseek-ai/dsh web, mở 127.0.0.1:3080, và kỹ năng của dự án cũng ở đó.
Năm kỹ năng Felo nên gắn
Chọn theo khoảng trống mỗi kỹ năng lấp đầy. Mỗi gói là thư mục bạn có thể đọc trước khi tin tưởng — điều này quan trọng vì harness chạy với quyền người dùng bình thường thay vì sandbox.
Felo Search — câu trả lời theo ngày kèm nguồn
Phiên dsh biết lockfile của bạn, không biết nhà cung cấp đã thay đổi gì tuần này. Search trả về kết quả kèm ngày và nguồn, nên agent hành động dựa trên thứ đã phát hành thay vì file dependencies nhớ.
Tìm các thay đổi breaking trong SDK vừa nâng cấp và liệt kê những thay đổi ảnh hưởng đến module này.
Felo YouTube Subtitling — talk phát hành dưới dạng văn bản
Walkthrough phát hành, demo hội nghị và review của maintainer thường ở video, không phải changelog. Bản chép lời trả về dạng văn bản để phiên có thể trích dẫn khi chỉnh sửa file.
Lấy bản chép lời từ stream phát hành này và liệt kê mọi API presenter nói đã thay đổi.
Felo X Search — nơi lỗi xuất hiện đầu tiên
Mọi người đăng về lỗi trước khi tạo issue. Đọc bài đăng và trả lời giúp phiên debug kiểm tra xem ai khác đã gặp vấn đề tương tự chưa.
Kiểm tra X xem có báo cáo về xử lý kết nối ở phiên bản này không và tóm tắt mọi người đang gặp gì.
Felo Slides — kết quả phiên, ngoài terminal
Harness sở hữu quá trình điều tra; deck là cách kết quả đến với người không đọc Markdown thô. Đề cương trả về dạng văn bản trước khi tạo slide, nên bạn đồng ý với lập luận trước — di chuyển sáu heading không tốn gì, sửa deck hoàn chỉnh thì phải tạo lại.
Chuyển checklist nâng cấp thành sáu slide, mỗi slide một rủi ro.
Felo SuperAgent — hình ảnh từ cùng phiên
Side project cần logo trước khi cần launch. SuperAgent phác thảo hướng logo và biến thể hình sản phẩm ngay trong phiên viết code.
Thiết kế ba hướng logo cho CLI này và xuất bản hướng vẫn đọc được ở 32 px.
Ngoài năm kỹ năng đó, catalog còn Felo Web Fetch để chuyển trang thành dữ liệu có cấu trúc, Felo LiveDoc cho câu trả lời dựa trên tài liệu riêng, và các gói screenshot, viết mạng xã hội, landing-page. Cách cài giống nhau: mỗi gói chỉ một lệnh copy.
Catalog đầy đủ: felo.ai/skills/deepseek-harness
Ba công việc người dùng dsh giao cho kỹ năng Felo
Viết đúng cách người dùng dsh thực sự gõ.
Nâng cấp dependency mà không đoán
Repository ghim SDK cũ. Harness đọc lockfile nhưng không đọc được migration guide của nhà cung cấp, và hai bên không đồng ý về cái gì an toàn để thay đổi.
Lấy migration guide của nhà cung cấp, tìm các vấn đề đã biết ở phiên bản major mới, và viết checklist nâng cấp cho repo này.
Kết quả trả về là checklist liệt kê file cần chỉnh, key config đã thay đổi và nguồn cho từng nhận định. Bạn sẽ review lập luận thay vì tóm tắt.
Review pull request với thế giới bên ngoài
Phiên review giữ diff, nhưng không có advisory khiến diff nguy hiểm hoặc thảo luận upstream giải thích lỗi.
Kiểm tra xem dependency này nâng lên phiên bản có CVE mở không, rồi comment kèm bằng chứng.
Comment mang advisory và release note. "Nhìn có vẻ nguy hiểm" không thể review. Nguồn có ngày thì review được.
Chuyển nghiên cứu thành deck
Bạn dành một phiên so sánh nhà cung cấp hoặc phương pháp, và giờ quyết định phải đến với người không ở terminal cùng bạn.
Tóm tắt so sánh thành sáu slide: lựa chọn, chi phí, rủi ro, khuyến nghị.
Deck tạo từ nguồn đã có trong phiên, nên mọi con số trên slide đều truy về trang gốc — cùng quy trình đề cương trước như Felo Slides, nơi lập luận được duyệt trước khi slide tồn tại.
Guardrails
dsh không sandbox kỹ năng. Agent chạy với quyền người dùng bình thường, và gói kế thừa mọi quyền đó khi tải. Hãy coi mỗi gói như code bạn đang gắn: đọc SKILL.md, đọc script nó tham chiếu. Gói Felo giúp audit ngắn: bạn đọc quy trình, không phải trace artifact đã biên dịch.
Không để secret ở layer dự án. felo config set ghi key vào ~/.felo/config.json, ngoài repository. Key dán vào thư mục kỹ năng local repo có thể bị commit cùng code.
Pin revision đã test. dsh dùng MIT license và đang preview cho developer, nên thay đổi breaking có thể xảy ra. Ghi lại commit của repository kỹ năng bạn đã copy, để khi lỗi tháng sau có điểm bắt đầu đã kiểm chứng.
Scope theo dự án trước khi global. Bắt đầu ở <projectRoot>/.dsh/skills để một repository thử kỹ năng. Chỉ nâng gói lên ~/.agents/skills khi đã đọc và quan sát hành vi.
Giữ citation. Yêu cầu nguồn có ngày trong output, mọi lần. Nhận định bạn kiểm tra được trong mười giây đáng giá hơn câu trả lời dài mà phải tin.
FAQ
dsh có hỗ trợ kỹ năng kiểu Claude không?
Có. Harness cung cấp nhóm khả năng kỹ năng đọc gói SKILL.md từ các root local như <projectRoot>/.dsh/skills và <dshHome>/skills. Thư mục kỹ năng Felo theo layout đó, nên tải được mà không cần build plugin.
Có cần viết plugin DeepSeek Harness để dùng kỹ năng Felo không?
Không. Kỹ năng là hướng dẫn agent tải khi cần; plugin thêm công cụ và dịch vụ. Chỉ cần copy thư mục vào discovery root là đủ cho skill path.
Sao kỹ năng tôi copy không xuất hiện?
Hai nguyên nhân phổ biến: thư mục lồng nhau, vì discovery chỉ đọc thư mục con trực tiếp của root, và tên không dạng kebab-case. File đơn <name>.md cũng dùng được nếu thích kỹ năng một file.
Web UI có dùng được các kỹ năng này không?
Có. Web UI và phiên terminal dùng chung registry kỹ năng, nên gói cài cho dự án sẽ xuất hiện ở cả hai. Khởi động bằng npx @deepseek-ai/dsh web và mở 127.0.0.1:3080.
Chạy trên máy làm việc có an toàn không?
dsh chạy với quyền người dùng và không sandbox kỹ năng. Giữ layer dự án để đánh giá, đọc từng SKILL.md, và chỉ nâng gói đã kiểm duyệt lên ~/.agents/skills.
Copy một gói vào project root, đặt câu hỏi repository không trả lời được, và đọc nguồn trả về. Nếu câu trả lời đủ vững, chuyển thư mục lên ~/.agents/skills — và phiên tiếp theo trên máy đó bắt đầu với khả năng chỉ cần một lệnh để thêm.
Khám phá kỹ năng Felo cho DeepSeek Harness →
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.