refactor(opencode-skill-loader): split loader and merger into focused modules

Extract skill loading pipeline into single-responsibility modules: - skill-discovery.ts, skill-directory-loader.ts, skill-deduplication.ts - loaded-skill-from-path.ts, loaded-skill-template-extractor.ts - skill-template-resolver.ts, skill-definition-record.ts - git-master-template-injection.ts, allowed-tools-parser.ts - skill-mcp-config.ts, skill-resolution-options.ts - merger/ directory for skill merging logic
2026-02-08 16:21:19 +09:00
parent 964c8f61fd
commit 2beb29f326
20 changed files with 769 additions and 674 deletions
@@ -0,0 +1,106 @@
+import { promises as fs } from "fs"
+import { join } from "path"
+import { resolveSymlinkAsync, isMarkdownFile } from "../../shared/file-utils"
+import type { LoadedSkill, SkillScope } from "./types"
+import { inferSkillNameFromFileName, loadSkillFromPath } from "./loaded-skill-from-path"
+
+export async function loadSkillsFromDir(options: {
+  skillsDir: string
+  scope: SkillScope
+  namePrefix?: string
+  depth?: number
+  maxDepth?: number
+}): Promise<LoadedSkill[]> {
+  const namePrefix = options.namePrefix ?? ""
+  const depth = options.depth ?? 0
+  const maxDepth = options.maxDepth ?? 2
+
+  const entries = await fs.readdir(options.skillsDir, { withFileTypes: true }).catch(() => [])
+  const skillMap = new Map<string, LoadedSkill>()
+
+  const directories = entries.filter(
+    (entry) => !entry.name.startsWith(".") && (entry.isDirectory() || entry.isSymbolicLink())
+  )
+  const files = entries.filter(
+    (entry) =>
+      !entry.name.startsWith(".") &&
+      !entry.isDirectory() &&
+      !entry.isSymbolicLink() &&
+      isMarkdownFile(entry)
+  )
+
+  for (const entry of directories) {
+    const entryPath = join(options.skillsDir, entry.name)
+    const resolvedPath = await resolveSymlinkAsync(entryPath)
+    const dirName = entry.name
+
+    const skillMdPath = join(resolvedPath, "SKILL.md")
+    try {
+      await fs.access(skillMdPath)
+      const skill = await loadSkillFromPath({
+        skillPath: skillMdPath,
+        resolvedPath,
+        defaultName: dirName,
+        scope: options.scope,
+        namePrefix,
+      })
+      if (skill && !skillMap.has(skill.name)) {
+        skillMap.set(skill.name, skill)
+      }
+      continue
+    } catch {
+      // no SKILL.md
+    }
+
+    const namedSkillMdPath = join(resolvedPath, `${dirName}.md`)
+    try {
+      await fs.access(namedSkillMdPath)
+      const skill = await loadSkillFromPath({
+        skillPath: namedSkillMdPath,
+        resolvedPath,
+        defaultName: dirName,
+        scope: options.scope,
+        namePrefix,
+      })
+      if (skill && !skillMap.has(skill.name)) {
+        skillMap.set(skill.name, skill)
+      }
+      continue
+    } catch {
+      // no named md
+    }
+
+    if (depth < maxDepth) {
+      const newPrefix = namePrefix ? `${namePrefix}/${dirName}` : dirName
+      const nestedSkills = await loadSkillsFromDir({
+        skillsDir: resolvedPath,
+        scope: options.scope,
+        namePrefix: newPrefix,
+        depth: depth + 1,
+        maxDepth,
+      })
+      for (const nestedSkill of nestedSkills) {
+        if (!skillMap.has(nestedSkill.name)) {
+          skillMap.set(nestedSkill.name, nestedSkill)
+        }
+      }
+    }
+  }
+
+  for (const entry of files) {
+    const entryPath = join(options.skillsDir, entry.name)
+    const baseName = inferSkillNameFromFileName(entryPath)
+    const skill = await loadSkillFromPath({
+      skillPath: entryPath,
+      resolvedPath: options.skillsDir,
+      defaultName: baseName,
+      scope: options.scope,
+      namePrefix,
+    })
+    if (skill && !skillMap.has(skill.name)) {
+      skillMap.set(skill.name, skill)
+    }
+  }
+
+  return Array.from(skillMap.values())
+}