From 8fbe7d9123cdb618de5ecf3cd1b0fb81199a2dac Mon Sep 17 00:00:00 2001 From: Ariver <shanghai3168@gmail.com> Date: Sun, 28 Jun 2026 23:51:46 +0800 Subject: [PATCH] docs: update Aligner2 handoff baseline --- C1.source/AGENTS.md | 29 ++++++++++++++++------------- 1 files changed, 16 insertions(+), 13 deletions(-) diff --git a/C1.source/AGENTS.md b/C1.source/AGENTS.md index f6dd313..52f9d10 100644 --- a/C1.source/AGENTS.md +++ b/C1.source/AGENTS.md @@ -1,25 +1,26 @@ # C1.source/AGENTS.md - 源码目录规则 -适用于 `/Users/ar/Projects/Aligner/03-O/C1.source`。 +适用于 `/Users/ar/Projects/Aligner2/03-O/C1.source`。 ## 当前事实 - 本目录是 SwiftPM 源码根目录。 -- 本目录不是 Git 根目录；Git 命令在 `/Users/ar/Projects/Aligner/03-O` 下执行。 +- 本目录不是 Git 根目录；Git 命令在 `/Users/ar/Projects/Aligner2/03-O` 下执行。 - App 名：`Aligner`。 - Bundle ID：`com.ar.Aligner`。 -- 最低 macOS：`26.0`。 +- 最低 macOS：`14.0`。 - 当前产品入口：只有 `quickSwitch`。 - 默认 Quick Switch 快捷键：`Option+Tab`。 ## 读取顺序 -1. `/Users/ar/Projects/Aligner/AGENTS.md` -2. `/Users/ar/Projects/Aligner/PROJECT.md` -3. `/Users/ar/Projects/Aligner/GLOSSARY.md` -4. `/Users/ar/Projects/Aligner/03-O/README.md` -5. 当前任务相关的 Round / 架构文档 -6. UI 修改时读 `/Users/ar/Projects/Aligner/DESIGN.md` +1. `/Users/ar/Projects/Aligner2/AGENTS.md` +2. `/Users/ar/Projects/Aligner2/PROJECT.md` +3. `/Users/ar/Projects/Aligner2/GLOSSARY.md` +4. `/Users/ar/Projects/Aligner2/03-O/README.md` +5. `/Users/ar/Projects/Aligner2/03-O/C1.source/CODEGRAPH.md` +6. 当前任务相关的 Round / 架构文档 +7. UI 修改时读 `/Users/ar/Projects/Aligner2/DESIGN.md` ## 代码边界 @@ -36,20 +37,22 @@ - 过滤幽灵窗口和非任务系统浮层。 - 全屏 App 窗口必须可发现。 - 永远不要吞掉或阻挡 `Command+Option+Esc` Force Quit。 +- 非平凡 Quick Switch 改动前，先读 `CODEGRAPH.md` 中对应 node，再读 node 指向的源码和 QA。 +- 用户要求“冻结版本”时，必须在打 tag 前更新并校验 `CODEGRAPH.md`。 ## 验证 -从 `/Users/ar/Projects/Aligner/03-O/C1.source` 执行： +从 `/Users/ar/Projects/Aligner2/03-O/C1.source` 执行： ```bash -swift build 2>&1 | head -c 6000 -swift test 2>&1 | head -c 6000 +set -o pipefail; swift build 2>&1 | head -c 6000 +set -o pipefail; swift test 2>&1 | head -c 6000 ``` 打包时执行： ```bash -/Users/ar/Projects/Aligner/03-O/C3.tools/package-app.sh 2>&1 | head -c 6000 +set -o pipefail; /Users/ar/Projects/Aligner2/03-O/C3.tools/package-app.sh 2>&1 | head -c 6000 ``` 如果不能运行验证，说明具体原因和剩余风险。 -- Gitblit v1.9.3