skill-name（短横线命名）├── SKILL.md           必须：技能描述 + 指令 + 约束├── scripts/           可选：Python 计算脚本├── references/        可选：参考文档、数据模板└── assets/            可选：图标、配置、资源

---name: 技能唯一标识description: 功能描述 + 触发意图version: 1.0.0license: MITallowed-tools: 工具白名单metadata:  author: 作者  category: 分类---# 技能标题## Instructions执行步骤输入要求输出格式约束条件风险提示## Example输入示例输出示例

description: 现金流折现估值，用于股票内在价值计算，用户问估值、价值、合理价格时触发

allowed-tools: calculateDcf,calculateTechnicalIndicators

metadata:  author: sk-tech  category: 投资分析  level: 专业  scope: 股票

## Instructions1. 检查用户输入是否包含现金流、折现率、永续增长率、总股本2. 缺失参数则反问用户补充3. 调用 calculateDcf 工具执行计算4. 按固定格式输出结果5. 必须附带风险提示

## InputcashFlows：数组，未来 5 年现金流discountRate：小数，如 0.1 代表 10%terminalGrowth：小数，如 0.03 代表 3%sharesOutstanding：亿股

## Output- 股票内在价值：xx 元- 估值结论：xxx- 风险提示：市场有风险，估值仅供参考，不构成投资建议

## 合规约束1. 不承诺收益2. 不提供具体买卖建议3. 必须输出风险提示4. 无法回答则转人工

---name: dcf-valuationdescription: 现金流折现估值，用于股票内在价值计算，用户问估值、价值、合理价格时触发version: 1.0.0license: MITallowed-tools: calculateDcfmetadata:  author: sk-finance  category: 投资分析---# DCF 估值技能## Instructions1. 首先检查用户输入是否包含：现金流、折现率、永续增长率、总股本。2. 缺少任何参数，反问用户补充。3. 调用 calculateDcf 工具进行精确计算。4. 输出必须包含：内在价值、估值结论、风险提示。5. 不提供投资建议，不预测涨跌。## 输入参数cashFlows：未来现金流数组discountRate：折现率terminalGrowth：永续增长率sharesOutstanding：总股本（亿股）## 输出格式- 内在价值：XX 元/股- 结论：XXX- 风险提示：市场有风险，估值基于假设，仅供参考## 异常处理参数不足 → 引导补充计算异常 → 告知无法计算并建议检查数据

private static final Pattern SKILL_PATTERN = Pattern.compile(    "^---\\s*[\\r\\n]+name:\\s*(.+?)\\s*[\\r\\n]+description:\\s*(.+?)\\s*[\\r\\n]+---\\s*[\\r\\n]+(.*)$",    Pattern.DOTALL);

@Slf4jpublic class SkillParser {    private static final Pattern SKILL_PATTERN = Pattern.compile(        "^---\\s*[\\r\\n]+name:\\s*(.+?)\\s*[\\r\\n]+description:\\s*(.+?)\\s*[\\r\\n]+---\\s*[\\r\\n]+(.*)$",        Pattern.DOTALL    );    /**     * 解析 SKILL.md 内容为 Skill 对象     */    public static Skill parse(String content) {        if (content == null || content.isBlank()) {            log.warn("技能内容为空");            return null;        }        Matcher matcher = SKILL_PATTERN.matcher(content);        if (matcher.find()) {            String name = matcher.group(1).trim();            String description = matcher.group(2).trim();            String instructions = matcher.group(3).trim();            return Skill.builder()                .name(name)                .description(description)                .instructions(instructions)                .fullContent(content)                .build();        }        log.warn("SKILL.md 格式不匹配，解析失败");        return null;    }}

@Data@Builderpublic class Skill {    private String name;    private String description;    private String instructions;    private String fullContent;}

public int loadFromPath(String pathPattern) {    try {        Resource[] resources = resolver.getResources(pathPattern);        List<Skill> skills = Arrays.stream(resources)            .parallel()            .map(resource -> {                try {                    String content = StreamUtils.copyToString(                        resource.getInputStream(),                        StandardCharsets.UTF_8                    );                    return SkillParser.parse(content);                } catch (Exception e) {                    log.warn("解析失败：{}", resource.getFilename());                    return null;                }            })            .filter(Objects::nonNull)            .collect(Collectors.toList());        skills.forEach(skillRepository::save);        return skills.size();    } catch (Exception e) {        log.error("加载技能失败", e);        return 0;    }}

@Service@RequiredArgsConstructorpublic class SkillLoaderService {    private final FileSystemSkillRepository repository;    private static final String CLASSPATH_SKILLS = "classpath:skills/**/SKILL.md";    private static final String FILE_SKILLS = "file:data/skills/**/SKILL.md";    @PostConstruct    public void loadAllSkills() {        // 加载内置技能        int innerCount = repository.loadFromPath(CLASSPATH_SKILLS);        // 加载外部覆盖技能        int outerCount = 0;        File dir = new File("data/skills");        if (dir.exists()) {            outerCount = repository.loadFromPath(FILE_SKILLS);        }        log.info("技能加载完成：内置{}个，外部{}个", innerCount, outerCount);    }}

@Overridepublic synchronized void update(String name, String newContent) {    Skill skill = SkillParser.parse(newContent);    if (skill == null) {        throw new RuntimeException("技能格式错误，更新失败");    }    // 更新缓存    skillCache.put(name, skill);    // 持久化到外部目录    try {        Path path = Paths.get(DYNAMIC_SKILLS_PATH, name, "SKILL.md");        Files.createDirectories(path.getParent());        Files.writeString(path, newContent, StandardCharsets.UTF_8);        log.info("技能热更新成功：{}", name);    } catch (IOException e) {        log.error("技能持久化失败", e);    }}