| | |
|---|
| | | # Taglauncher 代码治理与 Git 规范 |
|---|
| | | |
|---|
| | | 本文档是 `/Users/ar/Projects/Taglauncher2/03-O` 的代码管理、Git 使用、交付和 Agent 协作规范。根目录 `AGENTS.md` 是强制入口；本文件是完整执行标准。 |
|---|
| | | 本文档是 `/Users/ar/Projects/Taglauncher/03-O` 的代码管理、Git 使用、交付和 Agent 协作规范。根目录 `AGENTS.md` 是强制入口；本文件是完整执行标准。 |
|---|
| | | |
|---|
| | | ## 1. 项目边界 |
|---|
| | | |
|---|
| | | - 主仓库工作区固定为 `/Users/ar/Projects/Taglauncher2/03-O`。 |
|---|
| | | - 唯一源码根目录固定为 `/Users/ar/Projects/Taglauncher2/03-O/C1.source`。 |
|---|
| | | - 主仓库工作区固定为 `/Users/ar/Projects/Taglauncher/03-O`。 |
|---|
| | | - 唯一源码根目录固定为 `/Users/ar/Projects/Taglauncher/03-O/C1.source`。 |
|---|
| | | - App 源码、构建脚本、QA 脚本、SmartStart/Apple catalog 资料都必须在 `C1.source/` 下维护；发布证据进入 `K3.运营与发布资料/Release/`，当前迁入构建包进入 `C2.builds/`。 |
|---|
| | | - 项目根目录只保留仓库入口文档、公开网站资料、治理规范和非源码管理说明。 |
|---|
| | | - 不允许再创建或继续使用 `/Users/ar/Projects/Taglauncher2/03-O-*source`、`/Users/ar/Projects/Apptag-*` 等外部源码目录。 |
|---|
| | | - 不允许再创建或继续使用 `/Users/ar/Projects/Taglauncher/03-O-*source`、`/Users/ar/Projects/Apptag-*` 等外部源码目录。 |
|---|
| | | |
|---|
| | | ## 2. Git 工作区规则 |
|---|
| | | |
|---|
| | |
|---|
| | | - 对应分支。 |
|---|
| | | - 预计生命周期。 |
|---|
| | | - 清理条件。 |
|---|
| | | - worktree 不得放在 `/Users/ar/Projects/Taglauncher2/03-O-*source` 或 `/Users/ar/Projects/Apptag-*` 这类容易被误认为正式源码根目录的位置。 |
|---|
| | | - worktree 不得放在 `/Users/ar/Projects/Taglauncher/03-O-*source` 或 `/Users/ar/Projects/Apptag-*` 这类容易被误认为正式源码根目录的位置。 |
|---|
| | | - 任务完成后必须执行： |
|---|
| | | |
|---|
| | | ```bash |
|---|
| | |
|---|
| | | |
|---|
| | | TagLauncher 的 UI 工作必须先确认视觉目标，再修改生产 SwiftUI / AppKit 源码。经验复盘见： |
|---|
| | | |
|---|
| | | `/Users/ar/Projects/Taglauncher2/03-O/K2.项目管理/KM2.项目管理-经验门禁/关于TagLauncher所有UI类问题的经验与教训.md` |
|---|
| | | `/Users/ar/Projects/Taglauncher/03-O/K2.项目管理/KM2.项目管理-经验门禁/关于TagLauncher所有UI类问题的经验与教训.md` |
|---|
| | | |
|---|
| | | ### 10.1 触发范围 |
|---|
| | | |
|---|
| | |
|---|
| | | |
|---|
| | | 非平凡 UI 改动开工前必须先写 UI 合约。推荐模板： |
|---|
| | | |
|---|
| | | `/Users/ar/Projects/Taglauncher2/03-O/K2.项目管理/KM2.项目管理-经验门禁/UI合约模板.md` |
|---|
| | | `/Users/ar/Projects/Taglauncher/03-O/K2.项目管理/KM2.项目管理-经验门禁/UI合约模板.md` |
|---|
| | | |
|---|
| | | 如果当前任务已有 PRD、TODO、Round 文档或 issue，也可以在该文档中写入同等字段，不强制复制模板。UI 合约至少包含： |
|---|
| | | |
|---|
| | |
|---|
| | | 从源码根目录运行 QA： |
|---|
| | | |
|---|
| | | ```bash |
|---|
| | | cd /Users/ar/Projects/Taglauncher2/03-O/C1.source |
|---|
| | | cd /Users/ar/Projects/Taglauncher/03-O/C1.source |
|---|
| | | bash Scripts/apple_default_apps_resource_qa.sh 2>&1 | head -c 12000 |
|---|
| | | bash Scripts/apple_default_note_policy_qa.sh 2>&1 | head -c 12000 |
|---|
| | | bash Scripts/smartstart_catalog_resource_qa.sh 2>&1 | head -c 12000 |
|---|
