【AI】通用 Skill 模板-实时保存经验

跨领域通用的技能规范（Skill Spec），适用于：

• 工程
• 运维
• 产品
• 销售
• 项目管理
• 甚至软技能（谈判、复盘、沟通）

它的目标：
把某一次成功的对话 + 有效行动（Action）→ 自动沉淀成一个可复用 Skill。

🧩 通用 Skill 模板（Skill Specification v1.0）

你可以直接把这个模板放进你的 Agent 框架，作为“经验 → Skill”的标准格式。

1. Skill Metadata（技能元信息）

skill_name:setup_vpn_on_ubuntuversion:1.0.0created_at:2026-05-08created_by:hongtags:["vpn","ubuntu","network","automation"]description:>在 Ubuntu 系统上自动化搭建 VPN 的完整流程，包括依赖安装、 配置、验证步骤。可用于新环境快速复现。

2. Problem Definition（问题定义）

goal:>在一台全新的 Ubuntu 22.04 服务器上成功搭建 OpenVPN 服务端， 并验证客户端可正常连接。context:environment:os:Ubuntu 22.04network:public_ip_requiredpermissions:rootconstraints:-必须可重复执行-必须可在无 UI 的环境运行-必须可自动化

3. Key Insights（关键洞察）

从对话中抽取的“经验精华”，不是步骤，而是为什么这么做。

insights:-OpenVPN 需要 CA 目录结构，因此必须先初始化 easy-rsa。-server.conf 中的 cipher、auth 参数必须与客户端一致，否则握手失败。-UFW 默认阻断转发，需要手动开启 net.ipv4.ip_forward。-systemd 服务启动失败时，90% 是因为 key/cert 路径错误。

4. Action Summary（有效行动摘要）

从对话中提取“真正有效的动作”，过滤掉试错、废话、错误路径。

actions:-type:commandname:install_dependenciescommands:-apt update-apt install-y openvpn easy-rsa-type:commandname:init_cacommands:-make-cadir ~/openvpn-ca-cd ~/openvpn-ca-./build-ca-type:file_editname:configure_servertarget:/etc/openvpn/server.confdescription:修改端口、协议、加密方式等-type:commandname:enable_ip_forwardcommands:-sysctl-w net.ipv4.ip_forward=1-type:commandname:start_servicecommands:-systemctl start openvpn@server-systemctl enable openvpn@server

5. Step-by-Step Workflow（可执行流程）

这是 Skill 的核心：结构化、可执行、可复用。

workflow:-step:prepare_environmentdescription:安装依赖并准备 CA 目录run:install_dependencies-step:generate_keysdescription:初始化 CA 并生成密钥run:init_ca-step:configure_serverdescription:编辑 server.conf 并放置证书run:configure_server-step:enable_forwardingdescription:开启 IP 转发run:enable_ip_forward-step:start_servicedescription:启动并验证 OpenVPN 服务run:start_service

6. Validation Rules（验证规则）

Skill 必须能自检，否则无法复用。

validation:-name:check_service_runningcommand:systemctl status openvpn@serverexpect:"active (running)"-name:check_portcommand:ss-tulpn|grep 1194expect:"openvpn"-name:check_ip_forwardcommand:sysctl net.ipv4.ip_forwardexpect:"1"

7. Failure Patterns（常见失败模式）

这是经验的精华，团队最需要的部分。

failures:-symptom:"TLS Error: TLS handshake failed"cause:"客户端与服务端 cipher/auth 不一致"fix:"确保 server.conf 与 client.ovpn 参数一致"-symptom:"systemctl start openvpn@server 失败"cause:"证书路径错误或权限不足"fix:"检查 /etc/openvpn/server/ 下的 key/cert 权限"-symptom:"客户端无法访问互联网"cause:"UFW 未开启转发"fix:"ufw allow 1194/udp; 修改 /etc/ufw/before.rules"

8. Conversation Trace（关键对话）

只保留“有价值”的对话，不保存废话。

conversation:-user:"如何在 Ubuntu 上搭建 VPN？"-agent:"首先安装 openvpn 和 easy-rsa..."-user:"服务启动失败"-agent:"检查证书路径..."

9. Reuse Instructions（复用说明）

团队成员如何使用这个 Skill。

reuse:prerequisites:-Ubuntu 20.04/22.04-root 权限usage:-加载 skill-执行 workflow-根据 validation 结果调整

🧱 这个模板的特点

✔ 适用于任何领域

工程、销售、项目管理、运营、沟通技巧都能用。

✔ 可被 Agent 自动生成

你只需要让 Agent 在任务结束后执行：

/generate_skill <skill_name>

它就能自动填充这个模板。

✔ 可团队共享

Skill 是结构化的，不依赖模型，不依赖个人。

✔ 可自动执行

workflow + actions → 就是自动化脚本。

🧭 思考：

• 一个自动从对话中抽取 Skill 的算法（可直接用）
• 一个 Python Skill Builder 模块（可嵌入你的 Agent 框架）
• 一个 Skill Registry（团队共享 Skill 的仓库结构）
• 一个 Skill 执行器（自动执行 workflow）