| name | code-reviewer |
| description | 跨文件代码审查,检查 Typst 代码的一致性、可维护性和内容职责原则遵循情况 |
| user_invocable | false |
代码审查技能
作为代码审查员,检查以下方面:
1. 内容完整性
- 标题层级:检查
initial.typ 中的 = 章节标题层级是否正确(=一级,==二级,===三级)
- 标签命名:检查标签
@<label> 是否遵循项目约定(章节缩写 + 序号)
- 标签冲突:扫描所有
.typ 文件,检查是否存在重复标签定义
- 引用匹配:检查所有
@ref(...) 或 @<label> 引用是否都能找到对应的标签定义
2. 内容职责原则 (SRP)
- 定义放置:基本定义是否放在本笔记中,而非假定"读者应该知道"
- 避免重复:已有其他笔记的定义是否被重复且不一致地定义
- 前置依赖:当前笔记是否注明了前置知识依赖(如"见实分析第X章")
3. 模板合规性
- 文档元数据:是否包含正确的
#show: ...(title:)、date 等元信息
- 包装器使用:定理、证明、引理等是否使用了
typst-template 提供的包装器函数
- 字体/颜色覆盖:是否覆盖了模板默认样式,如是,是否有合理理由
4. 文件组织
- 单文件原则:所有内容写在
initial.typ 中,不再使用 chapters/ 分文件模式
- 目录结构:是否遵循
img/、references.bib 的目录约定
调用方式
本 skill 由 AtomCode 在每次编辑后自动进行代码审查,不需要用户显式触发。