// 技能文件解析 private void parseSkillFile(Path path) { try { String content Files.readString(path); // 解析 Frontmatter (--- ... ---) Matcher matcher Pattern.compile(^---\\n(.*?)\\n---\\n(.*), Pattern.DOTALL).matcher(content); // 混合格式YAML元数据 Markdown内容 // 前元数据name, description, tags // 后内容具体的技能指导 Skill skill new Skill(); skill.path path; skill.name path.getParent().getFileName().toString(); // 默认名称 if (matcher.matches()) { String metaBlock matcher.group(1); skill.body matcher.group(2).trim(); // 元数据块解析 // 内容块技能的核心知识 for (String line : metaBlock.split(\\n)) { if (line.contains(:)) { String[] parts line.split(:, 2); String key parts[0].trim(); String val parts[1].trim(); if (name.equals(key)) skill.name val; if (description.equals(key)) skill.description val; if (tags.equals(key)) skill.tags val; } } } else { skill.body content.trim(); // 没有frontmatter则全是内容 skill.description No description; } skills.put(skill.name, skill); } catch (IOException e) { System.err.println(Failed to parse skill: path); } }元数据内容YAML Frontmatter Markdown内容的标准格式灵活兼容支持有/无元数据的文件格式默认命名用文件夹名作为默认技能名容错解析解析失败不影响整体运行双层级技能访问模式java// Layer 1: 获取简短描述列表 (用于 System Prompt) public String getDescriptions() { if (skills.isEmpty()) return (no skills available); return skills.values().stream() .map(s - String.format( - %s: %s [%s], s.name, s.description, s.tags ! null ? s.tags : )) .collect(Collectors.joining(\n)); // 简要列表名称 描述 标签 // 格式统一便于LLM理解和选择 } // Layer 2: 获取完整技能内容 (用于 Tool Result) public String getContent(String name) { Skill skill skills.get(name); if (skill null) { return Error: Unknown skill name . Available: String.join(, , skills.keySet()); } return String.format(skill name\%s\\n%s\n/skill, skill.name, skill.body); // 完整内容用XML标签包裹便于LLM识别 // 错误提示提供可用技能列表 }摘要模式先看目录再决定获取哪个详情渐进式披露避免一次性暴露所有信息污染上下文标签化用skill标签标注内容来源自描述错误未知技能时返回可用列表技能系统集成java// 系统提示词动态注入技能列表 private static final String SYSTEM_PROMPT String.format( You are a coding agent at %s.\n Use load_skill to access specialized knowledge.\n Skills available:\n%s, // 关键将技能列表注入系统提示 WORKDIR, SKILL_LOADER.getDescriptions() ); // 动态提示系统提示词包含当前可用的技能列表 // 主动引导明确告诉LLM使用load_skill工具获取知识 // load_skill工具定义 private static ListMapString, Object getToolSpecs() { // ... 添加基础工具 // 添加 load_skill 定义 MapString, Object skillTool new HashMap(); skillTool.put(name, load_skill); skillTool.put(description, Load specialized knowledge by name.); MapString, Object schema new HashMap(); schema.put(type, object); schema.put(properties, Map.of(name, Map.of(type, string, description, Skill name))); schema.put(required, Arrays.asList(name)); skillTool.put(input_schema, schema); tools.add(skillTool); // 专用工具为技能系统创建专门的工具 // 简单接口只需要技能名一个参数 }动态上下文系统提示词根据实际技能动态生成工具化访问将知识获取抽象为工具调用简单接口最小化的参数设计与基础工具并存技能工具和操作工具在同一系统中技能文件示例markdown--- name: java-refactoring description: Best practices for refactoring Java code tags: java, refactoring, clean-code --- # Java代码重构最佳实践 ## 1. 识别代码异味 - 过长的方法20行 - 过大的类500行 - 重复代码块 - 过深的嵌套3层 ## 2. 重构技术 - 提取方法将重复代码提取为私有方法 - 重命名使用清晰的变量名和方法名 - 移动方法将方法移到更合适的类中 - 引入参数对象减少方法参数数量 ## 3. 步骤指南 1. 先写测试确保现有功能正常 2. 小步快跑每次只做一个重构 3. 重构后立即运行测试 4. 提交到版本控制知识结构化专业经验被系统地组织可维护人类和AI都能理解和更新可复用多个Agent可以共享相同的技能库渐进式完善可以不断积累和优化技能架构演进与价值从 AgentWithSubAgents 到 AgentWithSkills 的升级
