$ARGUMENTS 调用参数

以下示例与示意结果由本站编写，用于说明方法，不是模型实测结果。

使用场景

教学目录检查器接受文件路径和–json，用于将检查交给程序消费。$ARGUMENTS是否存在、如何注入由宿主决定，文章应先说明参数契约而非假设所有运行器相同。

具体做法

定义 catalog-check <path> [--json]，要求一个存在的许可文件路径，–json只改变输出。声明默认文本、JSON结构、成功/无效输入状态，以及未知选项与缺路径处理；按宿主参数解析传独立值，不拼执行字符串。检查有效/无效输入，在未支持变量的宿主使用实际参数机制。

反例

根据$ARGUMENTS检查随便哪个目录，自动猜缺路径和所有未知选项，参数内容可直接当shell执行。

改进写法

按教学用法catalog-check <path> [--json]解析参数：缺路径、未知flag或超许可目标报用法并停止；存在许可文件才读取。--json返回约定机器结果，默认文本。参数始终是数据，宿主变量语法另核。

为什么这样改

参数契约把调用方式、输入范围和输出连接起来，减少临时猜测。宿主相关机制单列，避免把名字像变量的文字当通用可执行能力。

如何验证

教学合法文件+–json得到可解析结果；缺路径和–jsno报无效且不读取；含空格路径仍一个参数。真实工具未实现时这些仅是接口示例，不称运行通过。

适用边界

无已确认冻结来源，catalog-check为教学接口。路径存在不证明许可，选项解析与转义依宿主。$ARGUMENTS并非所有Agent内置变量，不应凭名称承诺自动注入。