47 lines
1.9 KiB
Markdown
47 lines
1.9 KiB
Markdown
<!-- 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. 用户验收前工单是否仍保持打开。
|