Skip to content

SKILL.md 目录第 46 行锚点链接格式损坏,导致"核心理念"章节无法跳转 #1

@HIDUSB

Description

@HIDUSB

在审阅 SKILL.md 的目录(Table of Contents)区块时,我注意到第 46 行的 "二、核心理念 Core Philosophy" 条目在 Markdown 语法层面存在明显错误,会导致该章节的锚点跳转完全失效,同时让后续 Markdown 解析器的表现也变得不可预测。

Problem

文件 SKILL.md:46 当前内容如下:

- [二、核心理念 Core Philosophy](#三、模块选择器 Module Selector](#三模块选择器-module-selector)

问题非常清楚:

  1. 该条目出现了 两个 ]( ... ) 组合,方括号/圆括号嵌套不合法([...]( ... ](...))。
  2. 第一段 URL #三、模块选择器 Module Selector 里包含空格和中文全角逗号,按 CommonMark 规范会被直接忽略或截断。
  3. 即便解析器"侥幸"选择了外层链接,跳转目标也是 "三、模块选择器" 的锚点,而不是条目文字所声称的 "二、核心理念"。用户点击目录里的"核心理念"时,会被带到完全不同的章节。

对照第 45、47 行格式良好的条目:

- [一、三位一体架构 Trinity Architecture](#一三位一体架构-trinity-architecture)
- [四、角色设定 Character Profiles](#四角色设定-character-profiles)

可以推测第 46 行被编辑时误把 "三、模块选择器" 的锚点粘进了 "二、核心理念" 条目里。另外,"三、模块选择器 Module Selector" 本身也没有出现在目录中(实际章节在 SKILL.md:156),说明这次粘贴之后既破坏了 "二、" 的链接,又漏掉了 "三、" 的条目。

Evidence

  • SKILL.md:46 — 损坏的目录项
  • SKILL.md:125 — 实际的 "## 二、核心理念 Core Philosophy" 章节标题(锚点应为 #二核心理念-core-philosophy
  • SKILL.md:156 — "## 三、模块选择器 Module Selector" 章节标题(未在目录中出现)

Suggested Fix

- [二、核心理念 Core Philosophy](#二核心理念-core-philosophy)
- [三、模块选择器 Module Selector](#三模块选择器-module-selector)

建议顺便用目录生成脚本全量重生成 TOC,同时补上目前缺失的章节 二十六 – 三十二 的条目(详见另一 issue)。

严重程度: Medium — 不影响内容本身,但对通过目录导航长文档的读者(以及用大模型加载 SKILL 时按锚点切片的场景)直接产生错误跳转。

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions