用途:教智能体正确使用 PostHog 的 skill-* MCP 工具管理技能,做到最小上下文、最少往返、最少错误。若尚不熟悉工具面,应先读 skills-store 技能了解目录。
主要能力与原则:渐进式披露不可妥协——list 只返回描述,get 返回正文与清单,file-get 返回单个文件,绝不预加载捆绑文件。写入时选最小原语:定向 edits 或 file_edits 比整体替换更省、更安全、版本历史更清晰。读取便宜,并发覆盖不便宜:写入前须持有 skill-get 的最新版本并作为 base_version 传入。创作遵循 Agent Skills 规范:name 用 kebab-case,description 触发词丰富,正文简短,大块材料放捆绑文件。
工具选择:skill-list 查可用(仅名称与描述);skill-get 取正文与文件清单(不含文件内容);skill-file-get 按需取单文件;skill-create 一次创建新技能(正文加初始文件);skill-update 改正文(整体 body 或 edits)或改文件内容(file_edits);skill-file-create/delete/rename 增删改文件;skill-rename 重命名技能;skill-duplicate 复制;skill-archive 归档(隐藏全部版本且不可撤销)。update(files=[...]) 会替换整个捆绑包,仅在有意清空重建时使用。
用法要点:先发现再获取,skill-get 每任务每技能只调一次并缓存正文。大技能按正文指引只取当前任务相关文件。创建用单次 skill-create 落地为完整 version 1。更新前先读并记录版本,写入传 base_version;成功后响应含新版本,可链式继续写。edits[].old 须在正文中精确匹配一次,body 与 edits 互斥。file_edits 只能修补已有文件,不能增删改名。路径参数命名:URL 场景用 file_path,body 字段用 path,重命名用 old_path/new_path。
适用场景:共享版本化记忆,如项目中枢、PostHog 对象目录、随调查增长的运行手册、每日待办队列、交接文档。references/skill-patterns.md 提供这些形态的示例。
限制:一次性任务指令、个人草稿、服务运行的代码不适合放入技能库。归档不可撤销。未提供具体收费、价格与平台信息。