fecify skill文件结构树
fecify skill文件的结构图
1.fecify skill安装后，如何找到在本机具体的文件路径
指令：
fecify skill的文件路径是？
找到文件路径，您就可以使用编辑器打开这个skill的文件，查看skill的每个文件的内容
2.您可以在龙虾智能体里面，发送命令，会直接返回当前的skill的文件的结构图，譬如：
指令：
fecify skill的整体文件架构，整理出来一份文档内容
1.需要有一个完整的文件结构表
2.需要将temp，memory等临时文件进行排除
3.对每一个文件，以及文件夹进行说明
4.如果文件和文件夹的内容存在联系，那么也需要进行说明
总之，将skill的文件结构以及关系帮我呈现出来
文档内容给我放到电脑桌面
执行完成后
打开这个输出文件，将看到内容，如果您想要了解的更仔细，可以和AI智能体了解的更仔细
下面是v2版本的文件架构图
完整文件结构
一：Fecify Skill 三层递进式结构：
SKILL.md 第 1 层 调度摘要 → 模块路由表，选模块
↓
docs/<模块>.md 第 2 层 模块指引 → API 速查表 + 工作流 + 易错点
↓
docs/<模块>/<API>.md 第 3 层 API 参数 → 字段名/类型/必填/示例
↓
scripts/proxy/api-call.js 执行
二：三层递进式结构-优点：
- 渐进式信息获取。Agent 不需要一次性加载所有 API 细节，按需逐层深入，节省 Token。
- 职责分离。SKILL.md 只管路由，模块 .md 只管业务逻辑，API .md 只管参数定义。改一个不影响其他。
- 防错。第 3 层有 JSON Schema 做约束，api-doc.js 可查询验证，避免 Agent 凭记忆猜参数。
- 新人友好。从 SKILL.md 看模块总览即可上手，顺着链接往下挖。
- 可扩展。新增模块只需加一个 <模块>.md + <模块>/ 目录，不影响现有结构。
- 适合模块多、参数复杂的业务场景
三：文件结构说明
fecify_skills/
├── SKILL.md # 技能入口，三层路由调度摘要
│
├── docs/ # ===== 文档层 =====
│ ├── architecture.md # 整体架构说明
│ ├── extending.md # 扩展指南
│ │
│ ├── init.md # 店铺基本信息/初始化
│ ├── shop-info.md # 店铺信息（语言/货币/时区/模板等）
│ │ └── shop-info/
│ │ ├── country-list.md # 国家列表
│ │ ├── currencies.md # 货币列表
│ │ ├── europe-countries.md # 欧洲国家
│ │ ├── languages.md # 语言列表
│ │ ├── phone-codes.md # 电话区号
│ │ ├── refresh-cache.md # 刷新缓存
│ │ ├── site-url.md # Site URL 查询
│ │ ├── template-types.md # 模板类型
│ │ └── timezone.md # 时区列表
│ │
│ ├── products.md # 商品 CRUD & 工作流入口
│ │ └── products/
│ │ ├── product-create.md # 创建商品
│ │ ├── product-create-language.md # 创建多语言
│ │ ├── product-delete.md # 删除商品
│ │ ├── product-info.md # 商品详情
│ │ ├── product-list.md # 商品列表/搜索
│ │ ├── product-update.md # 更新商品
│ │ ├── product-update-columns.md # 批量更新字段
│ │ ├── product-update-columns-language.md # 批量更新多语言
│ │ ├── product-update-language.md # 全量语言更新
│ │ ├── product-update-status.md # 上架/下架状态
│ │ ├── product-update-stock.md # 库存
│ │ └── workflow-batch-upload.md # 批量上传工作流
│ │
│ ├── collection.md # 商品专辑 CRUD & 工作流入口
│ │ └── collections/
│ │ ├── collection-create.md # 创建专辑
│ │ ├── collection-delete.md # 删除专辑
│ │ ├── collection-get-product-list.md # 专辑下商品列表
│ │ ├── collection-info.md # 专辑详情
│ │ ├── collection-list.md # 专辑列表
│ │ ├── collection-set-top.md # 置顶商品
│ │ ├── collection-unbind-product.md # 解绑商品
│ │ ├── collection-unset-top.md # 取消置顶
│ │ ├── collection-update.md # 更新专辑
│ │ ├── collection-update-products.md # 添加/删除专辑商品
│ │ ├── filter-all.md # 筛选器-全部属性
│ │ ├── filter-current.md # 筛选器-当前属性
│ │ ├── filter-save.md # 筛选器-保存
│ │ └── workflow-collection-batch.md # 批量创建/更新/添加商品工作流
│ │
│ ├── product-review.md # 商品评论
│ │ └── product-review/
│ │ ├── review-create.md / review-delete.md / review-feature.md
│ │ ├── review-info.md / review-list.md / review-product-list.md
│ │ ├── review-publish.md / review-random-likes.md
│ │ ├── review-reply.md / review-show-page-all.md / review-update.md
│ │
│ ├── blog-article.md # 博客文章
│ │ └── blog-article/
│ │ ├── blog-article-create.md / -delete.md / -info.md / -list.md
│ │ ├── blog-article-update.md / -update-publish-status.md
│ │
│ ├── blog-collection.md # 博客专辑
│ │ └── blog-collection/
│ │ ├── blog-collection-create.md / -delete.md / -info.md / -list.md
│ │ ├── blog-collection-get-article-list.md / -set-article-top.md
│ │ ├── blog-collection-unbind-article.md / -unset-article-top.md
│ │ ├── blog-collection-update.md / -update-articles.md
│ │
│ ├── page.md # 自定义页面
│ │ └── page/
│ │ ├── page-create.md / -delete.md / -info.md / -list.md / -update.md
│ │
│ ├── customer.md # 客户管理
│ │ └── customer/
│ │ ├── customer-address-list.md / -contacts-info.md / -contacts-list.md
│ │ ├── customer-contacts-status.md / -create.md / -delete.md
│ │ ├── customer-info.md / -list.md / -order-list.md / -update.md
│ │
│ ├── order.md # 订单管理
│ │ └── order/
│ │ ├── order-address-get.md / -address-set.md
│ │ ├── order-archive.md / -archive-cancel.md / -cancel.md / -create.md
│ │ ├── order-force-pay.md
│ │ ├── order-fulfill-*.md (8 个)
│ │ ├── order-history-log.md / -info.md
│ │ ├── order-list-pending.md / -list-recalled.md
│ │ ├── order-pending-cancel.md / -pending-cancel-discount.md
│ │ ├── order-pending-change-discount.md / -remark-save.md
│ │ ├── order-tag-add.md / -tag-delete.md
│ │ └── workflow-ship.md # 发货工作流
│ │
│ ├── coupon.md # 优惠券管理
│ │ └── coupon/
│ │ ├── active-list.md / create.md / delete.md / disable.md
│ │ ├── generate.md / info.md / list.md
│ │ ├── statistics-all.md / statistics-info.md / statistics-list.md
│ │ └── update.md
│ │
│ ├── menu.md # 菜单管理 & 工作流
│ │ └── menu/
│ │ ├── create.md / delete.md / info.md / list.md / update.md
│ │ ├── url-select.md
│ │ ├── workflow-build.md # 缩进文本构建工作流
│ │ └── workflow-patch.md # info→修改→update 修补工作流
│ │
│ ├── shipping.md # 物流配送
│ │ └── shipping/
│ │ ├── shipping-change-status.md / -create.md / -delete.md
│ │ ├── shipping-info.md / -list.md / -update.md
│ │ ├── workflow-setup.md # 二段式批量设置工作流
│ │ ├── zone-countries.md / zone-create.md / zone-delete.md
│ │ └── zone-info.md / zone-update.md
│ │
│ ├── tax.md # 税费管理
│ │ └── tax/
│ │ ├── base-change-status.md / base-info.md / base-list.md / base-save.md
│ │ ├── custom-country-tax-list.md / -save.md
│ │ ├── custom-create.md / -delete.md / -info.md / -list.md
│ │ ├── custom-product-list.md / -product-update.md / -update.md
│ │
│ ├── system-settings.md # 系统配置
│ │ └── system-settings/
│ │ ├── blog-article-settings.md / cache.md / captcha.md
│ │ ├── checkout.md / country.md / domain.md
│ │ ├── product-config.md / product-review-config.md
│ │ ├── system-advance.md / system-basic.md / task.md
│ │
│ ├── permission.md # 权限管理
│ │ └── permission/
│ │ ├── resource-tree.md
│ │ ├── role-create.md / -delete.md / -info.md / -list.md / -update.md
│ │ ├── user-create.md / -delete.md / -info.md / -list.md
│ │ ├── user-role.md / -status.md / -update.md
│ │
│ ├── statistics.md # 数据统计
│ │ └── statistics/
│ │ ├── b2b-dashboard.md / b2c-dashboard.md
│ │ ├── customer.md / order.md / product.md
│ │ ├── product-sales.md / variant-sales.md
│ │
│ ├── task.md # 系统任务
│ │ └── task/
│ │ ├── end-task.md / info.md / list.md
│ │ ├── status-list.md / types-list.md
│ │
│ ├── url-redirect.md # URL 重定向
│ │ └── url-redirect/
│ │ ├── create.md / delete.md / info.md
│ │ ├── list.md / types.md / update.md
│ │
│ ├── base-image.md # 图片管理
│ │ └── base-images/
│ │ ├── image-delete.md / image-list.md / image-upload.md
│ │
│ ├── image-gen.md # AI 图片生成
│ │ └── image-gen/
│ │ ├── doubao-seedream-5.md
│ │ └── duomiapi-gpt-image-2.md
│ │
│ ├── language.md # 多语言翻译 & 工作流
│ │ └── language/
│ │ ├── all-languages.md / config-get.md / config-set.md
│ │ ├── shop-languages.md / translate-langs.md
│ │ ├── save-language.md
│ │ ├── get-*-translate.md (7 个实体)
│ │ ├── save-*-translate.md (7 个实体)
│ │ ├── workflow-blog-article-translate.md
│ │ ├── workflow-blog-collection-translate.md
│ │ ├── workflow-page-translate.md
│ │ ├── workflow-product-collection-translate.md
│ │ └── workflow-product-translate.md
│ │
│ ├── theme.md # 模版装修（37KB 核心文档）
│ │ └── theme/
│ │ ├── api/ # 模版 API 文档（20 个）
│ │ │ ├── center-add-shop.md / center-list.md
│ │ │ ├── file-content-get.md / -save.md / file-delete.md / file-tree.md
│ │ │ ├── fonts.md / get-add-sections.md
│ │ │ ├── market-add-theme.md / market-list.md
│ │ │ ├── page-type-select.md
│ │ │ ├── shop-add-theme.md / shop-copy.md / shop-delete.md
│ │ │ ├── shop-list.md / shop-publish.md / shop-rename.md
│ │ │ └── system-add-shop.md / system-list.md
│ │ │
│ │ ├── liquid/ # Liquid 语法参考
│ │ │ ├── advance.md / basics.md / filters.md / tags.md
│ │ │ └── schema/ # Schema 配置项
│ │ │ ├── schema-basic.md / -basic-select.md
│ │ │ ├── schema-data-select.md / -data-select-values.md
│ │ │ ├── schema-image-sizes.md / schema-items.md
│ │ │ ├── schema-text.md / schema-values.md
│ │ │
│ │ ├── samples/ # 示例模版数据
│ │ │ └── new_default_theme/
│ │ │ ├── _index.json / sample_data.json
│ │ │ └── {baby|bags|bike|book|boutique|ceramic|christmas|...}
│ │ │ └── 每个: home.json + settings_data.json + sections/
│ │ │
│ │ ├── capability-map.md # 能力地图
│ │ ├── color-design.md # 配色设计
│ │ ├── color-groups.json # 配色分组数据
│ │ ├── color-palettes.md # 色板参考
│ │ ├── config.md # Theme 配置
│ │ ├── css-guide.md # CSS 指南
│ │ ├── css-patterns.md # CSS 模式
│ │ ├── file-tree.md # 文件结构
│ │ ├── layout.md # 布局
│ │ ├── layout-recipes.md # 布局配方
│ │ ├── locales.md # 本地化
│ │ ├── section.md # 区块
│ │ ├── section-card-guide.md # 卡片区块
│ │ ├── section-design-guide.md # 区块设计
│ │ ├── snippets.md # 代码片段
│ │ ├── templates.md # 模板
│ │ ├── theme-styles.md # 样式配置
│ │ ├── workflow.md # 装修工作流
│ │ └── workflow-img.md # 图片工作流
│ │
│ ├── product-csv-import/ # CSV 导入指南
│ │ ├── fecify-csv-product-import.md
│ │ └── shopify-csv-product-import.md
│ │
│ └── schemas/ # ===== API Schema（api-doc.js 数据源）=====
│ ├── base-images.json
│ ├── blog-article.json / blog-collection.json
│ ├── collections.json / coupon.json / customer.json
│ ├── language.json / menu.json / order.json / page.json
│ ├── permission.json / product-review.json / products.json
│ ├── shipping.json / shop-info.json / statistics.json
│ ├── system-settings.json / task.json / tax.json
│ ├── theme.json / url-redirect.json
│
├── scripts/ # ===== 脚本层 =====
│ │
│ ├── base/ # 基础设施（所有脚本的依赖）
│ │ ├── api-client.js # API 客户端（get/post/put/del + 鉴权）
│ │ ├── site-config.js # 站点配置读写（多会话）
│ │ ├── check-config.js # 配置状态检查
│ │ ├── save-config.js # 保存 URL+Token + 自动 init
│ │ └── reload-init.js # 重新加载 init 数据
│ │
│ ├── proxy/ # CLI 代理（Agent 调用 API 的桥梁）
│ │ ├── api-call.js # 通用 API 调用（GET/POST/PUT/DEL）
│ │ └── api-doc.js # API 参数查询（读 schemas/）
│ │
│ ├── collection/ # 商品专辑业务脚本
│ │ ├── create.js # 创建专辑（AI 图+SEO 一步完成）
│ │ └── batch-collection.js # 批量创建/更新/添加商品
│ │
│ ├── image/ # 图片功能
│ │ └── upload-local.js # 本地图片批量上传
│ │
│ ├── image-gen/ # AI 生图引擎
│ │ ├── image-client.js # 通用客户端（genImage/genImageBatch）
│ │ ├── config.js # Provider 配置管理
│ │ ├── duomiapi-gpt-image-2.js # duomiapi Provider（异步+并发）
│ │ ├── doubao-seedream-5.js # 豆包 Provider（同步+串行）
│ │ ├── prompt-enhancer.js # Prompt 增强（电商模板）
│ │ └── generate.js # 快捷 CLI（列表/单 prompt → 生图→上传）
│ │
│ ├── language/ # 多语言翻译引擎
│ │ ├── auto-translate.js # 商品全自动翻译（collect→fill→apply）
│ │ ├── translate-body.js # body_html 分析（HTML/文本分离）
│ │ ├── translate-product.js # 商品批量翻译
│ │ ├── translate-collection.js # 商品专辑批量翻译
│ │ ├── translate-page.js # 自定义页面批量翻译
│ │ ├── translate-blog-collection.js # 博客专辑批量翻译
│ │ └── translate-blog-article.js # 博客文章批量翻译
│ │
│ ├── product/ # 商品业务脚本
│ │ ├── batch-upload.js # 商品批量上传（文件夹模式）
│ │ └── check-delete-permit.js # 检查商品删除权限
│ │
│ ├── product-csv-import/ # CSV 导入工具
│ │ ├── detect-fecify-csv.js # 检测 Fecify CSV 格式
│ │ ├── detect-shopify-csv.js # 检测 Shopify CSV 格式
│ │ ├── import-fecify-csv.js # 导入 Fecify CSV
│ │ └── import-shopify-csv.js # 导入 Shopify CSV
│ │
│ ├── review-csv-import/ # 评论 CSV 导入
│ │ ├── detect.js # 格式检测
│ │ └── import.js # 导入
│ │
│ ├── theme/ # 模版装修工具
│ │ ├── block-image-fields.js # 区块图片字段分析
│ │ ├── block-settings-defaults.js # 区块设置默认值提取
│ │ ├── block-settings-schema.js # 区块 Settings Schema 生成
│ │ ├── decorate-images.js # 装修图片批量处理
│ │ ├── detect-image-ratio.js # 图片比例检测
│ │ ├── extract-block-schemas.js # 提取区块 Schema
│ │ ├── extract-image-sizes.js # 提取图片尺寸
│ │ └── verify-theme.js # 模版验证
│ │
│ └── init/ # 初始化工具
│ └── get-addons.js # 获取已安装插件列表
架构关系说明
三层路由
SKILL.md (调度摘要)
↓ 路由
docs/<模块>.md (完整指引)
↓ 路由
docs/<模块>/<API>.md (详细参数)
SKILL.md 不包含 API 细节，只做模块摘要和路由跳转。Agent 根据任务类型找对应模块 .md → 再找具体 API .md。
脚本依赖链
scripts/base/api-client.js ←── 所有业务脚本都依赖它发起 API 请求
↑ uses
scripts/base/site-config.js ←── 提供 URL/Token/init 数据
↑ reads
save-config.js → 保存 URL+Token → 自动调 /api/skill/base/init
scripts/proxy/api-call.js ←── Agent CLI 调用 API 的统一入口
↑ uses api-client.js
scripts/proxy/api-doc.js ←── 查询 docs/schemas/ JSON Schema
↑ reads docs/schemas/*.json
文档 ↔ 脚本映射
| 文档模块 | 业务脚本 | 关系 |
|---|---|---|
docs/collection.md |
scripts/collection/create.js |
create.js 实现创建专辑 + AI 图 + SEO |
docs/collection.md |
scripts/collection/batch-collection.js |
batch-collection.js 实现批量三 action |
docs/products.md |
scripts/product/batch-upload.js |
商品批量上传工作流 |
docs/products.md |
scripts/product-csv-import/* |
CSV 检测 & 导入 |
docs/language.md |
scripts/language/translate-*.js |
6 实体翻译工作流 + auto-translate |
docs/image-gen.md |
scripts/image-gen/* |
AI 生图引擎（Provider + client + config） |
docs/base-image.md |
scripts/image/upload-local.js |
本地图片上传 |
docs/theme.md |
scripts/theme/* |
模版装修 8 个工具脚本 |
docs/product-review.md |
scripts/review-csv-import/* |
评论 CSV 导入 |
文件层级说明
- 根目录
SKILL.md— 唯一入口，禁止放其他文件 docs/— 纯 Markdown 文档 + JSON Schema（无脚本）docs/<模块>.md— 模块概览和工作流入口docs/<模块>/— 具体 API 参数文档docs/schemas/— API 参数定义（api-doc.js数据源）
scripts/— 纯 JS 脚本scripts/base/— 基础设施，不直接给 Agent 调用scripts/proxy/— CLI 入口，Agent 通过它调用 APIscripts/<模块>/— 各模块的业务脚本
temp/— 临时文件（已排除）memory/— 会话记忆（已排除）