⚠️ 环境适配:本技能原输出设计令牌驱动 HTML 排版,当前系统排版由
generate_word完成,正文中的字体/配色规范可作方法论参考。
📎 参考文件说明:正文中引用的 references/、rules/、workflows/ 等子文件未随技能导入(系统仅存单 SKILL.md),请直接依据本文方法论执行,不要尝试读取不存在的参考文件。
design-token Skill
1. 职责
根据文档类型(genre)选择合适的设计令牌主题和版式规则,输出标准化的 DesignTokenOutput,供 doc-typeset skill 消费。版式规则文件作为补充上下文,描述该 genre 对应的国标排版规范(如 GB/T 9704)。
2. 输入/输出
输入
输出
3. Genre → 主题映射
| genre | 说明 | theme_file | 预编译产物(直接查表) | rules_file |
|---|---|---|---|---|
government-doc | 党政机关公文 | tokens/themes/formal-government.json | tokens/compiled/government-doc.json | tokens/rules/gb-t-9704-government.md |
academic-paper | 学术论文 / 学位论文 | tokens/themes/academic-paper.json | tokens/compiled/academic-paper.json | tokens/rules/gb-t-7713-academic.md(含 7714 引用规则) |
business-report | 商务报告 / 分析报告 | tokens/themes/business-modern.json | tokens/compiled/business-report.json | — |
marketing-doc | 创意营销 / 活动方案 | tokens/themes/creative-marketing.json | tokens/compiled/marketing-doc.json | — |
general(默认) | 其他/未明确场景 | tokens/themes/modern-minimal.json | tokens/compiled/general.json | — |
当 genre 不在上表时,使用 general 兜底策略。
4. 执行方式(预编译查表,0 次 LLM 往返)
所有主题的 DesignTokenOutput(含 theme_name / tokens / css_variables / typography_rules)已由 scripts/build_tokens.py 预编译为静态产物,存放在 tokens/compiled/。运行时本 skill 只做静态查表:
- 按 genre 从
tokens/compiled/index.json定位对应产物文件(未命中 →general); - 直接读取该 compiled JSON 作为
DesignTokenOutput返回,无需任何转换或 LLM 推理。
主题 JSON 的字面值已内含精确规范(如 GB/T 9704 页边距、行距磅数),
typography_rules仅作可选溯源上下文,运行时无需读取。
CSS 变量命名 = token 路径扁平化(与 doc-typeset 模板的 token 注入层一致,语义变量 --fs-*/--ff-* 由模板通过 var(--typography-*, fallback) 消费):
维护:修改
tokens/themes/*.json后,须重跑python3 scripts/build_tokens.py重建tokens/compiled/。


