用途:搭建一种 docs-only 的 context-mill 技能,由有序的参考文件链组成,智能体一次只读一个文件,读完当前文件才看到下一个,适合工作有先后依赖、每步职责单一、且不需要打包示例项目的场景。若技能只是可任意顺序阅读的参考资料集合,应改用扁平 docs-only 技能。
主要能力:每步上下文受限,token 占用小、注意力集中;每步有可验证的检查点,产出可观察、可暂停并从中断处继续;作用域受约束,智能体只处理已展示内容,不预加载后续步骤。
目录结构:context/skills/<group>/ 下放 config.yaml、description.md(SKILL.md 模板与入口)和 references/ 目录,参考文件命名为 1-<step-name>.md 到 N-<step-name>.md。config.yaml 中设 type: docs-only、template: description.md、references.preamble,以及 variants。构建会在每个带 next_step 的参考文件首个标题后注入 preamble,并在末尾追加继续阅读的链接;终止文件(next_step: null)不注入。
编写要点:每步一个目标、一个可验证产出;顶部用一段话写明目标和不做什么,并指明由后续哪一步负责;后续步骤需要的数据由前一步写入可读位置;不要可选支线;步骤保持简短。frontmatter 的 next_step 是相对 references/ 的文件名,必须显式声明。description.md 要说明用途、要求按精确路径从第一步开始、禁止 Glob/ls/find 该目录、禁止预加载后续步骤,并声明 [STATUS] 与 [ABORT] 约定,以 {commandments} 结尾。
验证:运行 npm run build,解压 dist/skills/<group>.zip 确认链完整;运行 npm test 应保持通过。
限制:不要用于单文件“多步”技能;不支持分支链(next_step 只能一个文件名);扁平(非链式)分组不要加 frontmatter。价格、平台等未在资料中提供。