CraftKit/plugins/doc/skills/archive/references/config.md

归档配置

{
  "version": 1,
  "archiveRoot": "docs/archive",
  "defaults": { "onConflict": "skip" },
  "rules": [
    {
      "match": "design/**/*.md",
      "target": "design/{relative}",
      "stripFrontmatter": true,
      "requiredText": ["#"]
    },
    {
      "match": "specs/*.md",
      "target": "reference/{stem}-api.md",
      "section": "API"
    }
  ]
}

• archiveRoot：相对项目根的归档目录。
• match：相对项目根的 glob，只处理普通文件。
• target：可用 {name}、{stem}、{suffix}、{relative}、{parent}。
• section：可选 Markdown 标题文本，输出该标题及下属内容。
• stripFrontmatter：仅移除开头完整闭合的 Frontmatter。
• requiredText：归档前必须出现的文字，用于替代隐式外部校验。
• onConflict：skip、overwrite 或 append。

目标不得是绝对路径或逃逸归档根。append 仅适合文本文件。