semantic-contract git:20260908.7e2cb50A

Immutable. This exact content is served forever at /api/v1/blob/723a74cefe6c1cc4.

---
name: semantic-contract
description: >-
  提供语义材料版本 1 的唯一对象、引用、状态、风险视角和结构校验合同；仅在其它语义 Skill 要读写语义对象，
  或用户要求检查语义材料格式与合同漂移时使用，不负责普通代码审查。
metadata:
  category: 语义质量
  scope: 框架
---

# 语义材料合同

本 Skill 是当前仓库语义对象格式的唯一入口。它不判断业务行为是否正确，也不创建运行时存储或调度器。
结构校验需要 `uv`，或已安装 PyYAML 的 Python 3.9 及以上版本；环境不满足时报告缺口，不跳过校验。

## 输入

- 仓库根绝对路径；
- 操作：读取合同、校验现有 `semantic/`，或运行校验器自测；
- 可选的另一个合同文件绝对路径，用于跨仓一致性检查。

## 工作流

1. 需要创建、更新或解释语义对象时，读取 `references/semantic-artifact-contract.md`。
2. 需要校验磁盘材料时，在本 Skill 根目录运行 `uv run scripts/verify_semantic.py --root <仓库根绝对路径>`。
3. 修改校验器后运行 `uv run scripts/verify_semantic.py --self-test`。
4. 同时修改两个仓库的合同后，对两个合同文件做字节一致性检查；不一致时不得继续写对象。

## 输出

返回合同版本、校验范围、错误列表、退出码和不能证明的内容。结构通过只代表材料可解析且引用完整，
不代表行为正确、审查充分或仓库没有缺陷。