tool-runtime-pipeline

name	tool-runtime-pipeline
description	面向 OpenClaw 的工具运行时流水线技能。用于设计或审计 read/write/edit/exec/browser/cron/message 等工具从输入校验到权限判定、执行、结果标准化与失败分类的完整链路。

工具运行时流水线

这是什么

一次工具调用不是“选中工具然后跑一下”这么简单。稳定的 runtime 至少应该有这些阶段：

1. 解析工具身份
2. 校验输入
3. 进入前置治理
4. 做权限判定
5. 执行工具
6. 标准化结果
7. 进入后置治理
8. 分类处理失败

这个 skill 用来帮助你把工具执行看成一条明确的流水线，而不是散落在各处的 if/else。

在 OpenClaw 里何时使用

1. 你在审计工具调用逻辑
2. 你在设计新的工具接入方式
3. 你在排查为什么某些工具失败后很难解释
4. 你在做 hook、permission、execution 的职责划分

核心原则

1. 权限判定必须是显式阶段。
2. hook 是治理层，不是执行层。
3. 输入错误、权限错误、运行错误、超时错误要分开。
4. 工具结果要尽量标准化，方便下游处理。
5. 被阻止的调用也要有结构化结果，不要像“消失了一样”。

OpenClaw 常见流水线阶段

1. 识别工具与上下文
2. 校验参数格式
3. 前置规则或 hook 补充
4. 风险判断与是否需要确认
5. 实际执行
6. 将结果转成可被 transcript 理解的形状
7. 后处理、补充上下文、决定是否继续
8. 记录 telemetry 与错误分类

实战建议

1. schema 错误和 runtime 错误分开汇报。
2. 删除、外发、配置修改等动作要在权限阶段明确处理。
3. 工具输出过大时，结果标准化阶段就应考虑持久化或截断。
4. 失败后进入 failure hook，而不是直接跳过治理层。
5. 对被阻止的调用，要明确告诉模型是 blocked，不是 lost。

常见失败模式

1. hook 一句话绕过核心权限。
2. 所有错误都显示成“工具失败”。
3. 不同工具返回形状完全不同，后续难统一。
4. failure path 不经过治理层，偏偏最关键的时候没审计。
5. 权限逻辑塞在工具内部，系统层完全看不清。

你可以产出的东西

1. 一张工具执行阶段图
2. 一份错误分类表
3. 一份 hook 与 permission 的合并规则说明