Function parseSkillMd

src/pkg/utils/skill.ts:20–79

(content: string)

// 解析 SKILL.cat.md 内容：YAML frontmatter + markdown body
export function parseSkillMd(content: string): { metadata: SkillMetadata; prompt: string } | null {
  const match = content.match(/^---\s*\n([\s\S]*?)\n---\s*\n?([\s\S]*)$/);
  if (!match) return null;

  const [, frontmatter, body] = match;

  let parsed: Record<string, unknown>;
  try {
    parsed = parseYaml(frontmatter);
  } catch {
    return null;
  }

  if (!parsed || typeof parsed !== "object") return null;

  const name = typeof parsed.name === "string" ? parsed.name : "";
  if (!name) return null;

  const description = typeof parsed.description === "string" ? parsed.description : "";
  const version = typeof parsed.version === "string" ? parsed.version : undefined;

  // 解析 scripts 文件名列表（URL 安装时使用）
  const scripts = Array.isArray(parsed.scripts)
    ? parsed.scripts.filter((s): s is string => typeof s === "string")
    : undefined;

  // 解析 references 文件名列表（URL 安装时使用）
  const references = Array.isArray(parsed.references)
    ? parsed.references.filter((r): r is string => typeof r === "string")
    : undefined;

  // 解析 config 块
  let config: Record<string, SkillConfigField> | undefined;
  if (parsed.config && typeof parsed.config === "object" && !Array.isArray(parsed.config)) {
    const rawConfig = parsed.config as Record<string, unknown>;
    const entries = Object.entries(rawConfig);
    if (entries.length > 0) {
      config = {};
      for (const [key, value] of entries) {
        if (value && typeof value === "object" && !Array.isArray(value)) {
          config[key] = normalizeConfigField(value as Record<string, unknown>);
        }
      }
      // 如果解析后没有有效字段，置为 undefined
      if (Object.keys(config).length === 0) config = undefined;
    }
  }

  return {
    metadata: {
      name,
      description,
      ...(version ? { version } : {}),
      ...(scripts?.length ? { scripts } : {}),
      ...(references?.length ? { references } : {}),
      ...(config ? { config } : {}),
    },
    prompt: body.trim(),