061：Skill 系统入门——内置 Skills 的触发机制、参数传递与链式调用

061、Skill 系统入门：内置 Skills 的触发机制、参数传递与链式调用

上周五晚上，我正调试一个跨模块的数据清洗流水线，CodeX 突然在日志里吐出一行“Skill chain depth exceeded”。当时我盯着屏幕愣了五秒——明明只调了三个 Skill，怎么就说链太深了？后来翻源码才发现，我无意中让一个 Skill 递归调用了自己，而 CodeX 的链式调用默认深度限制是 5 层。这个坑让我意识到，如果不把 Skill 系统的触发机制、参数传递和链式调用摸透，迟早会被这种“优雅的陷阱”绊倒。

内置 Skills 的触发机制：别被“自动”二字骗了

CodeX 内置的 Skills 不是靠魔法触发的。每个 Skill 本质上是一个注册在全局命名空间里的函数，但触发方式分三种：显式调用、隐式匹配和事件钩子。显式调用最直接，比如@Skill("data_clean")这种装饰器写法，你明确告诉 CodeX 要执行哪个 Skill。隐式匹配就有点意思了——CodeX 会根据当前上下文中的关键词或数据类型自动匹配 Skill。比如你传一个pandas.DataFrame进去，如果内置了df_analyzeSkill，它会自动触发。但这里踩过坑：隐式匹配的优先级低于显式调用，如果你同时写了显式调用和隐式匹配的条件，CodeX 会优先执行显式调用的那个，隐式匹配