安裝
npx skills add feature-sliced/skills適合誰
如果你在做前端專案的目錄重整,或者反覆糾結一段程式該放進 app、pages、features、entities 還是 shared,這組 Agent 技能更合適。它用來教編碼 Agent 應用 Feature-Sliced Design(FSD)v2.1:分層、匯入規則、放置決策,以及常見模式。方法論正文在
https://fsd.how/
它假定你已經有前端倉庫,並且接受用 npx 把技能加進編碼 Agent。只想讀方法論、不打算讓 Agent 改目錄的人,先看上面的文件即可。頁面沒有給出用戶端名單,也沒有把 FSD 寫成某一框架的專屬外掛,所以不要自行補上框架綁定。
3 分鐘完成第一次嘗試
官方安裝命令只有這一條:
npx skills add feature-sliced/skills
它會把技能寫入你的 Agent 環境。先確認本機有 npx,並且這是你要改的那個編碼 Agent,再執行。
裝好後先做唯讀核對,不要立刻重組倉庫。讓 Agent 對照 FSD v2.1,檢查目前前端結構:哪些已經落在 app/、pages/、shared/,哪些匯入方向可疑。成功訊號是:它能談分層和匯入規則,並且表現出 pages-first 的偏向——先看這三層,而不是馬上新建 features/ 或 entities/。若它開始批次移動檔,先停下來。
SKILL.md 是入口。它要求 Agent 只在任務需要時再讀參考檔,以保持初始上下文小。第一次提問盡量具體到「檢查結構 / 這段程式放哪」,避免讓它一次載入所有參考資料。
使用案例
案例一:搭建或重整前端專案結構。官方把這類任務列為使用時機。Agent 應應用 v2.1 的分層和常見模式,但偏見是 pages-first:從 app/、pages/、shared/ 開始,只有當一段穩定的共享職責已經配得上邊界時,才打開 features 或 entities。摘錄沒有給目錄模板壓縮包,也沒有寫遷移指令稿。因此第一次重整應先出一份對照說明,列出將要移動的路徑,你確認後再改檔。
案例二:判斷程式落點。另一條使用時機是:決定程式屬於 app、pages、features、entities 還是 shared。把一段現有模組交給 Agent,只問「按 FSD v2.1 該放哪一層,匯入是否違規」。它沒有寫自動修復規則,也沒有寫與特定路由庫的對照表。所以驗收只看到:給出層建議和匯入理由;若建議立刻切出 feature/entity,必須同時說明那份共享職責為什麼已經穩定。未說明就開新邊界,視為超出這份材料。
使用邊界
這組技能教的是 FSD v2.1,不是任意年份的 FSD 口述版。方法論細節以
https://fsd.how/
為準。頁面沒有涵蓋後端分層,也沒有授權 Agent 在未確認時大規模改名。
安裝路徑就是 npx skills add feature-sliced/skills。不要並列兩個安裝器。入口永遠是 SKILL.md;參考檔按需再讀。你無法根據這份摘錄點名那些參考檔,因此不要假裝已經知道完整清單。
第一次停在結構檢查和落點判斷。任何移動目錄、新建 features/entities 或改匯入別名的動作,都要先讓 Agent 列出將改的檔和理由,你確認後再繼續。