From ec3ae342fcdfd6eab3be14693e718b93ef6394e1 Mon Sep 17 00:00:00 2001
From: Yuuuu <1569752928@qq.com>
Date: Fri, 2 Oct 2026 17:58:32 +0800
Subject: [PATCH] docs: distinguish tracked vs untracked files in layout spec

---
 .../specs/2026-10-02-repo-layout-design.md    | 32 +++++++++++++++----
 1 file changed, 25 insertions(+), 7 deletions(-)

diff --git a/docs/superpowers/specs/2026-10-02-repo-layout-design.md b/docs/superpowers/specs/2026-10-02-repo-layout-design.md
index bff87ae..a3aae71 100644
--- a/docs/superpowers/specs/2026-10-02-repo-layout-design.md
+++ b/docs/superpowers/specs/2026-10-02-repo-layout-design.md
@@ -153,32 +153,46 @@ default = true
 
 `docs/` 已有 `superpowers/`。不要新建第二套文档根。`资料/` 拆开并入后删除空目录。
 
+已跟踪的用 `git mv`；未跟踪的用普通 `mv`，改完再 `git add`。不要对未跟踪文件跑 `git mv`。
+
+仓库根 `README.md` 当前未跟踪。本轮按第 5.3 节写好后 `git add README.md`。
+
+`选品流程/output/结果/.gitkeep` 已跟踪，随父目录 `git mv` 进入 `rpa_selection/output/结果/.gitkeep`。目录名保持 `结果`。
+
 ### 6.1 现行（`docs/` 根下）
 
+已跟踪（`git mv`）：
+
+| 来源 | 去向 |
+| --- | --- |
+| `资料/RPA订单中心接口开发口径_20260930.md` | `docs/` 同名 |
+| `资料/采购平台选品条件优先项_20260902.txt` | `docs/` 同名 |
+
+未跟踪（`mv` + `git add`）：
+
 | 来源 | 去向 |
 | --- | --- |
 | `资料/README.md` | `docs/README.md`（重写路径，去掉「路径先不动」） |
-| `资料/RPA订单中心接口开发口径_20260930.md` | `docs/` 同名 |
 | `资料/RPA订单中心接口口径讨论纪要_20260929.md` | `docs/` 同名 |
 | `资料/ddl/` | `docs/ddl/` |
 | `资料/API鉴权.doc` | `docs/` |
 | `资料/下一会话任务_建表.md` | `docs/` |
 | `资料/合同系统录入流程.md` | `docs/` |
 | `资料/合同返利系统字段映射_20260911.xlsx` | `docs/` |
-| `资料/采购平台选品条件优先项_20260902.txt` | `docs/` |
 | `资料/【项目方案】福建洁达采购合同RPA自动化录入需求_v20260924.docx` | `docs/` |
 
 口径正文里的 `` `资料/...` `` 改成 `` `docs/...` ``；`` `选品流程/` `` 改成 `` `rpa_selection/` ``。`合同系统录入流程.md` 里指向 `rpa_yisaiqi` 的句子保留。
 
 ### 6.2 归档（`docs/archive/`）
 
-一期 13 节点主链，以及未列入现行表的旧设计说明：
+一期 13 节点主链，以及未列入现行表的旧设计说明。
+
+已跟踪（`git mv` 进 `docs/archive/`）：
 
 - `PLAN.md`
 - `一期开发任务清单_表结构_API草案.md`
 - `一期需求简版说明_业务版.md`
 - `界面截图证据记录.md`
-- `福建洁达采购合同自动化设计说明.md`
 - `采购业务RPA思路20260625.docx`
 - `采购主链RPA一期实施与验收规范.md`
 - `采购主链RPA一期开发规划.md`
@@ -186,6 +200,10 @@ default = true
 - `采购主链RPA一期需求文档_三方会审版.md`
 - `采购主链RPA一期需求文档_会议整理版.md`
 
+未跟踪（`mv` + `git add` 进 `docs/archive/`）：
+
+- `福建洁达采购合同自动化设计说明.md`
+
 这些文件内部的 `资料/` 链接不改。`docs/README.md` 的历史节指向 `docs/archive/`，并保留原警告：那套模型是「一单合同走状态机」，不要用来解释接口 1 收件箱。
 
 ### 6.3 必须改路径的现行文件
@@ -249,8 +267,8 @@ cd rpa_selection && uv run pytest -v
 ## 9. 实施顺序
 
 1. `git mv 选品流程 rpa_selection`，改该包 `pyproject.toml` 与 README
-2. 建三个占位包
-3. 把 `资料/` 按第 6 节拆进 `docs/` 与 `docs/archive/`，重写 `docs/README.md`
-4. 改根 README、`rpa_oms/README.md`、`rpa_yisaiqi/README.md`、`.gitignore`、搬过来的现行口径
+2. 建三个占位包并 `git add`
+3. 按第 6 节：已跟踪文件 `git mv`，未跟踪文件 `mv` 后 `git add`；重写 `docs/README.md`
+4. 写根 `README.md` 并 `git add`（该文件当前未跟踪）；改 `rpa_oms/README.md`、`rpa_yisaiqi/README.md`、`.gitignore`、搬过来的现行口径
 5. 跑第 8 节两条 pytest
 6. 确认根上没有 `选品流程/`、`资料/`