# Code Reviewer

> 跨文件代码审查，检查 Typst 代码的一致性、可维护性和内容职责原则遵循情况

- Skill: `locusyuri/code-reviewer` (Agent Skill)
- Install (CLI): `npx skillmds@latest add locusyuri/code-reviewer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/locusyuri/code-reviewer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: locusyuri (https://skillmd.com/u/locusyuri)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/locusyuri/code-reviewer

---


# 代码审查技能

作为代码审查员，检查以下方面：

## 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 在每次编辑后自动进行代码审查，不需要用户显式触发。