cmautobuy/docs/05-common-changes.md

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

常见修改

风险分级

风险	示例	最小要求
低	错别字、注释、纯内部变量名	不改变行为时可小改直通
中	页面字段、筛选、普通接口行为	工单、对应子项目规则、单元测试
高	数据库迁移、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. 用户验收前工单是否仍保持打开。