skill

type AgentSkill struct {
	Def tool.ToolDefinition
}

type ExecutableSkill interface {
	Definition() tool.ToolDefinition
}

type Implementation string

type InputSpec struct {
	Type        string `yaml:"type"`
	Description string `yaml:"description,omitempty"`
	Required    bool   `yaml:"required,omitempty"`
}

type Loader struct {
	// Roots 是搜索 skill 的根目录列表，按优先级排列。
	// 典型值：{projectSkills, userSkills}。
	Roots []string
}

type Registry struct {
	// contains filtered or unexported fields
}

type Resolver struct {
	Tools ToolFactory
}

type SaveAsSkillTool struct {
	SkillDir string            // skills/ 的根目录
	OnSave   func(name string) // 可选：保存成功后的回调（比如重新注册到 registry）
}

type SkillSpec struct {
	Name           string         `yaml:"name"`
	Description    string         `yaml:"description"`
	Implementation Implementation `yaml:"implementation"`
	// 实现专项字段
	Tool     string `yaml:"tool,omitempty"`     // ImplTool
	Workflow string `yaml:"workflow,omitempty"` // ImplWorkflow: workflow.yaml 路径（相对 skill 目录）
	Goal     string `yaml:"goal,omitempty"`     // ImplAgent

	// Inputs 声明此 skill 的输入参数（JSON Schema properties）。
	// Planner 据此决定调该 skill 时该传什么——不再靠自然语言猜。
	Inputs map[string]InputSpec `yaml:"inputs,omitempty"`

	// Dir 是 SKILL.md 所在目录的绝对路径，由 Loader 填充。
	Dir string `yaml:"-"`

	// Body 是 frontmatter 后面的 Markdown 正文（Agent 阅读用）。
	Body string `yaml:"-"`
}

type ToolFactory func(toolName string) (tool.Tool, error)

type ToolSkill struct {
	SkillName string    // skill 名（来自 SKILL.md）
	Tool      tool.Tool // 底层工具
}

type WorkflowRunner func(ctx context.Context, spec *SkillSpec, input map[string]any) (*tool.Result, error)

type WorkflowSkill struct {
	Def         tool.ToolDefinition
	WorkflowRef string // 路径（相对 Dir）或 DB id 等引用——执行时再编译
	Dir         string // SKILL.md 所在目录（运行时拼接完整路径）
}