OPC/chorus
2
0
Fork 0
Code Issues 11 Pull Requests Actions Packages Projects Releases Wiki Activity

chore: 简化单人开发的 Gitea 工单与 Wiki 流程 #48

New Issue
Closed
opened 2026-08-24 15:48:17 +08:00 by ila · 2 comments
ila commented 2026-08-24 15:48:17 +08:00
Owner
Copy Link
Copy Source

类型

工程治理 / 开发流程

原始需求

  • 来源：用户会话
  • 时间：2026-08-24
  • 脱敏摘要：当前为单人开发，希望按已确认建议减少 Gitea 工单、Wiki 归档和重复同步的流程耗时。

状态

待验收

目标

  • Gitea 单元工单继续作为任务过程、实现结果、测试和验收的唯一事实来源。
  • Gitea Wiki 只维护长期有效文档；任务结束不再强制创建 Wiki 任务归档。
  • 标准任务仅在开始/发生重要变化时更新工单，并在待验收时集中回写一次结果；验收后记录结论、关闭工单和更新父工单。
  • 仅在长期文档发生变化时同步 Wiki 镜像，并将同步与最终检查合并为一次闭环。
  • 扩大明确低风险修改的免工单范围，同时保留安全和高风险门禁。
  • docs/task/ 与 archive/export 命令保留为历史兼容和人工明确触发能力，不再属于标准完成流程。

非目标

  • 不削弱凭据、安全、权限、迁移、并发、破坏性操作和发布门禁。
  • 不取消新功能、接口/配置契约、数据库、跨模块或重大 UI 修改的工单要求。
  • 不取消方案确认、必要测试、Git 提交或用户验收。
  • 不删除既有 Wiki 任务归档、docs/task/ 快照或兼容命令。
  • 不修改 Chorus 产品功能。

已确认方案

用户于 2026-08-24 确认采用单人开发精简流程：工单承载单次任务全过程；Wiki 仅承载长期结论；任务归档改为可选历史能力；核心 Wiki 镜像按文档影响条件同步；明确低风险修改可直接提交。

设计证据

非 UI 工程治理任务，无需原型。替代证据为本工单中的流程设计和用户于 2026-08-24 的明确确认。

前置工单

无。不属于产品 Epic/MVP，可独立实施。

影响范围

  • AGENTS.md
  • Gitea Wiki 的开发工作流、常见修改、既有项目接入、项目需求说明等相关长期页面
  • .gitea/issue_template/task.md
  • DevHarness 的提示、结构检查及对应测试（仅在规则一致性需要时）
  • 本地核心 Wiki 镜像

风险与回退

  • 风险：精简措辞过宽可能漏建高风险工单，或使长期文档未及时同步。
  • 控制：显式列出必须建单和必须同步的条件；保留安全红线、设计门禁和用户验收。
  • 回退：恢复本工单提交，并从 Wiki 对应 revision 恢复旧流程页面。

验收标准

  • 规则清楚区分“必须建单”和“可直接提交”的修改。
  • 标准流程不再要求 Wiki 任务归档，工单包含完成证据和验收结论。
  • Wiki 同步只在长期文档变化时执行，且无重复同步要求。
  • archive/export 与 docs/task/ 明确为兼容/人工按需能力。
  • 工单模板与核心 Wiki 文档表达一致。
  • Harness 严格检查和 Python 单元测试通过。
  • 未混入本机配置文件或 Chorus 产品功能改动。

文档影响

需要更新 Development-Workflow、Common-Changes、Existing-Project-Adoption-Guide、Product-Requirements-Overview 等长期 Wiki 页面，并同步核心镜像。

迁移说明

本工单按修改前的规则完成最后一次强制 Wiki 任务归档；新流程在本工单验收后作为正式规则执行。

## 类型 工程治理 / 开发流程 ## 原始需求 - 来源：用户会话 - 时间：2026-08-24 - 脱敏摘要：当前为单人开发，希望按已确认建议减少 Gitea 工单、Wiki 归档和重复同步的流程耗时。 ## 状态 待验收 ## 目标 - Gitea 单元工单继续作为任务过程、实现结果、测试和验收的唯一事实来源。 - Gitea Wiki 只维护长期有效文档；任务结束不再强制创建 Wiki 任务归档。 - 标准任务仅在开始/发生重要变化时更新工单，并在待验收时集中回写一次结果；验收后记录结论、关闭工单和更新父工单。 - 仅在长期文档发生变化时同步 Wiki 镜像，并将同步与最终检查合并为一次闭环。 - 扩大明确低风险修改的免工单范围，同时保留安全和高风险门禁。 - `docs/task/` 与 archive/export 命令保留为历史兼容和人工明确触发能力，不再属于标准完成流程。 ## 非目标 - 不削弱凭据、安全、权限、迁移、并发、破坏性操作和发布门禁。 - 不取消新功能、接口/配置契约、数据库、跨模块或重大 UI 修改的工单要求。 - 不取消方案确认、必要测试、Git 提交或用户验收。 - 不删除既有 Wiki 任务归档、`docs/task/` 快照或兼容命令。 - 不修改 Chorus 产品功能。 ## 已确认方案 用户于 2026-08-24 确认采用单人开发精简流程：工单承载单次任务全过程；Wiki 仅承载长期结论；任务归档改为可选历史能力；核心 Wiki 镜像按文档影响条件同步；明确低风险修改可直接提交。 ## 设计证据 非 UI 工程治理任务，无需原型。替代证据为本工单中的流程设计和用户于 2026-08-24 的明确确认。 ## 前置工单 无。不属于产品 Epic/MVP，可独立实施。 ## 影响范围 - `AGENTS.md` - Gitea Wiki 的开发工作流、常见修改、既有项目接入、项目需求说明等相关长期页面 - `.gitea/issue_template/task.md` - DevHarness 的提示、结构检查及对应测试（仅在规则一致性需要时） - 本地核心 Wiki 镜像 ## 风险与回退 - 风险：精简措辞过宽可能漏建高风险工单，或使长期文档未及时同步。 - 控制：显式列出必须建单和必须同步的条件；保留安全红线、设计门禁和用户验收。 - 回退：恢复本工单提交，并从 Wiki 对应 revision 恢复旧流程页面。 ## 验收标准 - [x] 规则清楚区分“必须建单”和“可直接提交”的修改。 - [x] 标准流程不再要求 Wiki 任务归档，工单包含完成证据和验收结论。 - [x] Wiki 同步只在长期文档变化时执行，且无重复同步要求。 - [x] archive/export 与 `docs/task/` 明确为兼容/人工按需能力。 - [x] 工单模板与核心 Wiki 文档表达一致。 - [x] Harness 严格检查和 Python 单元测试通过。 - [x] 未混入本机配置文件或 Chorus 产品功能改动。 ## 文档影响 需要更新 `Development-Workflow`、`Common-Changes`、`Existing-Project-Adoption-Guide`、`Product-Requirements-Overview` 等长期 Wiki 页面，并同步核心镜像。 ## 迁移说明 本工单按修改前的规则完成最后一次强制 Wiki 任务归档；新流程在本工单验收后作为正式规则执行。
ila commented 2026-08-24 16:06:37 +08:00
Author
Owner
Copy Link
Copy Source

实施完成，等待验收

最终结果

  • Gitea 工单现为单次任务需求、过程、实现、测试、提交和验收的事实来源。
  • Wiki 只维护长期有效文档；无长期文档影响的任务不再同步 Wiki。
  • 标准任务按“开始实施一次、待验收集中一次、验收关闭一次”维护工单；只有重要变化或阻塞才追加过程记录。
  • 新任务不再强制建立 Wiki 任务归档；archive、export、docs/task/ 仅保留为用户明确触发的历史兼容能力。
  • 低风险免单范围已扩展；新功能、API/配置契约、数据库、安全权限、并发、删除、跨模块和重大 UI 仍必须建单。

验证

  • python dev_scripts/harness.py check --strict：通过。
  • python -m unittest discover -s tests -v：43 项通过。
  • python dev_scripts/harness.py sync --check：16 个核心 Wiki 镜像全部一致。
  • git diff --check：通过。
  • 未验证：无产品运行行为变更，未运行 Go、管理端或浏览器测试。

交付证据

  • 提交：0920621（已推送到 origin/main）
  • 迁移归档：Task-48-简化单人开发工作流
  • 归档 revision：74e4ec374384ab701ff1ad34a14a3bf0a5a184dd
  • 本机 config/local-services.yml 与 admin/config/settings.yml 未纳入提交。

本工单保持开启，状态为“待验收”。用户明确验收后再关闭；没有产品 Epic/MVP 需要同步。

## 实施完成，等待验收 ### 最终结果 - Gitea 工单现为单次任务需求、过程、实现、测试、提交和验收的事实来源。 - Wiki 只维护长期有效文档；无长期文档影响的任务不再同步 Wiki。 - 标准任务按“开始实施一次、待验收集中一次、验收关闭一次”维护工单；只有重要变化或阻塞才追加过程记录。 - 新任务不再强制建立 Wiki 任务归档；`archive`、`export`、`docs/task/` 仅保留为用户明确触发的历史兼容能力。 - 低风险免单范围已扩展；新功能、API/配置契约、数据库、安全权限、并发、删除、跨模块和重大 UI 仍必须建单。 ### 验证 - `python dev_scripts/harness.py check --strict`：通过。 - `python -m unittest discover -s tests -v`：43 项通过。 - `python dev_scripts/harness.py sync --check`：16 个核心 Wiki 镜像全部一致。 - `git diff --check`：通过。 - 未验证：无产品运行行为变更，未运行 Go、管理端或浏览器测试。 ### 交付证据 - 提交：`0920621`（已推送到 `origin/main`） - 迁移归档：`Task-48-简化单人开发工作流` - 归档 revision：`74e4ec374384ab701ff1ad34a14a3bf0a5a184dd` - 本机 `config/local-services.yml` 与 `admin/config/settings.yml` 未纳入提交。 本工单保持开启，状态为“待验收”。用户明确验收后再关闭；没有产品 Epic/MVP 需要同步。
ila commented 2026-08-24 16:08:06 +08:00
Author
Owner
Copy Link
Copy Source

用户验收通过

  • 验收时间：2026-08-24
  • 验收结论：用户明确确认 #48 通过验收。
  • 交付提交：0920621
  • 结果：单人开发精简流程正式生效；后续任务不再强制创建 Wiki 任务归档，仅在长期事实变化时同步核心 Wiki 镜像。
  • 父工单：无，不需要同步 Epic/MVP。

按新流程关闭工单，不重复同步无变化的 Wiki，也不导出任务归档。

## 用户验收通过 - 验收时间：2026-08-24 - 验收结论：用户明确确认 `#48 通过验收`。 - 交付提交：`0920621` - 结果：单人开发精简流程正式生效；后续任务不再强制创建 Wiki 任务归档，仅在长期事实变化时同步核心 Wiki 镜像。 - 父工单：无，不需要同步 Epic/MVP。 按新流程关闭工单，不重复同步无变化的 Wiki，也不导出任务归档。
ila closed this issue 2026-08-24 16:08:07 +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/chorus#48