Codex Mpx 文档锚点|为中文标题生成英文链接
EnglishCodex 安装步骤
- 打开 GitHub 固定提交的 `.agents/skills/doc-add-simple-hash/SKILL.md`,核对内容与使用条件。
- 在自己的项目中创建 `.agents/skills/doc-add-simple-hash/`,把核对后的文件保存为 `.agents/skills/doc-add-simple-hash/SKILL.md`。
- 在该项目根目录启动 Codex,输入 `$doc-add-simple-hash` 并选择同名技能。
中文摘要
为 Mpx Markdown 中的中文标题写简短英文锚点,先按标题语义命名,再检查格式和文档内重复。
SKILL.md 中文导读
可复现示例
给含义为「表单校验规则」的新标题分配英文锚点,保留已有链接。
{"headingType":"Chinese","existingAnchor":"form-validation","suggestedMeaning":"form validation rules"}工作步骤
- 扫描中文标题,按语义选英文短词。
- 用文档的锚点标记写入,并检查小写字母、数字和短横线。
- 与同页已有锚点比对,处理重复后再确认。
验收方法
将新标题写为 `## 表单校验规则 {#form-validation-rules}`,保留现有 `form-validation`。
GitHub 原文 · 更新日期
适用环境
用 Codex 打开采用 Mpx 锚点标记的 Markdown 文档。需要看到目标标题和该页已有锚点。
常见问题
一个文档里能重复使用同一个锚点吗?
每个锚点应在同页唯一。已有锚点保留,新锚点从标题语义中另选短词。