feat(doc): 新增文档转换与规则化归档 Skill

2026-08-25 15:32:12 +08:00
parent dbc2f65154
commit d255bdd524
20 changed files with 735 additions and 20 deletions
@@ -0,0 +1,32 @@
+# 归档配置
+
+```json
+{
+  "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` 仅适合文本文件。