From 3575ecb437d5a7eac4073b0ad3e162da8b5c1100 Mon Sep 17 00:00:00 2001 From: ila <2+ila@noreply.git.ilapage.cn> Date: Mon, 24 Aug 2026 16:44:57 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E7=B2=BE=E7=AE=80=E4=BB=BB=E5=8A=A1?= =?UTF-8?q?=E4=BA=8B=E5=AE=9E=E6=9D=A5=E6=BA=90=E4=B8=8E=E5=B7=A5=E7=A8=8B?= =?UTF-8?q?=E5=9F=BA=E7=BA=BF=20(#25)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Existing-Project-Adoption-Guide.-.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/Existing-Project-Adoption-Guide.-.md b/Existing-Project-Adoption-Guide.-.md index 93fffb9..33e4d0e 100644 --- a/Existing-Project-Adoption-Guide.-.md +++ b/Existing-Project-Adoption-Guide.-.md @@ -15,7 +15,7 @@ | 文档 | 创建核心主题页 | 逐页判断保留、迁移、合并或停止维护 | | 工单和 Wiki | 新建并开始使用 | 先检查已有工单、Wiki 和状态体系 | | Git 历史 | 允许一次引导提交 | 保留全部历史，不使用引导提交例外 | -| 任务归档 | 从新项目任务开始 | 不复制 DevHarness 或其他项目的历史归档 | +| 任务证据 | Gitea 工单；任务快照仅显式按需创建 | 保留已有工单；不复制 DevHarness 或其他项目的历史归档 | | 接入方式 | 一次建立最小骨架 | 分阶段增量接入并逐步验收 | 从模板创建全新仓库时使用[新项目文档初始化](New-Project-Documentation-Setup.-)；项目已有业务提交、用户或维护历史时使用本页。 @@ -63,7 +63,7 @@ Agent 在提出方案前只读检查： - 多个应用共同完成一条产品或业务链路； - 由同一团队维护，仓库权限基本一致； - 接口变更需要在一个工单中同步修改或验证多端； -- 共享契约、业务规则和任务归档放在一起更容易保持一致； +- 共享契约和业务规则由同一项目维护并指定唯一事实来源； - 仓库体积、测试时间和工具性能尚未明显影响开发； - 初级维护者和 Agent 能通过目录、子目录 `AGENTS.md` 和文档入口清楚定位。 @@ -123,7 +123,7 @@ Agent 在提出方案前只读检查： ### 7. 提交和验收 -提交只包含当前接入工单相关文件。记录测试、未验证部分、Wiki revision 和提交哈希，创建任务归档并保持工单“待验收”，等待用户明确验收后再关闭。 +提交只包含当前接入工单相关文件。在工单评论集中记录测试、未验证部分、提交哈希，以及真实变化的 Wiki revision 或“无长期文档影响”；保持工单“待验收”，等待用户明确验收后再关闭。默认不创建任务归档。 ## 后续升级 @@ -202,8 +202,8 @@ Agent 在提出方案前只读检查： 严格按工单范围增量接入 DevHarness，保留当前项目已有规则、历史、 任务状态和无关改动。长期文档先更新 Gitea Wiki，读取确认后再导出 -本地 docs 镜像。执行必要测试，提交实现和任务归档，然后把工单保持 -为“待验收”；未经我明确验收，不关闭工单。 +本地 docs 镜像。执行必要测试，提交实现并把最终证据回写工单，然后 +保持“待验收”；默认不创建任务归档，未经我明确验收不关闭工单。 ``` 路径、仓库地址和项目名称必须替换为当前环境的真实值。第二段指令只有在第一段方案已经明确确认后使用。