用途：这是一个用于验证 Claude Code 技能参数替换行为的“活体测试台”。它本身不是实用工具，而是让技能作者先在此观察替换结果，再决定是否把某种写法用到其他技能中。
主要能力：演示两类替换。一类是预期内的替换，例如把位置参数捕获进命名 XML 标签（如 <arg0>、<all_args>、<arg_by_index_0>），并在正文中直接引用参数值；另一类是意外替换，即在 SKILL.md 正文里写 shell 代码示例时，$1、${1}、awk 的 $5 等会在加载时被消耗，导致代码被破坏，单引号也无法保护。
使用方式：先阅读文件并记录预期结果，然后分别以 0 个参数和 10 个 CANARY 参数运行：/example-argument-substitution 与 /example-argument-substitution CANARY_A CANARY_B CANARY_C CANARY_D CANARY_E CANARY_F CANARY_G CANARY_H CANARY_I CANARY_J，再逐段对比输出是否符合各段标注的预期。新增测试时需先写假设、加新段落并标注 10 参数与 0 参数下的预期、分别运行、观察、记录结论；涉及字面 $N 语法的已验证事实应写入 ./references/argument-substitution-reference.md（引用文件不参与替换）。
推荐模式：在 SKILL.md 顶部用捕获块把参数存入 XML 标签，之后只引用标签，不再使用裸 $N；所有含 $N 的代码示例放入 references/*.md。
适用场景：编写或调试带参数路由的 Claude Code 技能，尤其是需要区分“有意替换”与“代码被破坏”的场合。
限制：资料未提供该技能的安装方式、依赖、平台支持、收费或价格信息；其行为依赖 Claude Code 的替换机制，具体版本差异暂未提供。