痛点概述

在手撸纯 Web 版 Agent 时常会碰到以下两大困扰：

• 脚本方法不符合要求Skill 中示例脚本的方法写错后加载会直接报 MODULE_NOT_FOUND导致整个对话卡死。
• 执行结果拿不到即使脚本成功运行。如果没有将结果输出到标准输出，Bash 工具也无法把返回值回传给模型，模型只能得到空白回复。

背景

Skill 里可以定义脚本，并告诉模型如何使用。比如 ui-ux-pro-max 里有个 search.py 脚本，用来在 data 目录搜索相关的设计程序。

主要问题

1. Skill 示例脚本的方法有什么硬性要求？
2. 如何获取脚本执行后的结果并让模型使用？不过，

Skill 的加载及执行过程

下面以自研的 hello-baby 为例。展示一次完整的对话循环：

• 第一轮循环：调用 LLM 接口生成会话标题。老实说，
• 第二轮循环：发送使用者消息 “你好”。模型返回加载 "hello-baby" Skill 的指令。
• 第三轮循环："Skill" 工具读取 "hello-baby" 内容并传给模型，模型随后返回调用 Bash 工具执行 get_user_name 脚本的指令。
• 第四轮循环：Bash 工具执行 get_user_name 脚本，返回使用者名；模型再生成最终的打招呼结果。

Bash 脚本的结果如何获取？

Bash 工具只能捕获写入标准输出的内容。脚本必须使用相应语言的打印函数：

• .js: 
• .py: 
• .sh: 

If you omit print/console.log call ) script runs but Bash receives an empty string,leading to a missing answer.

Bash 脚本方法解析规则

The path written in #skill.md#,wher absolute or relative。must contain skill’s top‑level directory . Orwise runtime cannot locate file.

.claude/skills/hello-baby/scripts/get_user_name.js

/scripts/get_user_name.js ❌ MODULE_NOT_FOUND 

/Users/lzc/.../.claude/skills/hello-baby/scripts/get_user_name.js ✅ 

/hello-baby/scripts/get_user_name.js ✅ 

/scripts/get_user_name.js ❌ MODULE_NOT_FOUND 

Skill Bash 脚本执行

一、执行流程概览

使用者消息
→ 模型返回 “加载 Skill” 指令
→ Skill 工具读取对应文件内容
→ 模型返回 “Bash 执行” 指令
→ Bash 工具运行脚本
→ 将 stdout 内容回传给模型
→ 模型生成最终回复

二、方法解析规则​^{*痛点：找不到文件导致整个对话卡死*}

规则： 脚本方法中必须包含 {skill名称}/scripts/;否则抛出 TARGET_NOT_FOUND / MODULE_NOT_FOUND.

三、结果输出规则​^{*痛点：脚本运行成功却得不到答案*}

username # ❌ 同上，需要显式打印。

Shell / Bash 只有 echo 才会写入 stdout。按理说，