code-change-verification

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Code Change Verification

代码变更验证

Overview

概述

Ensure work is only marked complete after formatting, linting, type checking, and tests pass. Use this skill when changes affect runtime code, tests, or build/test configuration. You can skip it for docs-only or repository metadata unless a user asks for the full stack.

只有在代码格式化、代码检查、类型检查和测试全部通过后，才能将工作标记为完成。当变更影响运行时代码、测试或构建/测试配置时，请使用本Skill。如果仅涉及文档或仓库元数据，除非用户要求执行完整验证流程，否则可跳过此步骤。

Quick start

快速开始

Keep this skill at
```
./.agents/skills/code-change-verification
```
so it loads automatically for the repository.

macOS/Linux:

bash .agents/skills/code-change-verification/scripts/run.sh

Windows:

powershell -ExecutionPolicy Bypass -File .agents/skills/code-change-verification/scripts/run.ps1

If any command fails, fix the issue, rerun the script, and report the failing output.
Confirm completion only when all commands succeed with no remaining issues.

将本Skill保存在
```
./.agents/skills/code-change-verification
```
路径下，以便仓库能自动加载它。

macOS/Linux系统：执行

bash .agents/skills/code-change-verification/scripts/run.sh

。

Windows系统：执行

powershell -ExecutionPolicy Bypass -File .agents/skills/code-change-verification/scripts/run.ps1

。

如果任何命令执行失败，请修复问题后重新运行脚本，并上报失败输出信息。
只有当所有命令都成功执行且无遗留问题时，才能确认验证完成。

Manual workflow

手动工作流

If dependencies are not installed or have changed, run
```
make sync
```
first to install dev requirements via
```
uv
```
.
Run from the repository root in this order:
```
make format
```
,
```
make lint
```
,
```
make mypy
```
,
```
make tests
```
.
Do not skip steps; stop and fix issues immediately when a command fails.
Re-run the full stack after applying fixes so the commands execute in the required order.

如果依赖未安装或已变更，请先执行
```
make sync
```
，通过
```
uv
```
安装开发环境依赖。
从仓库根目录按以下顺序执行命令：
```
make format
```
、
```
make lint
```
、
```
make mypy
```
、
```
make tests
```
。
请勿跳过任何步骤；当某一命令执行失败时，请立即停止并修复问题。
修复问题后，请重新运行完整的验证流程，确保命令按要求的顺序执行。

Resources

资源

scripts/run.sh

Executes the full verification sequence with fail-fast semantics from the repository root. Prefer this entry point to ensure the required commands run in the correct order.

从仓库根目录执行完整的验证序列，采用快速失败机制。优先使用此入口点，以确保所需命令按正确顺序执行。

scripts/run.ps1

Windows-friendly wrapper that runs the same verification sequence with fail-fast semantics. Use from PowerShell with execution policy bypass if required by your environment.

适用于Windows系统的包装脚本，执行相同的验证序列并采用快速失败机制。如果你的环境有要求，请在PowerShell中绕过执行策略后使用。