multi-project-file-guard

多项目同名文件防混淆规则（multi-project-file-guard）

根本问题：同一个 workspace 下有多个项目，每个项目都有 技术架构.md、产品定义.md、DEPLOY_ARCH.md、开发计划.md 等同名文件。 凭文件名搜索、凭 IDE 打开文件推断、凭「应该在这里」的直觉去操作，都会导致操作到错误项目的文件。

---

已知高风险重名文件清单（当前 workspace）

DEPLOY_ARCH.md        → scholar-match / tashan-openbrain_myagent / tashan-world / _worktree_boyuan
技术架构.md / 技术架构_*.md → tashan-openbrain_myagent / tashan-world / ai-org-builder 等
产品定义.md           → tashan-openbrain_myagent / tashan-world 等
开发计划.md           → tashan-openbrain_myagent / tashan-world 等
开发规范.md           → tashan-world / scholar-match 等

每次触碰以上任何文件时，必须先走「项目上下文锁定」流程。

---

触发条件

以下任一情况发生时，本规则强制生效：

• AI 准备 Read / StrReplace / Write 一个项目级文档（技术架构/产品定义/部署架构/开发规范等）
• 用户说「更新技术架构」「看一下部署配置」「修改开发计划」等，但没有指定完整路径
• AI 的上下文中涉及多个项目，不能确定「当前是在操作哪个项目」
• AI 通过 Glob/Grep 搜到多个同名文件

---

强制执行流程

Step 1 — 项目上下文锁定

在操作任何文件之前，必须先声明当前项目上下文：

【当前操作项目】：项目群/[项目名]/
【操作文件路径】：[完整绝对路径]
【确认依据】：[用户明确说明 / 对话上下文推断 / IDE 打开文件]

• 依据来自「用户明确说明」→ 直接执行
• 依据来自「对话上下文推断」→ 声明后询问用户确认，确认后再操作
• 依据来自「IDE 打开文件」→ 必须向用户确认（强制规则11：IDE状态不得劫持意图）
• 无法确定 → 向用户列出候选项，等待选择，不可猜测

Step 2 — 路径精确化

禁止使用模糊路径：

❌ 禁止：Read 技术架构.md
❌ 禁止：StrReplace 技术架构.md
❌ 禁止：「更新技术架构里的XXX」（不带完整路径）

✅ 必须：Read t:\TashanAgent4S_2026\0310_huaxiang\项目群\tashan-world\技术架构师\技术架构.md
✅ 必须：所有文件操作工具调用都包含完整绝对路径

如果之前在对话中已经声明了路径，后续操作可引用已确认路径，但不得「默默切换」到不同项目的文件。

Step 3 — 内容读取前，不允许输出分析结论

规则 R3 READ_FIRST 的多项目强化版：

❌ 禁止：未 Read 文件就输出「技术架构里面XXX是这样设计的」
❌ 禁止：基于另一个项目的文件内容去描述当前项目的架构
❌ 禁止：「这两个项目应该差不多」的假设

✅ 必须：Read 目标文件 → 解析内容 → 再分析/引用/修改

Step 4 — 跨文件引用时，验证概念逻辑自洽

当修改一个文件中的概念/设计决策时，需同时确认：

检查清单（仅当修改设计级内容时执行，不适用于纯格式修改）：
□ 本文件引用了哪些其他文件的概念？（如技术架构引用产品定义中的角色/功能）
□ 被引用的概念在源文件中是否一致？（不允许概念在两个文件中有不同的定义）
□ 本次修改是否造成跨文件的不一致？（如修改了接口名称，是否同步到引用文件）
□ 所有外部引用是否都指向同一项目的文件？（不得跨项目混引）

如果发现跨文件不一致 → 在修改前告知用户，由用户决策是否同步修改。

---

禁止行为清单（一票否决）

❌ 凭文件名直接搜索并操作第一个结果（不看路径）
❌ 因为 IDE 当前打开了某文件就默认「用户在操作这个项目」（见强制规则11）
❌ 把 A 项目的架构设计内容写入 B 项目的文档
❌ 在不确定当前项目的情况下，自行决定路径
❌ 跨项目复用概念定义而不声明差异（「和上个项目一样」≠「不需要确认」）