docs: 同步 DevHarness 长期文档 (#108)
This commit is contained in:
@@ -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/` 添加成功和失败用例。
|
||||
|
||||
Reference in New Issue
Block a user