diff --git a/docs/design/13-toolchain-and-dev-workflow.md b/docs/design/13-toolchain-and-dev-workflow.md index 5065ea5..f591137 100644 --- a/docs/design/13-toolchain-and-dev-workflow.md +++ b/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 按钮)