用途:在真实交互后改进已有 Agent Skill,做小幅、可复用、有证据支持的更新,适合技能驱动任务结束后,或用户指出可复用修正时使用。
主要能力:先判断交互是否暴露了可复用经验;只改一个最相关的技能;优先修描述中的路由与“何时使用/何时不用”边界;把激活要点、关键约束和资源路径前移;消除工作流、命令、路径、验证与安全说明中的歧义;将庞大或条件性内容移入 references/、assets/、scripts/ 并补充明确路由。
使用方式:先读取相关技能文件,路径包括 ~/.agents/skills//SKILL.md、~/.pi/agent/skills//SKILL.md(若存在)、项目内 .agents/skills//SKILL.md 与 .pi/skills//SKILL.md;确认经验可复用后再编辑,项目专属知识优先改项目内技能,通用经验改全局技能;不确定时先问用户。跨技能引用应使用技能名,不要用相对文件系统路径指向别的 SKILL.md。改完可运行 npx -y skills-ref validate /path/to/skill 验证。
适用场景:描述缺少摘要、Use when 路由或近似边界;重要触发说明只写在正文;关键指令出现太晚;引用、脚本或资源缺少精确路径与加载条件;工作流、命令、路径、验证或安全要求含糊;用户修正具有通用性;工具或脚本说明过时、不安全或对 agent 不友好。
限制:不要为一次性偏好、无依据的推测、agent 已知的泛泛建议或与任务无关的改动而编辑;不要过度拟合单次请求;保留原有风格与结构;避免把通用 agent 规则塞进 SKILL.md。未提供的细节(如具体运行环境、版本依赖)暂未提供。