Skip to content

Aham-AIAPP/aham-word

Repository files navigation

Aham Word — 供 AI 消费的 Word 规范

Release License: MIT Design Type 联系我

Aham Word — 写一次规范,AI 产出处处一致的 Word

为什么做

让 AI 写 Word,最大的麻烦不是「写不出来」,而是写出来的排版各自为政——这份标题宋体、那份雅黑,这份表格画满竖线、那份又一套;十份文档十种样式。更麻烦的是,你说不清「我要的样式到底是什么」,只能一份份手动调。

这个技能为此而做:把「Word 该长什么样」写成一份机器能读的规范,AI 据规范产出、处处一致;要改样式,改那一个文件就行,不碰代码。

定位

产出的不是「某一份排得还行的 Word」,而是一套可定义、可复用、可传承的文档规范

  • 一致 — 取值集中在单一事实源,AI 每次从同一处取值,输出不再漂移。
  • 可定义 — 样式是机读取值,可精确描述、可 diff、可版本管理,不再「差不多就行」。
  • 考虑全 — 影响 Word 排版的元素被系统列成清单(16 类),照着改就行,不会漏。
  • 克制一致 — 软黑的纸、钢蓝点缀、单一无衬线、横线表,继承 Aham 设计性格。

简言之:做的是「一套规范 + 据规范产出的引擎」,不是「一次性排版脚本」。

能做什么

技能的核心是「取值 / 规则 / 构件」三层,让样式可定义、产出可一致:

  • 单一事实源(取值) — 所有排版取值集中在 word-tokens.json:页面、颜色、字体、字号、段落、表格、页眉页脚、logo。改这里 = 改全局。
  • 完整规范(规则)references/word-spec.md 列全影响 Word 排版的 16 类元素 + 取值 + 禁止项,是「考虑全」的底稿,也是你做自己规范的对照表。
  • 参考引擎(构件)scripts/aham_word.py 读令牌出 .docx,把封面、自动目录、三级标题、横线表、页码域、页眉 logo 等封装成函数,AI 调函数即合规、不自由发挥。
  • 一键换品牌 — 改 word-tokens.json(色值/字体/字号/brand.logo)即换皮,不动代码。
  • 不编造 — 用户没给的事实留「待补录」(琥珀色标注),先问,绝不瞎填。

预览

示范文档就是把这份 README 用 Aham Word 自己排出来的 .docx——封面带 logo、自动目录、标题层级、横线表、页眉页脚,一份真实完整的文档:

Aham Word 示范 · 封面与正文

完整样张 + 可编辑版 → examples/aham-word-demo.docx · examples/aham-word-demo.pdf

统一风格一眼可辨:页眉右对齐「Aham」字标 · 软黑正文 · 标题下钢蓝招牌线 · 横线表(表头浅灰底、贴合页边距、数字右对齐等宽千分位、单元格垂直居中)· 引用块左钢蓝竖线 · 待补录琥珀标注 · 页码用域。

开始使用

最简单:把本仓库地址 https://github.com/Aham-AIAPP/aham-word 发给 Claude,让它把技能装好;或下载本仓库后,把技能文件上传给 Claude。

装好后对 Claude 说「帮我做个 Word / 把这份资料做成方案 Word」即可——技能会按规范产出封面、目录、标题层级、横线表、页码的合规 .docx;缺的事实会留「待补录」先问你,不编造。

想换成你自己的规范?复制 word-tokens.json,对照 references/word-spec.md 改色值/字体/字号/表格线/brand.logo;设环境变量 AHAM_WORD_TOKENS 指向你的文件,或放在引擎能找到的位置。不改一行代码,引擎按你的规范产出。


更新记录

Releases · CHANGELOG(Keep a Changelog · SemVer) · CONTRIBUTING · MIT

关于 Aham

把灵光一现,做成能用的 AI 工具。Aham 来自 aha moment,每个工具只把一件事做利落,共享同一套设计地基。

应用 一句话
Aham UI 供 AI 消费的设计系统——写一次规范,AI 产出处处一致
Aham Word(本仓库) 供 AI 消费的 Word 规范——AI 据规范产出处处一致的 .docx
Aham PPT 克制的 AI PPT 制作技能——把素材做成方案级 PPT
Aham Excel 供 AI 消费的 Excel 规范——开发中 🚧
Aham Voice 录音转写与会议纪要(macOS)——本地离线转写,纪要走你自己的模型
Aham Survey 现场调研工具(macOS)——本地优先,把现场对话做成结构化调研成果

来源与脱敏说明见 ORIGIN.md

关注 · 交流

公众号看更多 AI 工具实践与更新;也欢迎扫码加我,交流与反馈。

关注 Aham 公众号 / 加作者微信

About

供 AI 消费的 Word 规范——AI 据规范产出处处一致的 .docx

Topics

Resources

License

Contributing

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages