Fecify Skill 二次开发 — 扩展功能

您不需要手动写代码。只需告诉智能体（Agent）您想做什么，Agent 会按照 Fecify Skill 的架构规范，自动完成所有开发工作。 您可以使用 Fecify 已有的工作流，也可以制定自己的新工作流。您可以接入自己的系统 API 或者第三方系统 API，协同完成。

可以扩展什么？

Fecify Skill 支持以下四类扩展：

如何让 Agent 帮你开发？

你只需要用自然语言描述需求，Agent 会自动完成。不同需求的提法如下：

需求 1：新增工作流

你只需要描述：

• 这个工作流做什么
• 涉及哪些数据（商品/专辑/订单等）
• 分为几步
• 有什么特殊规则

示例指令：

"帮我做一个批量改价的工作流：我提供商品ID和新价格，你先列出商品清单让我确认，确认后批量更新价格，最后刷新缓存。"

"帮我做一个自动补全SEO的工作流：扫描所有商品，找出meta字段为空的，用AI自动生成补全。"

Agent 会：

1. 确定涉及的 API
2. 按工作流模式（二段式提交 / 收集→确认→执行等）设计流程
3. 写好工作流文档（docs/.../workflow-xxx.md）
4. 如有复杂逻辑，编写业务脚本（scripts/.../xxx.js）
5. 注册到模块路由（更新 SKILL.md）

需求 2：新增业务模块

你只需要提供：

• 模块名称和用途
• API 列表（路径、方法、每个 API 的功能和参数）
• 模块的特殊注意事项（如果有）

示例指令：

"帮我新增一个「邮件营销」模块。API 包括：

1. 活动列表 GET /api/skill/email-campaign/list — 按名称/状态搜索
2. 创建活动 POST /api/skill/email-campaign/create — 含标题/正文/收件人群组
3. 发送活动 POST /api/skill/email-campaign/send — 发送指定活动 注意事项：发送后不可撤回，创建时状态默认为草稿"

Agent 会：

1. 创建结构化 API 定义（docs/schemas/email-campaign.json）
2. 创建模块文档（docs/email-campaign.md）
3. 为每个 API 创建详细参数文档（docs/email-campaign/xxx.md）
4. 注册到模块路由

需求 3：接入第三方系统 API

你只需要告诉 Agent：

• 系统名称和用途
• API 地址和认证方式（Key / Token / 账号密码）
• 需要哪些数据交互（比如"从ERP同步库存到Fecify"）
• 交互频率（一次性 / 每天 / 实时触发）

示例指令：

"帮我对接我们的 ERP 系统。API 地址 https://erp.xxx.com/api，用 API Key 认证。需要实现两个功能：

1. 每天早上8点从ERP拉取库存数据，同步更新到Fecify
2. Fecify 产生新订单后，自动推送到ERP"

Agent 会：

1. 创建 API 客户端封装（scripts/third-party/erp-client.js）
2. 编写协同工作流脚本
3. 配置定时任务（如需要）
4. 输出环境变量说明和使用文档

需求 4：新增数据格式支持

你只需要提供：

• 平台名称（如 淘宝、Amazon、1688）
• 一份该平台的 CSV 示例文件
• 它的列名有什么特征（用来识别和区分格式）

示例指令：

"帮我支持阿里巴巴 CSV 导入。这是示例文件 [上传CSV]。特点是：列名含「价格区间」「销售属性」，商品按「货号」分组。"

Agent 会：

1. 分析 CSV 结构，编写格式检测器
2. 创建导入器（列映射→分组→图片处理→API创建）
3. 写平台文档
4. 接入到 CSV 导入系统

扩展的设计模式

Agent 在开发扩展时会使用 Fecify Skill 的标准架构模式，你不需要指定这些，但可以了解：

常见扩展需求速查

以下是一些常见扩展需求，直接复制粘贴发给 Agent 即可：

批量操作类

"帮我做一个批量操作工作流：[描述操作内容]。分两步：第一步列出清单让我确认，第二步执行并汇总结果。"

新增接口类

"帮我新增一个「[模块名]」模块。API 列表如下：

• [API1] [METHOD] /api/skill/xxx — [功能描述]
• [API2] [METHOD] /api/skill/xxx — [功能描述] 需要哪些参数，Agent通过查看api文档就可以看到"

对接外部系统类

"帮我对接 [系统名称]。API 基础地址 [URL]，认证方式 [方式]。需要实现 [交互场景]。[频率/触发条件]。"

CSV 导入类

"帮我支持 [平台名] CSV 导入。这是示例文件：[文件]，格式特征是 [描述]。"

总结