<!-- gitea-wiki-mirror:start -->
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
wiki_page: Common-Changes
wiki_url: https://git.ilapage.cn/OPC/cmautobuy/wiki/Common-Changes.-
wiki_revision: 6ea470c4bc0b45de29973b0e03b2426a4a85a02a
synchronized_at: 2026-08-26T08:42:54Z
<!-- gitea-wiki-mirror:end -->

# 常见修改

## 风险分级

| 风险 | 示例 | 最小要求 |
|---|---|---|
| 低 | 错别字、注释、纯内部变量名 | 不改变行为时可小改直通 |
| 中 | 页面字段、筛选、普通接口行为 | 工单、对应子项目规则、单元测试 |
| 高 | 数据库迁移、Client API、线程、采购、下单、幂等、崩溃恢复 | 工单、设计证据、回退、专门验证；条件不全时停止 |

## 修改 Wiki 文案

1. 找到在线 Wiki 页面并确认当前 revision。
2. 修改在线页，写清提交说明。
3. 回读页面和新 revision。
4. 从仓库根目录运行 `python dev_scripts/harness.py sync --verify`。
5. 只提交对应镜像文件；不要直接编辑镜像正文。

长期事实没有变化时只更新工单，不修改 Wiki。

## 调整 Harness 检查

- 先在工单说明为什么规则变化，不把项目事实硬编码成 DevHarness 模板事实。
- 同步修改 `dev_scripts/harness.py`、`wiki-docs.json` 和对应 `tests/`。
- 映射只允许 `docs/` 下 Markdown，不能映射凭据、原始数据、日志和历史动态目录。
- 先运行工具单测，再运行严格检查和 Wiki 一致性校验。

## 看懂 Agent 的修改

交付时按这个顺序核对：

1. 工单目标、非目标和已确认设计证据。
2. `git diff --stat` 与实际改动文件是否一致。
3. 是否碰到根红线或跨子项目契约。
4. 测试命令的实际结果和“未验证部分”。
5. 提交是否只含当前工单文件。
6. Wiki 是否只在长期事实变化时更新，并带可回读 revision。
7. 用户验收前工单是否仍保持打开。