安装
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 列出将改的文件和理由,你确认后再继续。