前言¶

写技术文档、生成配置或混排 Markdown 时，模型常把中文弯引号塞进 Python 字符串、JSON 或 Typst 语法里。表面「排版更中文」，实际会导致解析失败、复制进项目就报错。手工改引号既慢又容易漏嵌套层级。

下面介绍 SkillHub 上的社区 Skill zh-quotes（坐标 @user_d1c8ae9c/zh-quotes）。它按 SKILL.md 约定，让 Agent 在输出前按当前语法上下文处理引号与符号，而不是一律套用中文排版习惯。

这是什么¶

zh-quotes 在包内 SKILL.md 中的定位是「Contextual Typography Skill」：在多语言、多语法混排场景下，正确解析标点、引号与符号用法。

• 维护方：社区发布者 user_d1c8ae9c（SkillHub 页面标注作者 amomorning）
• 版本：1.0.0
• 分类：content-creation
• 来源：community
• 元数据：requires_api_key=false，无需 API Key

它解决的不是「摘抄名言」，而是中文自然语言与编程语言、Typst、Markdown、LaTeX、JSON/YAML、Shell、Prompt、配置文件等并存时的引号与标点一致性。目标明确写在 SKILL.md：不是排版美化，而是语法正确、解析器兼容、语境一致、中文可读。

核心功能¶

以下能力均来自已安装的 SKILL.md v1.0.0。

自动触发条件¶

当输出中出现下列任一情况，Skill 要求 Agent 自动启用：

• 中文与代码混排
• Typst、Markdown 围栏代码块
• JSON / YAML / TOML
• 嵌套引号、代码生成、带引号示例的 Prompt
• 多语言文本、Shell、正则、HTML/XML、LaTeX/数学公式
• 含中文的字符串

尤其当输出同时包含中文字符与 ASCII 语法符号时，应优先启用。

核心原则与优先级¶

排版跟随当前语法上下文，而非单纯按「人类自然语言」习惯：

1. 编程语言语法
2. 标记语言语法
3. 数据序列化语法
4. 自然语言排版

代码合法性始终优先于中文排版惯例。

分场景规则（摘要）¶

禁止行为¶

Skill 明确禁止 Agent 自动：

• 在代码中将 ASCII 引号改为中文引号
• 美化语法字符、规范化本已合法的语法
• 替换解析器必需的符号

输出前校验¶

终稿前应：识别当前语法上下文 → 检查引号合法性 → 检查解析器兼容性 → 检查嵌套引号。高风险格式包括 Typst、JSON、YAML、Shell、正则、Prompt、LaTeX、Markdown 围栏代码块。

安装与启用¶

安装流程以 SkillHub 官方文档 skillhub.md 为准。Skill 页面给出的安装提示为：请根据该文档安装 @user_d1c8ae9c/zh-quotes。

1、安装 SkillHub CLI（若尚未安装）¶

command -v skillhub && skillhub --version

未安装时可执行完整安装（CLI + 默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅需 CLI 时：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2、安装 zh-quotes 到当前 Agent 的 skills 目录¶

安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录；默认装到 ./skills/ 可能不会被识别。

CLI 搜索结果显示的安装方式为：

skillhub install zh-quotes --namespace user_d1c8ae9c --dir <你的 skills 目录>

常用路径示例（摘自官方安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

在 Cursor 中可写成：

skillhub install zh-quotes --namespace user_d1c8ae9c --dir ~/.cursor/skills/

安装成功后，技能包会落在该目录下形如 @user_d1c8ae9c/zh-quotes/ 的路径中，内含 SKILL.md 供 Agent 读取。

3、让 Agent 加载¶

也可将 SkillHub 页面提示直接发给 AI：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_d1c8ae9c/zh-quotes`。

经上述步骤，Agent 在生成含中文与代码混排的内容时应遵循 SKILL.md 中的规则。

典型用法¶

Skill 未提供独立脚本命令，用法体现在生成与改写输出时的规则示例。下列对比来自官方 SKILL.md，可直接用于验收 Agent 是否按 Skill 工作。

纯中文（围栏外散文）：

“生成设计”是一种方法论。

Python 字符串（语法引号必须为 ASCII）：

text = "生成设计"

错误示范（中文弯引号会导致语法非法）：

text = “生成设计”

字符串内嵌中文引语：

text = "用户点击“生成”按钮"

println!("系统提示：“生成完成”");

Typst：

#text("这是正文")

#quote[
他说：“生成完成”
]

向 Agent 提出「写一段含中文按钮文案的 Python 示例」「生成 Typst 段落并带中文对白」等任务时，应自动套用上述分层规则。

适用场景与注意¶

适合谁

• 经常让 AI 写中英混排 README、教程、Prompt 模板、配置文件片段的开发者
• 使用 Typst、LaTeX、Markdown 技术写作且中文与代码嵌套较多的作者
• 希望减少「看起来对、粘贴进项目就报错」的引号问题的团队

限制与注意

• Skill 名称易被理解为「中文语录」；实际能力是语境化引号与标点，以 SKILL.md 为准。
• 社区来源（community），行为完全依赖 Agent 是否加载并遵守 SKILL.md，无独立运行时校验器。
• SkillHub 抓取资料显示评分 100000、下载约 780 次（统计随平台更新）；安装后若 Agent 未重启或未指向正确 --dir，可能表现为「装了但不生效」。
• 官方 API 地址 https://api.skillhub.cn/user_d1c8ae9c/zh-quotes 对浏览器 GET 可能返回 405；浏览与安装以 SkillHub 站点与 skillhub CLI 为准。

结尾¶

zh-quotes 把「中文引号该怎么用」从审美问题变成语法分层问题：代码里守 ASCII，散文里用中文引号，嵌套时逐层判断。对 content-creation 类工作流，它能降低混排文档进入仓库前的低级标点错误。

• SkillHub 页面：https://www.skillhub.cn/skills/user_d1c8ae9c/zh-quotes
• 坐标引用：@user_d1c8ae9c/zh-quotes
• 官方 API 条目：https://api.skillhub.cn/user_d1c8ae9c/zh-quotes