DataPacker 项目 Agent 约束

严禁文本断言（Strict Ban on Text Assertions）

编写或修改 pytest 测试时，绝对禁止任何形式的纯文本或字符串断言。

禁止写法

禁止 assert "some string" in result。
禁止 assert result == "exact string"。
禁止 assert "string" not in result。
禁止使用正则表达式匹配纯文本输出。
禁止使用 pytest.raises(..., match=...) 校验异常消息。
禁止通过读取 Markdown、源码、脚本、workflow 或配置文件后搜索字符串来验证行为。

必须采用的验证方式

验证数据结构或对象状态：断言函数返回的字典、Dataclass、Pydantic Model、Enum、Path 或其他领域对象属性，不断言其序列化文本。
验证方法调用：使用 unittest.mock.patch、MagicMock 或 spy，断言底层核心函数收到的参数和调用次数。
验证业务副产物：断言文件、archive members、hash、状态码、布尔值、数值、对象类型或进程退出状态。
验证结构化配置：TOML、YAML、JSON 必须解析成对象后验证；不得搜索原始文本。
验证异常时优先断言异常类型和结构化属性，不得匹配异常消息。

被测代码只有文本输出时

如果被测函数只返回一个巨大字符串，必须先重构业务代码，把“数据组装”和“文本渲染”拆开；测试只覆盖数据组装函数返回的结构化对象。不得为了保留文本断言而增加另一种字符串搜索、正则或快照测试。

项目门禁

项目内所有 test_*.py、*_test.py 和 conftest.py 都必须通过文本断言 AST policy gate，包括根测试集之外的子项目测试。
新测试和既有测试适用同一规则，不允许 grandfathered violation。
字符串可以作为被测 API 输入、Path 构造参数、字典 key 或 mock 调用参数；禁止的是对纯文本结果、渲染文本、源码文本、日志文本和异常消息进行断言。

DLP 与 git push

本仓库位于 DLP 透明加密保护区（E:\WorkSpace\）。在保护区内直接执行 git push 会必现 fatal: not a git repository (or any of the parent directories): .git（退出码 128）；其他 git 命令（status / commit / pull 等）全部正常，这是 DLP 驱动对 push 进程访问模式的拦截，不是仓库损坏，不要修仓库、不要重装 git。

提交推送（git push）必须调用项目内 skill git-push-dlp（.kimi-code/skills/git-push-dlp/，详细用法见其 SKILL.md）：

cmd /c .kimi-code\skills\git-push-dlp\scripts\git_push_dlp.bat origin main

push 包含新增 / 变更的 LFS 对象时，先 set GIT_PUSH_DLP_WITH_LFS=1 再运行（恢复全量复制 .git\lfs）。

2.7 KiB Raw Permalink Blame History Unescape Escape