docs: 同步 DevHarness 长期文档 (#108)

This commit is contained in:
QiuSW
2026-08-27 17:16:50 +08:00
parent 266bf236b8
commit a3d1bdfb14
16 changed files with 875 additions and 121 deletions
+6 -6
View File
@@ -2,8 +2,8 @@
generated: true (请先修改 Gitea Wiki,禁止直接编辑本文件)
wiki_page: Common-Changes
wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Common-Changes.-
wiki_revision: edfcd6dd2cd254d31e88e980558e467b5fe758a3
synchronized_at: 2026-08-11T10:30:43Z
wiki_revision: becaa9f08fd07397da516c31e3d93362626df050
synchronized_at: 2026-08-27T09:05:21Z
<!-- gitea-wiki-mirror:end -->
# 常见修改指南
@@ -20,15 +20,15 @@ synchronized_at: 2026-08-11T10:30:43Z
| 中风险 | API、配置、依赖、跨模块逻辑、数据结构 | 由 Agent 实现,程序员理解差异并执行验证 |
| 高风险 | 权限、安全、并发、迁移、支付、删除数据、不可逆操作 | 停止修改,由 Agent 分析并等待人工确认 |
“代码行数少”不等于低风险。
“代码行数少”不等于低风险。风险等级只决定由谁实施和验证,不改变建单门禁:新功能、缺陷修复、重构及行为变化仍需工单;只有 AGENTS.md 明确列出的非行为修改和纯显示文案豁免可以直接提交。
## 修改 Wiki 文案
1. 在相关工单确认目标。
2. 读取线上 Wiki 页面和当前 revision。
3. 修改线上 Wiki,不直接编辑 `docs/`。
4. 运行 `python dev_scripts/sync_wiki_docs.py`。
5. 运行 `python dev_scripts/sync_wiki_docs.py --check`。
4. 运行 `python dev_scripts/harness.py sync`。
5. 运行 `python dev_scripts/harness.py sync --check`。
6. 审查本地镜像差异并提交。
停止条件:页面需要删除、重命名或改变事实源边界。
@@ -45,7 +45,7 @@ synchronized_at: 2026-08-11T10:30:43Z
## 调整 Harness 检查
1. 从 `dev_scripts/check_harness.py` 的 `main()` 开始读。
1. 从 `dev_scripts/harness.py` 的 `run_check()` 开始读。
2. 新检查应输出具体文件和缺失内容。
3. 检查结构事实,不声称自动判断文档语义质量。
4. 在 `tests/` 添加成功和失败用例。