把获客SOP装进Skill:附可复现源码

做矩阵获客的团队几乎人手一份 SOP 文档：什么时间段发什么内容、评论区怎么回、线索怎么分级转给销售。但 SOP 的宿命通常是写完没人看——Agent 不知道它存在，人记不住它的细节。上次我们手搓过最小 Skill，这次往前一步：把整条获客 SOP 装进 Skill，让智能体自己按剧本干活。

一、SOP 为什么总是"写了没人用"

根子在于 SOP 是给人看的散文，而 Agent 需要的是可执行的结构：什么条件下触发、要哪些输入、按什么步骤做、做完写回什么。把这三样拆清楚，SOP 就从文档变成了技能包。

二、技能包目录即契约

skill_linhuo_sop/
├── sop.md        # 剧本：触发条件 + 五步动作
├── inputs.json   # 契约：线索来源 / 客单价 / 话术库路径
└── scripts.py    # 动作：打标签、发欢迎语、建跟进任务

契约的意思是：inputs.json 声明了"你必须给我什么我才能开工"，缺参数就不启动，而不是拿着错误输入硬跑。

三、热加载器源码

class SkillLoader:
    def __init__(self, root): self.root, self.mtimes = root, {}
    def sync(self):
        for d in self.root.iterdir():
            sig = (d / "sop.md").stat().st_mtime
            if self.mtimes.get(d.name) != sig:
                self.mtimes[d.name] = sig
                self.registry[d.name] = load(d)   # 重载技能包

复现步骤：① 把现有 SOP 按上面三件套拆进目录；② Loader 每分钟扫一次 mtime（文件修改时间），变了就重载；③ Agent 每次接到线索先查技能表，命中即按剧本执行。改话术、调节奏，改文件就行，不用重启服务。

四、踩坑点

坑一：一个 Skill 塞整条链路，改一处全量回归，正确粒度是"一次活动一个包"。坑二：剧本里写死时间（"晚上 8 点发"），换时区就乱套，入参里统一传时区。坑三：只注册不注销，下线了的活动还在自动跑，Loader 要支持删除事件。

今天的行动建议：挑你们矩阵里最成熟的一条获客 SOP，今晚就拆成三件套扔进目录，明早让 Agent 按剧本接第一单。