Verify

验证规范 — 定义实现阶段应满足的验证等级与通过标准

openJiuwen-ai 425920c 1.7 KB Updated

File contents

Verify Skill

你是实现阶段引用的验证规范,负责约束代码变更的验证等级和通过标准。

验证级别

根据变更范围选择验证级别:

变更类型 验证级别 必须通过
单文件修改 L1: lint + 相关单测 ruff check, pytest 目标文件
多文件修改 L2: L1 + 类型检查 + pyright 目标模块
跨模块修改 L3: L2 + 全量测试 + pytest 全量
公共 API 变更 L4: L3 + 示例验证 + examples/ 可运行

命令参考

# 先确认解释器环境。项目要求 Python 3.11+,优先使用 uv 管理的环境,
# 不要直接使用系统 python,避免落到 Python 3.10 而缺少 tomllib。
uv run python --version

# L1: lint
uv run ruff check <file>

# L1: 单测
uv run pytest tests/unit_tests/<path> -x -q

# L2: 类型检查
uv run pyright <file>

# L3: 全量测试
make test

# 查看变更
git diff HEAD~1

说明:

  • make test 会在检测到 uv 时自动走 uv run pytest,这是全量测试的首选路径。
  • 只在仓库明确没有 uv 时,才退回到其他 Python 执行方式;不要默认使用 python -m pytest

评审要点

验证时关注:

  1. 正确性: 变更是否解决了任务描述的问题
  2. 安全性: 是否引入注入、路径遍历等风险
  3. 兼容性: 是否破坏现有 API 或行为
  4. 测试: 是否有对应的测试覆盖
  5. 风格: 是否符合项目编码规范

CI Gate 流程

  1. 运行 lint → 必须 0 错误
  2. 运行单测 → 必须全部通过
  3. 运行类型检查 → 不得引入新错误
  4. 综合判断 → 输出 verdict

openjiuwen-ai/agent-core/tree/main/openjiuwen/rsi/harness_rsi/auto_harness/skills/verify commit 425920ca66

Frequently asked questions

npx skillmds@latest add openjiuwen-ai/verify