Function parseParam

src/pkg/utils/skill_script.ts:62–94

(raw: string)

// 解析 @param 行: name type [required] description
// type 支持 string|number|boolean，支持 enum [val1,val2]
function parseParam(raw: string): SkillScriptParam | null {
  // 匹配: paramName type [required] description
  // 或: paramName type[val1,val2] [required] description
  const match = raw.match(/^(\w+)\s+(string|number|boolean)(\[[^\]]*\])?\s*(.*)/);
  if (!match) return null;

  const [, name, type, enumPart, rest] = match;

  let enumValues: string[] | undefined;
  if (enumPart) {
    // 解析 [val1,val2]
    const inner = enumPart.slice(1, -1).trim();
    if (inner) {
      enumValues = inner.split(",").map((v) => v.trim());
    }
  }

  // rest 可能以 [required] 开头
  let required = false;
  let description = rest.trim();
  if (description.startsWith("[required]")) {
    required = true;
    description = description.slice("[required]".length).trim();
  }

  return {
    name,
    type: type as SkillScriptParam["type"],
    required,
    description,
    ...(enumValues ? { enum: enumValues } : {}),
  };
}

// 获取 Skill Script 脚本体（去掉元数据头）
export function getSkillScriptBody(code: string): string {