用途:将可重复的工作流整理为紧凑的专家技能包,或在保留已有领域知识的前提下改进现有包,目标是让真实请求得到正确行为,而非套用某一种 Markdown 模板。
主要能力:支持四种模式。创建——依据具体使用示例构建新包;改进——诊断并修订已有包,保留可用行为;合并——整合重叠包,协调触发条件与资源,定义迁移边界;验证——检查结构、资源路由、触发条件与行为,未被要求时不修改包。
使用方式:先阅读当前包、仓库约定、验证器和目录元数据,再只询问无法自行推断且会实质影响触发范围、副作用或输出的意图。收集代表性提示(应触发的直接请求、常见改写与不完整请求、属于其他技能的近似请求、多轮后相关请求、需分支的风险或不可用场景、成功输出与已知失败模式)。改进或合并时盘点 frontmatter 触发覆盖与冲突、输入与推断上下文、决策分支与缺失失败路径、领域规则与通用建议、输出与副作用契约、行为验证、全部引用/脚本/资源及其可达性与重复、运行时假设与可移植性约束。资源图中,选择逻辑、不变量、工作流、输出和验证留在 SKILL.md;条件性领域知识、变体、模式与扩展示例放 references/;重复确定性工作放 scripts/;模板、fixture、媒体等放 assets/。SKILL.md 需在需要处直接链接引用并说明何时读取,超 100 行的引用文件顶部加目录。
限制与要求:frontmatter 的 description 需同时写清能力与触发语境,把最独特能力前置,避免模糊措辞与无关运行时品牌。指令按任务可变性设定自由度,避免强制阶段编号、标题风格、清单语法或行数目标。需定义副作用与输出契约、构建行为评测(含 Prompt、预期触发决策、模式、问题、产物、验证与禁止行为),覆盖正例、负例、近似、不完整输入、多轮和失败恢复。验证时保持 SKILL.md 在包根且符合行数限制,目录名与 frontmatter name 一致,解析 frontmatter,解析所有相对链接,运行并测试变更的确定性脚本,用仓库验证器检查每个被触及的包,结构变化后重跑行为评测。关于具体行数上限、验证器命令、仓库名等细节,资料未提供。