OPC/goauto
2
0
Fork 0
Code Issues 192 Pull Requests Actions Packages Projects Releases Wiki Activity

T63 精简单人开发流程并重划 Gitea/Wiki 职责 #76

New Issue
Closed
opened 2026-08-24 16:16:08 +08:00 by ila · 3 comments
ila commented 2026-08-24 16:16:08 +08:00
Owner
Copy Link
Copy Source

原始需求

  • 来源：用户对话
  • 提出时间：2026-08-24
  • 脱敏摘要：参考 chorus 的单人开发流程复盘和跨项目工程文档基线，优化 GoAuto 当前开发流程与文档。

当前问题

GoAuto 当前把单次任务事实同时写入 Gitea 工单和 Wiki 任务归档，并在每个任务完成/验收阶段强制执行归档与 Wiki 检查。对于单人开发，这形成重复事实来源和无变化同步；AGENTS.md、Development-Workflow、Home、Project-Profile 仍明确要求默认创建任务归档。

目标

  1. 明确三类唯一事实来源：
    • Gitea 工单：单次任务需求、变化、实现、测试、提交和验收。
    • Gitea Wiki：长期架构、契约、业务规则、安全边界和运行说明。
    • Git：代码、迁移、测试、版本绑定资料和核心 Wiki 只读镜像。
  2. 单人任务默认只在“开始实施”“待验收”“验收关闭”三个节点更新工单；根因、范围、方案、风险或阻塞变化时才追加。
  3. 只有长期事实变化时才更新 Wiki并执行一次 sync + sync --check；无长期影响时完全跳过。
  4. archive / export 保留历史兼容，但仅在用户明确要求专项快照时执行。
  5. 保留且不削弱现有工单、设计证据、高风险人工确认、测试、提交范围和验收门禁。
  6. 把“当前代码事实”和“目标契约”明确区分；文档冲突时以可执行代码/测试、已批准契约、长期 Wiki、旧设计、注释/UI 文案的顺序裁决。

非目标

  • 不删除、迁移或重写已有 Wiki 任务归档和 docs/task/ 历史快照。
  • 不删除 archive / export 命令。
  • 不改变产品业务、API、数据库、Android、Web 或服务端运行行为。
  • 不降低创建订单、迁移、权限、安全、并发、删除和发布等高风险门禁。
  • 不引入完整 SRS/SAD/ADR 文档集；GoAuto 继续采用适合单仓库单人开发的轻量版本。

实施范围

  • AGENTS.md
  • .gitea/issue_template/task.md
  • dev_scripts/harness.py 的治理规则检查
  • Wiki-first 更新 Home、Project-Profile、Development-Workflow、Common-Changes，以及必要时 Task-Archive-Template
  • 通过 harness.py sync 生成对应 docs/ 只读镜像

方案

  • 把默认闭环改为：确认方案 → 建单/标记进行中 → 实施与验证 → 按文档影响决定是否更新 Wiki → 提交推送 → 工单集中回写待验收 → 用户验收后记录结论、关闭并更新父工单。
  • 无长期文档影响时，工单必须写明原因，但不创建任务归档、不运行 Wiki 同步。
  • 有长期文档影响时，仅进行一轮 Wiki 更新、在线回读、sync 和 sync --check；验收时内容未变化不重复同步。
  • 低风险直接提交边界扩展到单文件、范围明确、容易回退且只恢复已有明确行为的缺陷；有任何不确定即回到建单流程。
  • Harness strict 检查新职责边界和默认不归档规则，避免文档以后回退到重复事实源。

设计证据

  • 修改类型：非 UI、开发治理与文档规则。
  • 依据：
    • D:/obsidian_data/ila/项目文档/chorus/chorus-单人开发流程精简与Gitea-Wiki职责调整.md
    • D:/obsidian_data/L2-topics/工程文档基线与契约整顿-engineering-baseline.md
  • 无需 UI 原型：不改变产品界面或用户业务流程。

风险与回退

  • 风险：规则文件和 Wiki 表述不一致会导致 Agent 仍重复归档。
  • 控制：同时更新 AGENTS、工单模板、Harness 检查和映射 Wiki 页面；线上回读后同步镜像。
  • 回退：单提交回退；保留现有归档工具和历史页面，因此不影响历史读取。

验收标准

  • AGENTS、工单模板、Development-Workflow 对单次任务/Wiki/Git 的职责表述一致。
  • 标准任务默认不再创建 Wiki 任务归档，也不导出 docs/task/。
  • 无长期文档影响时明确跳过 Wiki 同步；有影响时只做一轮更新与校验。
  • 高风险、设计证据、迁移、测试、提交范围和人工验收门禁保持不变。
  • Harness strict 能检查新规则且通过。
  • Wiki 页面在线回读取得 revision，核心镜像同步一致。
  • 不修改产品运行代码；相关文档/脚本检查通过。

文档影响

  • Home
  • Project-Profile
  • Development-Workflow
  • Common-Changes
  • Task-Archive-Template（仅说明兼容/按需用途）
## 原始需求 - 来源：用户对话 - 提出时间：2026-08-24 - 脱敏摘要：参考 chorus 的单人开发流程复盘和跨项目工程文档基线，优化 GoAuto 当前开发流程与文档。 ## 当前问题 GoAuto 当前把单次任务事实同时写入 Gitea 工单和 Wiki 任务归档，并在每个任务完成/验收阶段强制执行归档与 Wiki 检查。对于单人开发，这形成重复事实来源和无变化同步；`AGENTS.md`、Development-Workflow、Home、Project-Profile 仍明确要求默认创建任务归档。 ## 目标 1. 明确三类唯一事实来源： - Gitea 工单：单次任务需求、变化、实现、测试、提交和验收。 - Gitea Wiki：长期架构、契约、业务规则、安全边界和运行说明。 - Git：代码、迁移、测试、版本绑定资料和核心 Wiki 只读镜像。 2. 单人任务默认只在“开始实施”“待验收”“验收关闭”三个节点更新工单；根因、范围、方案、风险或阻塞变化时才追加。 3. 只有长期事实变化时才更新 Wiki并执行一次 `sync` + `sync --check`；无长期影响时完全跳过。 4. `archive` / `export` 保留历史兼容，但仅在用户明确要求专项快照时执行。 5. 保留且不削弱现有工单、设计证据、高风险人工确认、测试、提交范围和验收门禁。 6. 把“当前代码事实”和“目标契约”明确区分；文档冲突时以可执行代码/测试、已批准契约、长期 Wiki、旧设计、注释/UI 文案的顺序裁决。 ## 非目标 - 不删除、迁移或重写已有 Wiki 任务归档和 `docs/task/` 历史快照。 - 不删除 `archive` / `export` 命令。 - 不改变产品业务、API、数据库、Android、Web 或服务端运行行为。 - 不降低创建订单、迁移、权限、安全、并发、删除和发布等高风险门禁。 - 不引入完整 SRS/SAD/ADR 文档集；GoAuto 继续采用适合单仓库单人开发的轻量版本。 ## 实施范围 - `AGENTS.md` - `.gitea/issue_template/task.md` - `dev_scripts/harness.py` 的治理规则检查 - Wiki-first 更新 Home、Project-Profile、Development-Workflow、Common-Changes，以及必要时 Task-Archive-Template - 通过 `harness.py sync` 生成对应 `docs/` 只读镜像 ## 方案 - 把默认闭环改为：确认方案 → 建单/标记进行中 → 实施与验证 → 按文档影响决定是否更新 Wiki → 提交推送 → 工单集中回写待验收 → 用户验收后记录结论、关闭并更新父工单。 - 无长期文档影响时，工单必须写明原因，但不创建任务归档、不运行 Wiki 同步。 - 有长期文档影响时，仅进行一轮 Wiki 更新、在线回读、`sync` 和 `sync --check`；验收时内容未变化不重复同步。 - 低风险直接提交边界扩展到单文件、范围明确、容易回退且只恢复已有明确行为的缺陷；有任何不确定即回到建单流程。 - Harness strict 检查新职责边界和默认不归档规则，避免文档以后回退到重复事实源。 ## 设计证据 - 修改类型：非 UI、开发治理与文档规则。 - 依据： - `D:/obsidian_data/ila/项目文档/chorus/chorus-单人开发流程精简与Gitea-Wiki职责调整.md` - `D:/obsidian_data/L2-topics/工程文档基线与契约整顿-engineering-baseline.md` - 无需 UI 原型：不改变产品界面或用户业务流程。 ## 风险与回退 - 风险：规则文件和 Wiki 表述不一致会导致 Agent 仍重复归档。 - 控制：同时更新 AGENTS、工单模板、Harness 检查和映射 Wiki 页面；线上回读后同步镜像。 - 回退：单提交回退；保留现有归档工具和历史页面，因此不影响历史读取。 ## 验收标准 - [ ] AGENTS、工单模板、Development-Workflow 对单次任务/Wiki/Git 的职责表述一致。 - [ ] 标准任务默认不再创建 Wiki 任务归档，也不导出 `docs/task/`。 - [ ] 无长期文档影响时明确跳过 Wiki 同步；有影响时只做一轮更新与校验。 - [ ] 高风险、设计证据、迁移、测试、提交范围和人工验收门禁保持不变。 - [ ] Harness strict 能检查新规则且通过。 - [ ] Wiki 页面在线回读取得 revision，核心镜像同步一致。 - [ ] 不修改产品运行代码；相关文档/脚本检查通过。 ## 文档影响 - [ ] Home - [ ] Project-Profile - [ ] Development-Workflow - [ ] Common-Changes - [ ] Task-Archive-Template（仅说明兼容/按需用途）
ila commented 2026-08-24 16:16:15 +08:00
Author
Owner
Copy Link
Copy Source

开始实施。已完成两份参考文档与 GoAuto 当前 AGENTS、Wiki 镜像、Harness 校验项的只读对照；本次只调整开发治理和文档工具检查，不修改产品运行代码。工作区仅有与本工单无关的未跟踪 gitea.zip，将保持不动。

开始实施。已完成两份参考文档与 GoAuto 当前 AGENTS、Wiki 镜像、Harness 校验项的只读对照；本次只调整开发治理和文档工具检查，不修改产品运行代码。工作区仅有与本工单无关的未跟踪 `gitea.zip`，将保持不动。
ila commented 2026-08-24 16:28:23 +08:00
Author
Owner
Copy Link
Copy Source

#76 已实施并推送，当前保持待验收。

最终差异：

  • AGENTS.md 明确 Gitea 工单是单次任务唯一事实源、Wiki 只维护长期事实、Git 保存交付物与核心镜像。
  • 标准任务不再创建 Wiki 任务归档或导出 docs/task/；archive / export 只保留为用户明确要求的历史快照能力。
  • Wiki 同步改为由长期事实变化触发；无影响时完全跳过，有影响时只做一轮在线更新、回读、sync 和 sync --check。
  • 工单默认只在开始实施、集中回写待验收、验收关闭三个节点更新；重要根因、范围、方案、风险或阻塞变化才追加。
  • 补充权威源裁决顺序、“当前实现 / 目标契约”边界、轻量基线/差距审计要求。
  • 低风险直接提交边界增加不改变行为的测试和单文件恢复既有行为缺陷，但保留全部安全、迁移、接口、并发、UI 原型和高风险人工确认门禁。
  • 工单模板、Harness strict 规则和测试同步更新。
  • 修复 tests/test_wiki_docs.py 仍导入已合并删除旧脚本的存量漂移，测试现在直接覆盖 harness.py。

Wiki-first 页面与 revision：

  • Home：191c8f4a601e90e5bfbbfff3d3404c8b824afc40
  • Project-Profile：a1f90d0ff56ce30ace6febbe5de859f3e20ca5fd
  • Development-Workflow：a7f146e9e25f621fdca6c16f970e2228c8f6e111
  • Common-Changes：19a6ae116ed3d90e4206f9a0af7c45b6c9a50590
  • Task-Archive-Template：53927b3b69fa26943f323f9be53153f80ed54530

验证：

  • python -m unittest discover -s tests -v：17 passed。
  • python dev_scripts/harness.py check --strict：通过。
  • 本次唯一一轮 sync + sync --check：通过，全部核心镜像一致。
  • python dev_scripts/harness.py --help：通过。
  • git diff --check：通过。
  • 未执行产品服务端/Web/Android 运行测试：本工单不修改产品运行代码。

提交：791f90c docs(#76): 精简单人开发工作流，已推送 main。

按本工单刚生效的新规则，没有创建 Wiki 任务归档；单次任务完整证据保留在本工单。等待用户验收。

#76 已实施并推送，当前保持待验收。 最终差异： - `AGENTS.md` 明确 Gitea 工单是单次任务唯一事实源、Wiki 只维护长期事实、Git 保存交付物与核心镜像。 - 标准任务不再创建 Wiki 任务归档或导出 `docs/task/`；`archive` / `export` 只保留为用户明确要求的历史快照能力。 - Wiki 同步改为由长期事实变化触发；无影响时完全跳过，有影响时只做一轮在线更新、回读、`sync` 和 `sync --check`。 - 工单默认只在开始实施、集中回写待验收、验收关闭三个节点更新；重要根因、范围、方案、风险或阻塞变化才追加。 - 补充权威源裁决顺序、“当前实现 / 目标契约”边界、轻量基线/差距审计要求。 - 低风险直接提交边界增加不改变行为的测试和单文件恢复既有行为缺陷，但保留全部安全、迁移、接口、并发、UI 原型和高风险人工确认门禁。 - 工单模板、Harness strict 规则和测试同步更新。 - 修复 `tests/test_wiki_docs.py` 仍导入已合并删除旧脚本的存量漂移，测试现在直接覆盖 `harness.py`。 Wiki-first 页面与 revision： - Home：`191c8f4a601e90e5bfbbfff3d3404c8b824afc40` - Project-Profile：`a1f90d0ff56ce30ace6febbe5de859f3e20ca5fd` - Development-Workflow：`a7f146e9e25f621fdca6c16f970e2228c8f6e111` - Common-Changes：`19a6ae116ed3d90e4206f9a0af7c45b6c9a50590` - Task-Archive-Template：`53927b3b69fa26943f323f9be53153f80ed54530` 验证： - `python -m unittest discover -s tests -v`：17 passed。 - `python dev_scripts/harness.py check --strict`：通过。 - 本次唯一一轮 `sync` + `sync --check`：通过，全部核心镜像一致。 - `python dev_scripts/harness.py --help`：通过。 - `git diff --check`：通过。 - 未执行产品服务端/Web/Android 运行测试：本工单不修改产品运行代码。 提交：`791f90c docs(#76): 精简单人开发工作流`，已推送 main。 按本工单刚生效的新规则，没有创建 Wiki 任务归档；单次任务完整证据保留在本工单。等待用户验收。
ila commented 2026-08-28 15:07:32 +08:00
Author
Owner
Copy Link
Copy Source

用户于 2026-08-28 明确确认本工单验收通过。按项目流程记录验收结论并关闭工单；本次仅更新工单状态，无新增长期文档事实，不重复同步 Wiki。

用户于 2026-08-28 明确确认本工单验收通过。按项目流程记录验收结论并关闭工单；本次仅更新工单状态，无新增长期文档事实，不重复同步 Wiki。
ila closed this issue 2026-08-28 15:07:34 +08:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin ila
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: OPC/goauto#76