Table of Contents

48 简化单人开发工作流

背景与目标
最终方案
修改文件
验收结果
测试
遗留问题
相关提交

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

48 简化单人开发工作流

迁移说明：这是流程切换前按旧规则创建的最后一次强制任务归档。自 #48 验收后，新任务以 Gitea 工单保存完成证据，不再强制创建 Wiki 任务归档。

类型：工程治理
所属 Epic：无
所属 MVP / 版本：无
状态：待验收
日期：2026-08-24
Gitea 工单：#48
Wiki 页面：Task-48-简化单人开发工作流

背景与目标

单人开发时，工单、Wiki 任务归档和多次镜像同步重复记录同一事实。目标是保留必要安全门禁和验收证据，同时减少过程维护成本。

最终方案

Gitea 单元工单成为单次任务需求、过程、实现、测试、提交和验收的事实来源。
Wiki 只维护长期有效文档；仅在长期事实变化时执行一次同步与一致性检查。
标准节奏为开始实施更新一次、待验收集中回写一次、验收后关闭并更新父工单。
新任务不再强制创建 Wiki 任务归档；archive/export 与 docs/task 保留为用户明确触发的历史兼容能力。
明确扩大单文件低风险修复、纯测试及非行为修改的免工单范围；高风险、接口、数据库、配置契约、跨模块和重大 UI 仍必须建单。

修改文件

AGENTS.md、README.md：更新执行规则和入口说明。
.gitea/issue_template/task.md：增加集中完成证据字段。
dev_scripts/harness.py、tests/test_harness_docs.py：更新规则检查、兼容命令说明和测试。
docs/ 相关页面：同步线上 Wiki 的长期流程、风险、接入和事实来源调整。

验收结果

验收标准	结果
必须建单和免单边界清楚	通过
标准流程不再要求 Wiki 任务归档	通过
Wiki 仅在长期文档变化时同步	通过
历史 archive/export 能力保留	通过
工单模板与长期文档一致	通过
未混入本机配置或产品功能	通过

测试

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

遗留问题

既有任务归档和 docs/task/ 快照保留为历史，不自动清理。