Sequenzy
Overview
Use this skill when the task is to operate Sequenzy, not to change Sequenzy's source code. Prefer the sequenzy CLI for supported workflows and explicitly call out when a requested workflow is not wired in the current implementation.
Ground Rules
- 1. Treat
packages/cli/src/index.tsx as the source of truth for which commands are actually wired. - Treat
packages/cli/src/commands/ and packages/cli/src/api.ts as the source of truth for behavior, payload shape, and API routes. - Do not promise support for commands that only appear in docs or
--help text without an attached action handler. - Prefer
sequenzy login for interactive auth and SEQUENZY_API_KEY for automation. - Prefer inspection before mutation whenever the workflow allows it.
Supported Workflows
Read references/use-cases.md before executing anything non-trivial. The currently implemented CLI flows are:
- - login and logout
- local auth/session check with INLINECODE7
- account inspection with INLINECODE8
- company inspection or creation with INLINECODE9
- stats overview or stats by campaign/sequence ID
- subscribers
list, add, get, and INLINECODE13 - lists
list and INLINECODE15 - tags INLINECODE16
- segments
list, create, and INLINECODE19 - templates
list, get, create, update, and INLINECODE24 - campaigns
list, get, create, update including reply-to updates, and INLINECODE29 - sequences
list, get, create, update, enable, disable, and INLINECODE36 - websites
list, add, check, and INLINECODE40 - API key creation with INLINECODE41
- send one transactional email by template or raw HTML
Unsupported Or Placeholder Workflows
Treat sequenzy generate ... as unsupported placeholder surface. Also treat missing subcommands as unsupported even when the noun exists. For example: campaign send/schedule flows, list deletion, tag mutation, and bulk subscriber import are not available through the current CLI handlers.
Execution Pattern
- 1. Check auth first with
sequenzy whoami or by verifying SEQUENZY_API_KEY is set. - Pick the narrowest command that matches the use case.
- Validate IDs, recipient email, subject, template, or HTML input before issuing a mutation.
- Surface CLI limitations directly instead of inventing a workaround.
- If the workflow is unsupported in the CLI, say whether the next-best path is the Sequenzy dashboard or direct API use.
- Call out implementation caveats that matter operationally, such as
whoami using cached local auth state, sequence creation supporting both --goal and explicit step modes, and campaigns test being a stubbed success path in the current backend.
References
Sequenzy
概述
当任务涉及操作Sequenzy而非修改其源代码时使用此技能。对于支持的工作流程,优先使用sequenzy CLI,并在当前实现中未接入所请求的工作流程时明确说明。
基本规则
- 1. 将packages/cli/src/index.tsx视为实际接入命令的权威来源。
- 将packages/cli/src/commands/和packages/cli/src/api.ts视为行为、负载结构和API路由的权威来源。
- 不要承诺支持仅出现在文档或--help文本中但未附带操作处理程序的命令。
- 交互式认证优先使用sequenzy login,自动化场景优先使用SEQUENZYAPIKEY。
- 在工作流程允许的情况下,优先进行检查而非修改。
支持的工作流程
在执行任何非平凡操作前,请阅读references/use-cases.md。当前已实现的CLI流程包括:
- - 登录和登出
- 使用whoami进行本地认证/会话检查
- 使用account进行账户检查
- 使用companies list|get|create进行公司检查或创建
- 统计概览或按活动/序列ID查看统计
- 订阅者list、add、get和remove
- 列表list和create
- 标签list
- 细分list、create和count
- 模板list、get、create、update和delete
- 活动list、get、create、update(包括回复地址更新)和test
- 序列list、get、create、update、enable、disable和delete
- 网站list、add、check和guide
- 使用api-keys create创建API密钥
- 通过模板或原始HTML发送单封事务性邮件
不支持或占位符工作流程
将sequenzy generate ...视为不支持的占位符。即使名词存在,缺失的子命令也应视为不支持。例如:活动发送/调度流程、列表删除、标签修改和批量订阅者导入在当前CLI处理程序中不可用。
执行模式
- 1. 首先使用sequenzy whoami检查认证状态,或验证SEQUENZYAPIKEY是否已设置。
- 选择与用例匹配的最精确命令。
- 在执行修改前验证ID、收件人邮箱、主题、模板或HTML输入。
- 直接说明CLI的限制,而非发明变通方案。
- 如果工作流程在CLI中不受支持,说明次优方案是使用Sequenzy仪表盘还是直接调用API。
- 指出操作上重要的实现注意事项,例如whoami使用缓存的本地认证状态、序列创建支持--goal和显式步骤模式,以及campaigns test在当前后端中为存根成功路径。
参考文档