跨领域通用的技能规范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_forward1-type:commandname:start_servicecommands:-systemctl start openvpnserver-systemctl enable openvpnserver5. 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_service6. Validation Rules验证规则Skill 必须能自检否则无法复用。validation:-name:check_service_runningcommand:systemctl status openvpnserverexpect:active (running)-name:check_portcommand:ss-tulpn|grep 1194expect:openvpn-name:check_ip_forwardcommand:sysctl net.ipv4.ip_forwardexpect:17. Failure Patterns常见失败模式这是经验的精华团队最需要的部分。failures:-symptom:TLS Error: TLS handshake failedcause:客户端与服务端 cipher/auth 不一致fix:确保 server.conf 与 client.ovpn 参数一致-symptom:systemctl start openvpnserver 失败cause:证书路径错误或权限不足fix:检查 /etc/openvpn/server/ 下的 key/cert 权限-symptom:客户端无法访问互联网cause:UFW 未开启转发fix:ufw allow 1194/udp; 修改 /etc/ufw/before.rules8. 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