feat(doc): 新增 Markdown 排版 Skill

2026-08-25 11:02:09 +08:00
parent 0e7eb1eb93
commit f35b6a99d2
6 changed files with 53 additions and 11 deletions
@@ -1 +0,0 @@
-
@@ -0,0 +1,37 @@
+---
+name: format-md
+description: 整理 Markdown 文件或指定片段的排版与语法格式，同时保持原有事实、措辞和语义不变。适用于空行、标题、列表、代码块、表格及链接格式修正；内容改写、摘要或新增图示不应触发本 Skill。
+---
+
+# Markdown 排版
+
+在不改变内容含义的前提下修正 Markdown 排版。优先遵循当前项目已有的 Markdown 风格；没有明确约定时采用一致、易读的常见写法。
+
+## 工作范围
+
+- 修正标题层级、标题前后空行和正文分段。
+- 统一有序列表、无序列表及嵌套缩进。
+- 修正围栏代码块、语言标记和代码块周围空行。
+- 对齐已有表格的分隔行、列数和必要空格。
+- 修正明显损坏的 Markdown 链接、引用及强调语法。
+- 用户指定行号或章节时，只处理该范围，并保留范围外内容。
+
+## 内容边界
+
+- 不改写句子，不替换术语，不增删事实、结论、数字或要求。
+- 不因追求美观改变章节顺序、列表顺序或信息层级。
+- 不默认把段落转换成表格，也不新增流程图、状态图或时序图。
+- 不修复链接指向的外部内容；只能修正可确定的 Markdown 语法。
+- 发现语义矛盾、信息缺失或需要结构性重写时，保留原文并单独说明，不擅自处理。
+- 格式调整会影响渲染语义时，先向用户确认。
+
+## 执行方式
+
+1. 读取目标文件及项目内适用的协作约定。
+2. 确认处理范围；未指定时处理整个目标文件。
+3. 识别纯排版问题和可能改变语义的结构问题。
+4. 只修改能够确定不会改变内容含义的格式。
+5. 检查标题、列表、代码块、表格和链接结构是否完整。
+6. 报告处理范围、主要格式调整及保留未改的问题。
+
+若用户只要求查看或评估排版问题，保持只读并给出建议，不写回文件。
@@ -0,0 +1,4 @@
+interface:
+  display_name: "Format Markdown"
+  short_description: "整理 Markdown 排版并严格保持原文语义不变"
+  default_prompt: "使用 $format-md 整理这份 Markdown 文件的排版，不改写内容。"