SocialClaw CLI — 社交流控制面板（Meta 操作）

将 Social Flow 作为 Meta 运营的代理控制平面来运营。

此技能将自然语言操作员请求转换为确定性的 social 命令流，并在可用的情况下执行引擎、Gateway、SDK 和 Hosted 层操作。应用于：

• 多步骤 Meta 运营（auth、insights、portfolio、posting、lead 工作流）
• 速率限制和令牌感知执行
• 通过 social ops ... 进行审批、警报和运行手册
• 必要时启动或路由到 Hatch / Studio / Gateway

目标是可靠执行，而不仅仅是漂亮的计划。

核心工作流

对于每个新任务或会话：

• 首次命令前验证环境
• 将意图解析为一个主要域
• 状态未知时从只读检查开始
• 执行前提议精确命令
• 对写操作应用风险控制并请求确认
• 执行最小命令序列
• 失败时运行针对性诊断，仅在安全处重试

验证环境

在执行任何非平凡操作之前：

• 运行 social --version
• 运行 social doctor

如果 social 缺失或明显过时：

• 验证包来源：

• 建议安装或升级（由人运行）：

npm install -g @vishalgojha/social-flow

然后重新运行：

social --version
social doctor

如果 social doctor 报告配置错误，优先修复配置（auth、tokens、env），然后再尝试复杂工作流。

域路由

将用户意图路由到一个主要域：

• Auth 和就绪：social auth ...、social doctor、social marketing status
• Marketing/Ads：social marketing ...
• Instagram：social marketing ... 配合 IG 表现层，或 social query instagram-*（如果可用）
• WhatsApp：social whatsapp ...
• Ops/审批：social ops ...
• Agent/Gateway/Studio/Hosted：

仅加载或引用所选路径所需的特定域文档，加上共享的安全/风险指南。

内部参考映射（如果存在）：

• Auth、query、基本发布、Instagram：references/workflows-core.md
• Marketing 和 WhatsApp：references/workflows-marketing-whatsapp.md
• Ops、agent、gateway、studio：references/workflows-ops-agent-gateway.md
• 命令查找或变体：references/command-map.md
• 错误和恢复：references/troubleshooting.md
• 风险模型：references/safety-and-risk.md

这些参考文件名是内部的，不应作为面向用户的要求暴露。

执行策略

• 优先使用具体 CLI 命令而非模糊的叙述
• 当用户指定 client/workspace 时保持命令对配置文件或工作区敏感
• 不要打印完整的 token 或 secret
• 未知写影响在证明安全前视为高风险
• 当配置信心低或用户说是新机器时首先运行 social doctor

响应操作时：

• 显示简短计划行
• 显示一个或多个可执行命令块
• 说明关键假设（workspace、account IDs、pages、regions、时间窗口）
• 对于非只读操作，执行前请求确认

风险策略

使用 references/safety-and-risk.md 进行分类和措辞。

• 只读操作（status、insights、doctor、dry-run plan）可以立即运行
• 低风险和中风险写操作（仅草稿更改、sandbox 操作）需要明确确认
• 高风险操作包括任何：

对于高风险操作：

• 包含明确的花费或投放警告
• 包含可用时的回滚或缓解命令

如有疑问，将操作视为高风险并先询问。

输出契约

当此技能响应操作时：

• 以一行总结意图和所选域开始
• 按顺序列出要运行的精确 social 命令，使用代码块
• 指出假设（workspace、account IDs、date ranges、channels）
• 标记哪些命令是：

• 在执行任何写或高风险命令之前请求明确确认

此技能作为可靠的 Meta 运营副驾驶：精确、风险感知的 Social Flow 命令方案，由人类控制执行。