Files
skillshare/internal/resource/kind.go
T
Willie 5160ed5ffe feat(resource): add ResourceKind interface, SkillKind/AgentKind implementations, and reserved name validation
Create internal/resource/ package with:
- kind.go: ResourceKind interface (Discover, ResolveName, FlatName,
  CreateLink, feature gates) + DiscoveredResource struct
- skill.go: SkillKind — directory-based discovery via SKILL.md,
  frontmatter name resolution, nested separator flatten (a/b → a__b)
- agent.go: AgentKind — single-file .md discovery with conventional
  excludes (README/LICENSE/CHANGELOG/SKILL.md), filename-based naming
  with frontmatter override, directory-strip flatten (dir/f.md → f.md)

Add "agents" to reservedSkillNames in validate.SkillName() to prevent
skill names conflicting with the agents source directory.

16 unit tests covering discovery, nested paths, name resolution,
flat name computation, feature gates, and edge cases.
2026-04-07 18:05:39 +08:00

60 lines
2.3 KiB
Go

package resource
// ResourceKind encapsulates per-kind behavior for skills and agents.
// Each kind defines how resources are discovered, named, linked, and validated.
type ResourceKind interface {
// Kind returns the resource kind identifier ("skill" or "agent").
Kind() string
// Discover scans sourceDir and returns all resources found.
Discover(sourceDir string) ([]DiscoveredResource, error)
// ResolveName extracts the canonical name from a resource at the given path.
// For skills: reads SKILL.md frontmatter name field.
// For agents: uses filename, with optional frontmatter name override.
ResolveName(path string) string
// FlatName computes the flattened name used in target directories.
// For skills: path/to/skill → path__to__skill (nested separator).
// For agents: dir/file.md → file.md (directory prefix stripped).
FlatName(relPath string) string
// CreateLink creates a symlink from dst pointing to src.
// For skills: directory symlink. For agents: file symlink.
// Both use os.Symlink; the distinction is semantic (unit shape).
CreateLink(src, dst string) error
// SupportsAudit reports whether this kind supports security audit scanning.
SupportsAudit() bool
// SupportsTrack reports whether this kind supports tracked repo updates.
SupportsTrack() bool
// SupportsCollect reports whether this kind supports collecting from targets.
SupportsCollect() bool
}
// DiscoveredResource represents a resource found during source directory scan.
// Used for both skills and agents.
type DiscoveredResource struct {
Name string // Canonical name (from frontmatter or filename)
Kind string // "skill" or "agent"
RelPath string // Relative path from source root
AbsPath string // Full absolute path
IsNested bool // Whether this resource is inside a subdirectory
FlatName string // Flattened name for target directories
IsInRepo bool // Whether this resource is inside a tracked repo
Disabled bool // Whether this resource is ignored by ignore file
SourcePath string // Full path preserving caller's logical path (may differ from AbsPath if symlinked)
}
// ConventionalExcludes are filenames excluded from agent discovery.
var ConventionalExcludes = map[string]bool{
"README.md": true,
"CHANGELOG.md": true,
"LICENSE.md": true,
"HISTORY.md": true,
"SECURITY.md": true,
"SKILL.md": true,
}