auto-sync: 2026-06-06 07:51:34

docs/design/13-toolchain-and-dev-workflow.md

@@ -610,11 +610,43 @@ P1 必须先配好以下工具，否则机械门控跑不起来：
 | Q3 | 评审回答 | 覆盖率基线缺失 | §5.3 新增渐进策略（P1 只报告 → P2 40% → P3 60%） |
 | Q6 | 评审回答 | 机械门控前提未就绪 | §8.4 新增工具清单，§11 标注 P1 必须先就位 |
 
+### v0.3 → v0.4 修订清单（主公审阅反馈）
+
+| 编号 | 反馈 | 修订内容 |
+|------|------|---------|
+| F1 | 需求/问题必须经 Review | §1 新增原则 7；§4.3 新增需求 Review 前置规则；§9.1 场景 A 加入 Review 步骤 |
+| F2 | E2E 仅用户触发 | §8.1 E2E 改为“仅用户手动触发”；§8.2 门控说明移除 E2E 自动跑；§9.1/9.3 验证步骤更新 |
+| F3 | 编码/测试人人能做，功能/集成/E2E 司马懿专职 | §10 新增测试分工规范表 |
+| F4 | 审查默认司马懿 | §6.2 简化为司马懿统一审查，仅司马懿自身改动由庞统交叉审查 |
+| F5 | 以项目为单位组织 | §1 新增原则 8；Issue 标签体系含项目维度 |
+| F6 | 姜维持有 Gitea admin | §2.1 权限更新 |
+| F7 | 分支保护含义说明 | §3.3 补充分支保护规则说明 |
+| F8 | schema 变更能自动化就自动化 | 保留在 release-workflow，CI check + Issue 兜底 |
+
 ---
 
-## §13. 待讨论
+## §13. 项目维度组织
 
-1. **Gitea admin 权限**：需要主公用 admin 账号改 `app.ini` 启用 Actions
-2. **分支保护**：是否在 Gitea 里配 branch protection（要求 CI 通过才能 merge）？
-3. **数据库 schema 变更检查**：是否需要 CI 自动检测 schema 不兼容变更（如删字段、改类型）？还是靠人工 Review？
-4. **E2E 触发策略**：tag 发布时自动跑 E2E，但 E2E 需要 spawn 真实 Agent（耗时 10-30 分钟），接受这个成本吗？
+### 13.1 多项目并行
+
+所有内容以项目为单位组织：
+
+| 维度 | 按项目组织 |
+|------|------------|
+| **代码仓库** | Gitea 上每个项目一个 repo |
+| **Issue** | 每个项目的 Issue 独立管理 |
+| **CI/CD** | 每个项目自管 `.gitea/workflows/` |
+| **部署脚本** | 每个项目自管 `scripts/deploy.sh` |
+| **测试** | 每个项目自管 `tests/` 目录 |
+| **Skill 配置** | 通用 Skill 共享，项目特定 Skill 放项目仓库 |
+
+特殊：`_general` 项目用于跨项目的通用任务（如工具链基础设施维护）。
+
+---
+
+## §14. 待讨论
+
+1. **Gitea admin 权限**：姜维持有 admin 权限，可负责启用 Actions、配置分支保护等
+2. **分支保护**：建议开启两条规则——（a）PR 必须 CI 通过才能 merge；（b）PR 必须至少 1 人 Review 才能合并。Gitea 的 branch protection 功能在仓库 Settings → Branches 中配置
+3. **数据库 schema 变更检查**：能自动化就自动化（CI check 检测破坏性变更），自动化解决不了的提 Issue 人工干预
+4. **E2E 测试触发**：用户手动触发，不自动跑。触发方式待定（Gitea manual trigger / 命令行 / Dashboard 按钮）