Skill¶

本页最后更新于，内容可能过时

本仓库的 skill 放在 .claude/skills/ 下
新增 skill 时, frontmatter 默认写 user-invocable: false

文风¶

用词¶

适用于写入本仓库的文件, 也适用于对话回复
- 用平实的说明文, 接近产品说明书的写法
- 陈述事实与操作, 以可读性和准确性为准
- 不用夸张、煽动、摆谱的措辞
- 不用口语化说法
- 不拟人, 不调侃, 不评价读者, 不表演共情
- 补充解释之前不写俏皮话
- 动词选最普通的: 由...组成, 演示, 决定, 换成, 生成

标点与断句¶

只适用于写入本仓库的文件, 对话回复不受此约束
- 不用全角标点: 。 ， 、 ： ； （） 「」
- 不用 ①②③, ⑴⑵⑶, ⒈⒉⒊, ㈠㈡㈢这类带圈或带括号的序号字符, 序号一律写成 (1) (2) 或者 1. 2.
- 逗号写成半角 ,, 后面跟一个空格
- 冒号与括号用半角 : ( )
- 句末不加终止符, 靠换行断开
- 一行一个短句
- 并列项, 条件, 结论各自成行
- 该停顿的地方换行, 不堆长句
- 一行尽量不超过 60 个字符, 中文与 LaTeX 都按 1 个字符计
- 长句在逗号, 以及 且 或 则 即 所以 于是 由 等处断开, 拆成多行
- 一条公式单独占一行, 不与说明文字混排
- 推导链一行一步, 写成 $...$ 顺次排下来
- 断不开的长公式(\begin{cases}, 长不等式链)保留整行, 不硬拆
- 全篇非空行的长度中位数不超过 45, 超过 100 字符的行占非空行不到 5%

结构¶

文档开头空三行
全篇用 ## 作节标题, 不用 # 与 ###
二级标题前空两行, 渲染后自带分割线, 标题前不写 ------
二级标题后空一行, 不与正文紧贴
块组之间用 ------ 分隔, 分割线前后各留一个空行
块组是一个完整的知识单元, 指一个定义簇, 一个定理连同它的证明, 或一串例题
块组内部按阶段用空行分段, 不插 ------
定理的陈述与它的证明之间空一行
证明内部每 2 到 6 行一段, 分段点取在引入新的量(取, 令, 设), 换到另一个对象, 得出阶段性结论, 以及最后收束处
定义簇里并列的多个定义之间空一行
一串例题之间空一行
术语写成 术语: 解释
例题与推导写成 > 例1-1: ... 引用块
附注, 特例用 [方括号] 标出
[用到三级标题时, 它不带分割线, 标题前照常写 ------]
排版范例见 Coursera/[1]数学/(3)抽象代数 与 Coursera/[1]数学/(5)数学分析 下的笔记

公式渲染¶

只适用于写入本仓库的文件
如果用户觉得行内公式含分数 \frac{}{} 的渲染样式偏小
可以用 $\begin{aligned}...\end{aligned}$ 包住可以放大渲染样式

公式由 MPE 预览渲染
数学模式内可以放中文, 不需要为此改写公式
不要为了验证渲染去装 KaTeX 等命令行工具, 命令行版与预览内嵌的解析器不是同一套
子 agent 看不到预览, 遇到不确定的写法照原样写, 并在报告里列出待确认项

示例¶

改前: 该系统由三部分组成，分别是 A、B 和 C。
改后: 该系统由三部分组成
1. A
2. B
3. C

校验¶

写完尽量自己 Read 通读一遍验收, 不要写一堆 Python 校验脚本
脚本尽量只用在真正机械的操作上, 例如批量插入空行

系统编码¶

本机代码页为 936 (GBK), Python 的 stdout 默认编码是 gbk, 命令行输出中文会乱码
改为 UTF-8 需写以下三个注册表值

[需要管理员权限, 且必须重启后生效]

Set-ItemProperty 'HKLM:\SYSTEM\CurrentControlSet\Control\Nls\CodePage' -Name ACP   -Value 65001
Set-ItemProperty 'HKLM:\SYSTEM\CurrentControlSet\Control\Nls\CodePage' -Name OEMCP -Value 65001
Set-ItemProperty 'HKLM:\SYSTEM\CurrentControlSet\Control\Nls\CodePage' -Name MACCP -Value 65001

重启后用 python -I -c "import sys; print(sys.stdout.encoding)" 验证, 输出 utf-8 即生效