Function expandSkillParameters

packages/agent-core/src/skill/parser.ts:176–214

(
  body: string,
  rawArgs: string,
  context: SkillExpandContext,
)

 * shell/CLI conventions rather than any specific product.
 */
export function expandSkillParameters(
  body: string,
  rawArgs: string,
  context: SkillExpandContext,
): string {
  const tokens = tokenizeArgs(rawArgs);
  let content = body;

  for (let index = 0; index < (context.argumentNames?.length ?? 0); index++) {
    const name = context.argumentNames?.[index];
    if (name === undefined) continue;
    const escaped = regexpEscape(name);
    content = content.replaceAll(
      new RegExp(`\\$${escaped}(?![\\[\\w])`, 'g'),
      escapeXmlTags(tokens[index] ?? ''),
    );
  }

  content = content
    .replaceAll(/\$ARGUMENTS\[(\d+)\]/g, (_match, indexText: string) => {
      const index = Number.parseInt(indexText, 10);
      return escapeXmlTags(tokens[index] ?? '');
    })
    .replaceAll(/\$(\d+)(?!\w)/g, (_match, indexText: string) => {
      const index = Number.parseInt(indexText, 10);
      return escapeXmlTags(tokens[index] ?? '');
    })
    .replaceAll('$ARGUMENTS', escapeXmlTags(rawArgs));

  const hasArgumentPlaceholder = content !== body;
  content = content
    .replaceAll('${KIMI_SKILL_DIR}', context.skillDir)
    .replaceAll('${KIMI_SESSION_ID}', context.sessionId ?? '');

  if (!hasArgumentPlaceholder && rawArgs.length > 0) {
    return `${content}\n\nARGUMENTS: ${escapeXmlTags(rawArgs)}`;
  }
  return content;
}

export function skillArgumentNames(metadata: SkillMetadata): readonly string[] {
  const value = metadata.arguments;