package instruction import ( "encoding/json" "fmt" "strings" runtimetooling "cs-agent/internal/ai/runtime/tooling" "cs-agent/internal/models" "cs-agent/internal/pkg/toolx" ) func BuildSelectedSkillActivationInstruction(skill *models.SkillDefinition) string { if skill == nil { return "" } lines := []string{ "当前命中的专项技能:", fmt.Sprintf("- code: %s", strings.TrimSpace(skill.Code)), fmt.Sprintf("- name: %s", strings.TrimSpace(skill.Name)), } if desc := strings.TrimSpace(skill.Description); desc != "" { lines = append(lines, fmt.Sprintf("- description: %s", desc)) } lines = append(lines, "", "执行要求:", "- 本轮优先处理该技能范围内的问题。", fmt.Sprintf("- 需要专项处理细节时,优先调用 %s 工具加载该技能说明后再继续。", toolx.BuiltinSkill.Name), "- 如果关键信息不足,先向用户追问。", "- 不得调用当前技能未授权的工具。") return strings.TrimSpace(strings.Join(lines, "\n")) } func BuildSelectedSkillDocument(skill *models.SkillDefinition, toolDefinitions []runtimetooling.MCPToolDefinition) string { return BuildSkillDocument(skill, toolDefinitions) } func BuildSkillDocument(skill *models.SkillDefinition, toolDefinitions []runtimetooling.MCPToolDefinition) string { if skill == nil { return "" } lines := []string{ "当前命中的专项技能:", fmt.Sprintf("- code: %s", strings.TrimSpace(skill.Code)), fmt.Sprintf("- name: %s", strings.TrimSpace(skill.Name)), } if desc := strings.TrimSpace(skill.Description); desc != "" { lines = append(lines, fmt.Sprintf("- description: %s", desc)) } if content := strings.TrimSpace(skill.Instruction); content != "" { lines = append(lines, "", "技能说明:", content) } if examples := parseJSONStringArray(skill.Examples); len(examples) > 0 { lines = append(lines, "", "典型示例问法:") for _, item := range examples { lines = append(lines, "- "+item) } } if len(toolDefinitions) > 0 { lines = append(lines, "", "当前技能允许使用的工具:") for _, item := range toolDefinitions { if strings.TrimSpace(item.ToolCode) == "" { continue } line := "- " + strings.TrimSpace(item.ToolCode) if title := strings.TrimSpace(item.Title); title != "" { line += " | " + title } lines = append(lines, line) } } lines = append(lines, "", "执行要求:", "- 优先遵循该技能说明完成任务。", "- 如果关键信息不足,先向用户追问。", "- 不得调用当前技能未授权的工具。") return strings.TrimSpace(strings.Join(lines, "\n")) } func parseJSONStringArray(raw string) []string { raw = strings.TrimSpace(raw) if raw == "" { return nil } var ret []string if err := json.Unmarshal([]byte(raw), &ret); err != nil { return nil } out := make([]string, 0, len(ret)) for _, item := range ret { item = strings.TrimSpace(item) if item == "" { continue } out = append(out, item) } return out }