用途:面向维护技能库的智能体,覆盖技能全生命周期——编写、策展、跟踪、同步、发布,并采用与平台无关的模式(清单跟踪、分层同步、并行差异分发、定时漂移检测)。
适用场景:从零创建技能;从外部仓库导入或改编技能;检查本地技能是否与上游脱节;扫描未跟踪的外部工具依赖;把本地技能发布到共享仓库;配置每月自动同步检查;精简已积累的技能库。若只是一次性创建技能且无上游跟踪需求,直接使用平台的技能编写工具即可。
核心概念:三层同步——外部→本地(上游新版本)、本地→已发布仓库(本地更新后仓库副本过时)、本地→独立代码仓库(技能描述的工作流或CLI已演进)。在技能根目录维护单个UPSTREAM_MANIFEST.md,每个有外部来源的技能一行;每月运行的脚本scripts/upstream_check.py获取上游版本并报告漂移。
主要流程:编写时先检查重叠,再调研同类技能,写好frontmatter(name、description、license、metadata)与标准章节结构,控制体积;策展时对候选分类(保留、改编、合并、跳过),完整改写而非复制,保留精确的领域细节(色值、像素、字体、时序、禁止模式);同步审计时读取清单,逐层比对,按上游类型选择覆盖、合并或仅更新URL策略,并扫描引擎依赖;发布时去除品牌信息、通用化平台特有表述、保持技能自包含。
必要用法示例:复制模板cp templates/upstream-manifest.md /path/to/your/skills/UPSTREAM_MANIFEST.md;复制脚本cp scripts/upstream_check.py /path/to/your/scripts/;定时任务示例0 9 1 * * /path/to/python3 /path/to/scripts/upstream_check.py。引擎依赖在脚本内以列表形式配置,命令以列表传入(不使用shell=True)以防注入。脚本退出码0表示全部同步、1表示检测到漂移,非空stdout作为消息投递。
限制:资料未提供该技能的具体平台适配清单、安装方式、收费信息与实测效果;清单驱动的检查依赖markdown格式与可选Upstream path列,路径不符会持续报警;上游无版本号时只能报告最近提交日期。多处模板与代码引用在给定资料中被截断,缺失部分暂未提供。