AI Skill 体系全解：企业级 AI 能力标准化可插拔可审计

一句话概括

系统性阐述如何将企业级 AI 能力抽象为标准化、可插拔、可审计的 Skill 单元，以实现 AI 能力的模块化管理与治理。

实践内容

Skill 标准结构（SKILL.md 格式）

---
name: dcf-valuation
description: 现金流折现估值，用于计算股票内在价值
version: 1.0.0
license: MIT
allowed-tools: calculateDcf
metadata:
  author: sk
  category: 投资分析
---
# DCF 估值技能
## 执行步骤
1. 向用户获取现金流、折现率、永续增长率、总股本。
2. 调用 calculateDcf 工具执行计算。
3. 输出每股价值、估值区间、风险提示。
4. 严格遵守金融合规，不提供投资建议。

目录结构

skill-name/
├── SKILL.md           # 必须：技能元数据+指令
├── scripts/           # 可选：Python计算脚本
├── references/        # 可选：参考文档、数据模板
└── assets/            # 可选：图标、配置文件

Skill 领域实体（Java）

@Data
@Builder
public class Skill {
    private String name;            // 技能唯一名称
    private String description;     // 技能描述
    private String instructions;    // 执行指令
    private String fullContent;     // 完整SKILL.md内容
}

Skill 解析器（SkillParser）

@Slf4j
public class SkillParser {
    private static final Pattern PATTERN = Pattern.compile(
        "^---\\s*[\\r\\n]+name:\\s*(.+?)\\s*[\\r\\n]+description:\\s*(.+?)\\s*[\\r\\n]+---\\s*[\\r\\n]+(.*)$",
        Pattern.DOTALL
    );
 
    public static Skill parse(String content) {
        if (content == null || content.isBlank()) return null;
        Matcher matcher = PATTERN.matcher(content);
        if (matcher.find()) {
            return Skill.builder()
                .name(matcher.group(1).trim())
                .description(matcher.group(2).trim())
                .instructions(matcher.group(3).trim())
                .fullContent(content)
                .build();
        }
        log.warn("Skill 解析失败：格式不正确");
        return null;
    }
}

双层存储架构

• 内置 Skill（classpath:skills）：只读、系统默认、合规底线、不可篡改
• 外部 Skill（data/skills）：可写、可覆盖、可热更新、业务定制

三阶段延迟加载机制

阶段	时机	内容	Token 消耗
发现 Discovery	项目启动	仅加载 name+description	~100/技能
激活 Activation	用户请求匹配技能	加载完整 SKILL.md	~5000/技能
执行 Execution	真正调用工具/脚本	加载 scripts、references	按需

热更新接口

@PostMapping("/api/skill/update")
public ResponseEntity<?> updateSkill(
        @RequestParam String name,
        @RequestBody String content) {
    skillRepository.update(name, content);
    return ResponseEntity.ok(Map.of("success", true));
}

外部 Skill 与内置 Skill 同名时，外部覆盖内置，更新后立即生效无需重启。

摘录

在我们这套企业级架构里：Skill = 标准化、可执行、可复用、可审计、可插拔的领域能力单元。它不是一段简单的 Prompt，它包含：业务知识、执行流程、工具调用规则、异常处理、输出格式、合规约束、评估标准。

一句话：LLM 负责想，Skill 负责专业，Tool 负责干，Agent 负责管。

Skill 体系是企业级 AI 智能体的核心竞争力。它把模糊、不可控的 Prompt，升级为标准化、可插拔、可复用、可审计、可热更的专业能力。

绝大多数公司接入大模型后，都会遇到这 4 个致命问题：回答不可控（同样问题每次回答不一样）、专业度不够（没有行业知识，不懂业务规则）、无法沉淀（Prompt 散落在代码里，无法管理、无法版本、无法共享）、不合规（没有审批、没有审计、没有权限、没有安全边界）。

涉及实体

• LLM 大模型
• AI Agent
• Skill 体系
• Tool 层
• SKILL.md 标准
• SkillParser
• 双层存储架构
• 三阶段延迟加载
• 审计日志
• AI 质检

涉及主题

• AI Skill 体系
• 企业级 AI 工程
• AI 能力标准化
• 可插拔架构
• AI 审计与治理