PrivateGPT Skills 入门指南用 SKILL.md 快速打造可版本管理的 AI 专属人设【免费下载链接】privateGPTComplete API layer for private AI applications on local models: RAG, skills, tools, MCP, text-to-sql, and more. Works with any OpenAI-compatible inference server.项目地址: https://gitcode.com/GitHub_Trending/pr/privateGPTPrivateGPT 是一个面向本地模型的完整 API 层支持 RAG、工具、MCP 与 text-to-sql 等能力。其中Skills技能功能让你用一个SKILL.md文件就能打包出可复用、可版本管理的 AI 专属人设——无需反复复制系统提示词改一次人设所有挂载它的对话同步生效。本文带你从零理解 Skills 机制到 5 分钟创建并升级你的第一个 AI 人设。什么是 Skills一句话讲透把 Skill 想象成一份岗位说明书你写好一份SKILL.md告诉 AI 它是谁、该怎么做事然后把它挂在任意一次模型请求上。它有三个核心特点可复用一份人设定义挂到无数个对话或集成中不用重复写系统提示词有版本Skill 创建后不可修改更新只能新增版本旧版本依然可用不会破坏已上线的集成有边界每个 Skill 属于一个collection团队/工作区标识天然做多租户隔离 适合场景法务审查员、销售运营助手、代码评审专家……任何需要固定人设 固定话术的 AI 助手。SKILL.md 长什么样3 分钟读懂标准格式一个 Skill 的核心就是一个 Markdown 文件由YAML 前置元数据frontmatter正文指令两部分组成--- name: legal-reviewer description: 用于法律文档审查总是标记缺失条款和模糊表述 allowed-tools: web_search file_read --- 你是法律文档审查员。请始终检查 1. 是否缺少关键条款 2. 是否存在模糊或歧义语言前置元数据中的关键字段字段说明name技能 slug 名只能用小写字母、数字和单个连字符description描述技能何时、如何使用最长 1024 字符allowed-tools可选限定该技能可用的工具列表license/compatibility/metadata可选的附加信息解析规则由 parser.py 严格校验frontmatter 缺失或 YAML 不合法会直接报错name含连续连字符也会被拒绝——格式规范保证了版本管理的可靠性。创建你的第一个 Skill一条 API 搞定启动 PrivateGPT 服务后默认端口 8080用一条curl就能创建curl -X POST http://localhost:8080/v1/skills \ -F display_titleLegal Reviewer \ -F collectionmy-org \ -F skill_md# Legal Reviewer\n\nYou are a legal document reviewer.四个关键字段值得记住display_title给人看的名字collection作用域通常是团队或工作区标识skill_md内联的SKILL.md内容loadinglazy默认或eager决定指令何时注入对话对应的 API 路由定义在 skill_router.py支持 multipart 表单上传也可以附带技能目录里的其他文件。版本管理更新人设不破坏集成这是 Skills 相比写死系统提示词最大的优势。Skill创建后不可变immutable——想改人设新增一个版本即可curl -X POST http://localhost:8080/v1/skills/skill_01abc.../versions \ -H Content-Type: application/json \ -d {skill_md: # Legal Reviewer v2\n\n更新后的指令...}固定引用旧版本的集成继续用旧版互不干扰引用最新版本的集成自动升级每个版本独立存储版本实体定义见 skill_entities.py天然可回溯 来源为anthropic或zylon的只读技能不可删除保护了官方预置人设的完整性。加载模式lazy 与 eager 怎么选Skill 挂载到对话时有两种加载策略lazy延迟加载默认指令按需注入省 token适合工具型、场景型技能eager即时加载对话一开始就注入完整人设适合整个会话都要保持人设的场景比如客服角色系统还支持maximum_loaded_skills参数限制单个对话同时加载的技能数量超出时自动淘汰最早加载的技能防止上下文被多个技能挤爆见 input_models.py。幕后机制技能如何安全进入模型环境你可能好奇模型是怎么看到技能文件的SkillLoader 会把每个技能以只读文件夹的形式挂载到沙箱路径/mnt/skills/{name}/内容从对象存储按需拉取一旦升级版本就是全新路径 全新内容旧版本物理隔离实现见 skill_loader.py。这保证了技能文件对模型只读防止人设自我修改多版本并存不互相污染本地存储可切换为 S3支持分布式部署常见问题 FAQQSkill 和工具Tools有什么区别Skill 是人设 工作流指令回答 AI你是谁、怎么做Tool 是 AI 可调用的能力函数。Skill 还可以用allowed-tools限定自己能用的工具。Q能挂多少个技能到一个对话没硬性上限但受上下文窗口和maximum_loaded_skills限制建议 1–3 个为宜。Q在哪里看完整 API 文档官方 Skills API 指南skills.mdxAPI 参考api-reference.mdx快速上手清单准备一份带 YAML frontmatter 的SKILL.mdname全小写POST /v1/skills创建技能指定collection在对话请求中挂载技能 ID人设不满意POST /v1/skills/{id}/versions新增版本永远别原地改从一份SKILL.md开始你就可以为本地私有 AI 打造专属、可控、可版本管理的 AI 人设了。更多 Skills 进阶用法可参考 技能服务实现 与 技能路由。【免费下载链接】privateGPTComplete API layer for private AI applications on local models: RAG, skills, tools, MCP, text-to-sql, and more. Works with any OpenAI-compatible inference server.项目地址: https://gitcode.com/GitHub_Trending/pr/privateGPT创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考