ai-project-manage-cli 6.0.91 → 6.0.92

package/dist/index.js

@@ -2,6 +2,7 @@
 
 // src/index.ts
 import { Command } from "commander";
+import { AssumptionPlanSource } from "@opc/shared";
 
 // src/config.ts
 import { mkdirSync, readFileSync, writeFileSync } from "fs";
@@ -244,9 +245,6 @@ function sessionYamlPath(sessionId, apmRoot) {
 function sessionMessagesXmlPath(sessionId, apmRoot) {
   return join2(sessionDir(sessionId, apmRoot), "messages.xml");
 }
-function sessionAssumptionsJsonPath(sessionId, apmRoot) {
-  return join2(sessionDir(sessionId, apmRoot), "assumptions.json");
-}
 function documentLocalFileName(platformName) {
   const trimmed = platformName.trim();
   if (!trimmed) return "document.md";
@@ -402,13 +400,9 @@ var requestConfig = {
       method: "GET",
       path: "/cli/documents"
     }),
-    listAssumptions: defineEndpoint({
+    getDevGate: defineEndpoint({
       method: "GET",
-      path: "/cli/assumptions"
-    }),
-    markAssumptionsBackfilled: defineEndpoint({
-      method: "POST",
-      path: "/cli/assumptions/mark-backfilled"
+      path: "/cli/dev-gate"
     }),
     listAttachments: defineEndpoint(
       {
@@ -1715,13 +1709,12 @@ async function runPull(sessionId, remoteWorkdir) {
   const api = createApmApiClient(cfg);
   const workdir = remoteWorkdir === void 0 ? resolveWorkdirPath() : requireRemoteWorkdir(remoteWorkdir);
   const apmRoot = workspaceApmDir(workdir);
-  const [detail, members, documents, attachments, messages, assumptions] = await Promise.all([
+  const [detail, members, documents, attachments, messages] = await Promise.all([
     api.cli.sessionDetail({ sessionId: trimmedId }),
     api.cli.sessionMembers({ sessionId: trimmedId }),
     api.cli.listDocuments({ sessionId: trimmedId }),
     api.cli.listAttachments({ sessionId: trimmedId }),
-    api.cli.listSessionMessages({ sessionId: trimmedId }),
-    api.cli.listAssumptions({ sessionId: trimmedId }).catch(() => null)
+    api.cli.listSessionMessages({ sessionId: trimmedId })
   ]);
   const dir = sessionDir(trimmedId, apmRoot);
   const docsDir = sessionDocsDir(trimmedId, apmRoot);
@@ -1767,20 +1760,6 @@ async function runPull(sessionId, remoteWorkdir) {
     formatSessionMessagesXml(trimmedId, messages),
     "utf8"
   );
-  writeFileSync9(
-    sessionAssumptionsJsonPath(trimmedId, apmRoot),
-    JSON.stringify(
-      assumptions ?? {
-        sessionId: trimmedId,
-        clearedAt: null,
-        backfilledAt: null,
-        assumptions: []
-      },
-      null,
-      2
-    ),
-    "utf8"
-  );
   await syncSessionAttachments(cfg, trimmedId, attachments, apmRoot);
   await syncPlatformRules(cfg, trimmedId, workdir, apmRoot);
   await syncRemoteDeploymentConfig(workdir, apmRoot);
@@ -2148,10 +2127,21 @@ async function runSyncDocument(sessionId, options) {
     basename3(absPath)
   );
   console.log(`[apm] \u5DF2\u540C\u6B65\u6587\u6863: ${doc.name} (id=${doc.id})`);
+  const assumptionSync = doc.assumptionSync;
+  if (assumptionSync?.warnings?.length) {
+    for (const warning of assumptionSync.warnings) {
+      console.warn(`[apm] \u5047\u8BBE\u540C\u6B65\u544A\u8B66: ${warning}`);
+    }
+  }
+  if (assumptionSync?.applicable) {
+    console.log(
+      `[apm] \u5047\u8BBE\u89E3\u6790: \u6807\u8BB0 ${assumptionSync.markerCount} \u6761\uFF0C\u5165\u5E93 ${assumptionSync.parsedCount} \u6761\uFF08PM \u53EF\u786E\u8BA4 ${assumptionSync.okCount} \u6761\uFF09`
+    );
+  }
 }
 
-// src/commands/assumptions.ts
-async function runAssumptionsList(sessionId) {
+// src/commands/dev-gate.ts
+async function runDevGate(sessionId, source) {
   const trimmedId = sessionId.trim();
   if (!trimmedId) {
     console.error("[apm] sessionId \u4E0D\u80FD\u4E3A\u7A7A");
@@ -2159,19 +2149,14 @@ async function runAssumptionsList(sessionId) {
   }
   const cfg = await ensureLoggedConfig();
   const api = createApmApiClient(cfg);
-  const data = await api.cli.listAssumptions({ sessionId: trimmedId });
-  console.log(JSON.stringify(data, null, 2));
-}
-async function runAssumptionsMarkBackfilled(sessionId) {
-  const trimmedId = sessionId.trim();
-  if (!trimmedId) {
-    console.error("[apm] sessionId \u4E0D\u80FD\u4E3A\u7A7A");
+  const status = await api.cli.getDevGate({
+    sessionId: trimmedId,
+    source
+  });
+  console.log(JSON.stringify(status, null, 2));
+  if (!status.readyForDev) {
     process.exit(1);
   }
-  const cfg = await ensureLoggedConfig();
-  const api = createApmApiClient(cfg);
-  await api.cli.markAssumptionsBackfilled({ sessionId: trimmedId });
-  console.log(`[apm] \u5DF2\u6807\u8BB0\u5047\u8BBE\u56DE\u586B\u5B8C\u6210: sessionId=${trimmedId}`);
 }
 
 // src/commands/append-message.ts
@@ -7021,12 +7006,16 @@ function buildProgram() {
   ).argument("<sessionId>", "\u6C9F\u901A\u7FA4 ID").action(async (sessionId) => {
     await runPull(sessionId);
   });
-  program.command("assumptions").description("\u5047\u8BBE\u786E\u8BA4\uFF1A\u5217\u51FA\u6216\u6807\u8BB0\u56DE\u586B\u5B8C\u6210").argument("<sessionId>", "\u6C9F\u901A\u7FA4 ID").option("--mark-backfilled", "\u6807\u8BB0\u5047\u8BBE\u5DF2\u5199\u56DE\u8BA1\u5212").action(async (sessionId, opts) => {
-    if (opts.markBackfilled) {
-      await runAssumptionsMarkBackfilled(sessionId);
-      return;
-    }
-    await runAssumptionsList(sessionId);
+  program.command("dev-gate").description("\u67E5\u8BE2\u672C\u7AEF\u5F00\u53D1\u95E8\u7981\u72B6\u6001\uFF08\u5047\u8BBE\u786E\u8BA4 + \u9700\u6C42\u7406\u89E3\u786E\u8BA4\uFF09").argument("<sessionId>", "\u6C9F\u901A\u7FA4 ID").requiredOption(
+    "--source <source>",
+    "FRONTEND_PLAN \u6216 BACKEND_PLAN"
+  ).action(async (sessionId, opts) => {
+    const source = opts.source === "BACKEND_PLAN" ? AssumptionPlanSource.BACKEND_PLAN : AssumptionPlanSource.FRONTEND_PLAN;
+    await runDevGate(sessionId, source);
+  });
+  program.command("assumptions").description("\uFF08\u5DF2\u5E9F\u5F03\uFF09\u8BF7\u4F7F\u7528 dev-gate").argument("<sessionId>", "\u6C9F\u901A\u7FA4 ID").action(async () => {
+    console.error("[apm] assumptions \u547D\u4EE4\u5DF2\u5E9F\u5F03\uFF0C\u8BF7\u4F7F\u7528: apm dev-gate <sessionId> --source FRONTEND_PLAN|BACKEND_PLAN");
+    process.exit(1);
   });
   program.command("sync-document").description("\u5C06\u672C\u5730 Markdown \u8986\u76D6\u5F0F upsert \u5230\u5E73\u53F0\u4EFB\u52A1\u6587\u6863").argument("<sessionId>", "\u6C9F\u901A\u7FA4 ID").requiredOption(
     "--file <name>",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-project-manage-cli",
-  "version": "6.0.91",
+  "version": "6.0.92",
   "description": "命令行工具：后续用于调用平台后端 API 完成运维与自动化操作",
   "type": "module",
   "private": false,

package/template/collaboration-prompt.md

@@ -1,23 +1,27 @@
 ### 阶段 1：实现计划（前后端可同轮并行）
 
-前端、后端工程师各自按技能 `apm-write-plan` 执行：先判断本需求是否涉及本端，不涉及则回复「与本端无关」并说明理由；涉及则直接基于需求原文编写实现计划（后端 `BACKEND-PLAN.md` 含「API 契约」，前端 `FRONTEND-PLAN.md`），计划必须包含「依据与假设」与「改动文件白名单」。**禁止改代码。**
-计划存在「假设」时 @ 项目经理逐条确认，然后进入阶段 1.5；计划无假设时直接进入阶段 2。
+前端、后端工程师各自按技能 `apm-write-plan` 执行：先判断本需求是否涉及本端；涉及则编写 `*-PLAN.md` + `*-ASSUMPTIONS.md`（计划不含假设章节）。**禁止改代码。**
+有假设时 @ 项目经理在 Web「待您确认」点选；无假设时直接发送「本端需求理解」@ 项目经理。
 
-### 阶段 2：假设回填（项目经理回复假设后，单人或多人按需）
+### 阶段 1.5：假设确认后更新计划（有假设时）
 
-项目经理回复假设确认后，必须安排对应工程师按技能 `apm-write-plan` 步骤 5 执行假设回填：阅读聊天记录中项目经理的回复，把确认的假设移入计划「依据」、被否定的按新口径修订实现步骤与白名单，重新同步计划并逐条回复处理结果。回填完成（假设清零）后才进入阶段 2；**禁止跳过本阶段直接安排开发**。计划无假设时跳过本阶段。
+PM 在 Web 确认假设后，相关工程师按 `apm-update-plan`：`apm pull` → 读 ASSUMPTIONS → 更新 PLAN → 发送需求理解 @ 项目经理。
+
+### 阶段 2：需求理解确认
+
+项目经理在聊天回复固定话术：**「理解正确，可进入开发」**（可指定「前端」「后端」）。确认后各端 `apm dev-gate` 应为 `readyForDev: true`。
 
 ### 阶段 3：需求开发（前后端可同轮并行）
 
-前后端工程师按技能 `apm-dev` 各自开发：只允许改动本端计划「改动文件白名单」内的文件；前端接口对接以后端计划的「API 契约」为准。完成标准 = 构建通过 + 回复中逐文件对账白名单。**禁止自行部署。** **不安排联调。**完成后进入阶段 4。
+前后端工程师按技能 `apm-dev` 各自开发：只允许改动本端计划「改动文件白名单」内的文件。完成标准 = 构建通过 + 回复中逐文件对账白名单。**禁止自行部署。**完成后进入阶段 4。
 
 ### 阶段 4：diff 评审（单人）
 
-评审工程师按技能 `apm-diff-review` 执行：检查 git 改动是否越出白名单、是否夹带与需求无关的修改、计划关键点是否落实。不通过：列出问题清单 @ 对应工程师，回到阶段 3 修复，同一任务最多打回 3 次，超过则 @ 项目经理决策；通过：@ 项目经理交人验收（部署与回归验收由人工或平台完成）。
+评审工程师按技能 `apm-diff-review` 执行：检查 git 改动是否越出白名单、是否夹带与需求无关的修改、计划关键点是否落实。不通过：列出问题清单 @ 对应工程师，回到阶段 3 修复；通过：@ 项目经理交人验收。
 
 ### 阶段 5：需求验收
 
-项目经理验证并给出结论。全部通过则任务完成；某条不通过时回复「第 N 条不通过，实际现象：xxx」，由对应工程师回到阶段 3 修复该条，修复后重新走阶段 4 评审再重验。
+项目经理验证并给出结论。全部通过则任务完成；某条不通过时回复「第 N 条不通过，实际现象：xxx」，由对应工程师回到阶段 3 修复。
 
 ### BUG 修复流程
 

package/template/skills/apm-confirm-assumptions/SKILL.md

@@ -1,21 +1,3 @@
-# apm-confirm-assumptions：按 PM 确认结果回填计划
+# apm-confirm-assumptions（已废弃）
 
-## 何时使用
-
-收到项目经理会话消息「已回复所有假设，可以继续后面的流程」后；或 `assumptions.json` 中 `clearedAt` 有值且 `backfilledAt` 为空。
-
-## 工作流程
-
-1. **Read** `.apm/sessions/<会话ID>/assumptions.json`；不存在或 `backfilledAt` 已有 → 退出。
-2. **Read** 本 Skill；过滤 **本端** 条目（后端只看 `BACKEND_PLAN`，前端只看 `FRONTEND_PLAN`）。
-3. **Read** 本端计划：`docs/BACKEND-PLAN.md` 或 `docs/FRONTEND-PLAN.md`。
-4. 逐条按 `resolution` 更新计划：
-   - 移入「依据」表，来源写「项目经理确认」；
-   - 从「假设」章节删除该题；
-   - `customAnswer` 或影响实现范围时 → 修订「实现步骤 / 改动文件白名单」；后端涉及接口则同步 `docs/API.md`。
-5. **`apm sync-document`** 同步计划（及 API 文档）。
-6. **Read/Update** `TODO.md`：勾选「等待项目经理确认假设」等相关项。
-7. **`append_message`**：摘要回填结果；声明「假设已清零，可进入测试要点编写」。
-8. 执行 **`apm assumptions <会话ID> --mark-backfilled`**。
-
-**禁止**从 `messages.xml` 解析 PM 对假设的回复——只认 `assumptions.json`。
+本技能已更名为 **`apm-update-plan`**。请 **Read** `.apm/skills/apm-update-plan/SKILL.md`。

package/template/skills/apm-dev/SKILL.md

@@ -6,11 +6,12 @@
 
 1. 用 **Read** 工具阅读本端计划：前端读 `.apm/sessions/<会话ID>/docs/FRONTEND-PLAN.md`，后端读 `docs/BACKEND-PLAN.md`；计划不存在则退出流程并回复说明（兼容旧流程：若存在 `PRD.md` + `FRONTEND.md` / `BACKEND.md` + `API.md`，按旧文档执行）。
 2. 前端涉及接口对接时，以 `docs/API.md` 为唯一契约来源，**不等后端部署完成**；`API.md` 不存在或字段没写清时 `@后端` 补充，禁止自行猜测或在计划中重复编写接口定义。
-3. **假设门禁（开发前必须检查）**：
-   - **Read** `.apm/sessions/<会话ID>/assumptions.json`；
-   - 有 `PENDING` 且 `quality=OK` → `@项目经理` 请其在 Web「待您确认」Panel 提交，**停止开发**；
-   - `clearedAt` 有值但 `backfilledAt` 为空 → 执行 **`apm-confirm-assumptions`**（或 `@` 本端自行回填），**停止开发**；
-   - 计划「假设」章节仍有未清空项 → 同上，停止开发。
+3. **开发门禁（开发前必须检查）**：
+   - 执行 **`apm dev-gate <会话ID> --source FRONTEND_PLAN`**（后端用 `BACKEND_PLAN`）；
+   - `pendingAssumptions > 0` → `@项目经理` 请其在 Web「待您确认」Panel 提交，**停止开发**；
+   - `!assumptionsCleared` 且有假设 → **停止开发**；
+   - `!understandingConfirmed` → `@项目经理` 请其在聊天回复「理解正确，可进入开发」，**停止开发**；
+   - `readyForDev === true` → 可继续。
      **禁止**从 `messages.xml` 解析 PM 假设回复。
 
 ### 步骤 2: 明确开发模式
@@ -57,24 +58,6 @@
 - 执行环境说明（测试/生产是否一致、是否需人工执行）
 - 回滚方案（如适用；回滚 SQL 同样用 ` ```sql ` 代码块，须完整可执行，禁止省略）
 
-示例：
-
-````markdown
-## 目标数据库
-
-`oxc_platform`（MySQL 8.x）
-
-## 变更摘要
-
-为 inspection_class 表新增 is_project_add 字段。
-
-## 执行 SQL
-
-```sql
-ALTER TABLE inspection_class ADD COLUMN is_project_add VARCHAR(1) DEFAULT '0';
-```
-````
-
 `BACKEND-PLAN.md` 中不写大段 SQL，只可在实现步骤中注明「须产出 SQL.md」。若会话 `docs/` 下已有 `SQL.md`，在其上追加本次变更，勿另建其他 SQL 文档。
 
 ### 步骤 5: 提交并 push 代码，保证工作区干净

package/template/skills/apm-rewrite-assumptions/SKILL.md

@@ -2,11 +2,11 @@
 
 ## 何时使用
 
-`apm sync-document` 后平台标记假设 `quality=NEEDS_REWRITE`，或计划被退回需重写「问 / 场景 / 选项」。
+`apm sync-document` 同步 ASSUMPTIONS 失败（问法校验不通过），或计划被退回需重写「问 / 场景 / 选项」。
 
 ## 工作流程
 
-1. **Read** 本端计划文档的「假设」章节与 `qualityIssues`（若有 assumptions.json 中的 technicalNote）。
+1. **Read** 本端 `docs/FRONTEND-ASSUMPTIONS.md` 或 `docs/BACKEND-ASSUMPTIONS.md`（及 sync 报错中的 qualityIssues）。
 2. 将研发术语移入 **研发备注**；**问** 改为 PM 可理解的业务句子；补全 **场景** 与 **≥2 个选项**（含 id + label）。
 3. **禁止多选**；复合口径说明写在 Other 指引中。
-4. 重新 **`apm sync-document`** 同步计划。
+4. 重新 **`apm sync-document --file *-ASSUMPTIONS.md`** 同步。

package/template/skills/apm-update-plan/SKILL.md

@@ -0,0 +1,26 @@
+# apm-update-plan：按 PM 确认结果更新计划
+
+## 何时使用
+
+收到沟通群消息「假设已全部确认。请相关工程师：」后。
+
+## 工作流程
+
+1. **`apm pull`** 拉取最新文档（含 ASSUMPTIONS 确认结果）。
+2. **Read** 本端 `docs/FRONTEND-ASSUMPTIONS.md` 或 `docs/BACKEND-ASSUMPTIONS.md`（**禁止**读 assumptions.json）。
+3. **Read** 本端 PLAN：`docs/FRONTEND-PLAN.md` 或 `docs/BACKEND-PLAN.md`。
+4. 逐条按 ASSUMPTIONS 中「确认结果」更新 PLAN：
+   - 移入「依据」表，来源写「项目经理确认」；
+   - 影响实现范围时 → 修订「实现步骤 / 改动文件白名单」；后端涉及接口则同步 `docs/API.md`。
+5. 重写 PLAN §1「需求理解」（融合 PM 确认口径）。
+6. **`apm sync-document`** 同步 PLAN（及 API 文档）。
+7. **`append_message`**：本端需求理解摘要 + @项目经理，请其回复「理解正确，可进入开发」。
+8. **Read/Update** `TODO.md`：勾选相关待办。
+
+**禁止** `apm assumptions --mark-backfilled`（已废弃）。
+
+**禁止**从 `messages.xml` 解析 PM 对假设的回复——只认 ASSUMPTIONS 文档中的确认结果。
+
+## 何时使用
+
+协作流程阶段 1.5（假设确认后更新计划）。

package/template/skills/apm-write-checklist/SKILL.md

@@ -20,7 +20,7 @@
 逐条对照需求原文与计划：
 
 - **计划与需求矛盾、或需求关键点在计划中没有覆盖**：不要写清单，先用 `append_message` 指出问题并 `@` 对应工程师打回，等计划修订后再写。
-- **计划中的「假设」尚未确认或尚未回填计划**（查 `assumptions.json`：`PENDING` 或 `clearedAt && !backfilledAt`）：**不要写清单**，先提醒 PM / 执行 `apm-confirm-assumptions`。
+- **开发门禁未通过**（`apm dev-gate` 返回 `readyForDev: false`）：**不要写清单**，先提醒 PM / 执行 `apm-update-plan`。
 - 计划覆盖完整：进入步骤 3。
 
 ### 步骤 3：按模板写清单

package/template/skills/apm-write-plan/SKILL.md

@@ -7,7 +7,8 @@
 | 角色 | 产出文档 | 路径 |
 | ---- | -------- | ---- |
 | 后端 | `BACKEND-PLAN.md` + `API.md` | `docs/BACKEND-PLAN.md`、`docs/API.md` |
-| 前端 | `FRONTEND-PLAN.md` | `docs/FRONTEND-PLAN.md` |
+| 前端 | `FRONTEND-PLAN.md` + `FRONTEND-ASSUMPTIONS.md` | `docs/FRONTEND-PLAN.md`、`docs/FRONTEND-ASSUMPTIONS.md` |
+| 后端 | 同上 | `docs/BACKEND-ASSUMPTIONS.md` |
 
 ---
 
@@ -24,11 +25,13 @@
 
 1. 优先读 `docs/` 现成结论。
 2. 代码调研预算：**最多 15 个文件**。
-3. 口径不清 → 记入「假设」章节，禁止编造。
+3. 口径不清 → 记入 **ASSUMPTIONS 文件**，禁止编造。
 
-### 步骤 3：按模板写计划
+### 步骤 3：按模板写计划与假设
 
-**Read** `.apm/skills/apm-write-plan/plan-template.md`，**Write** 计划文档。
+1. **Read** `.apm/skills/apm-write-plan/plan-template.md`，**Write** 本端 `*-PLAN.md`（**不含**假设章节）。
+2. **Read** `.apm/skills/apm-write-plan/assumptions-template.md`，**Write** 本端 `*-ASSUMPTIONS.md`。
+3. 无假设时在 ASSUMPTIONS 中写「无，口径均有依据」。
 
 ### 步骤 3.5：假设 PM 友好自检（sync 前必做）
 
@@ -36,18 +39,19 @@
 
 - **问** 禁止：`status=`、字段名、表名、类路径、SQL。
 - **禁止多选**；复合口径由 PM 在 Web「其他」中填写。
-- 能自己查清的代码含义 → 移入「依据」，删除假设。
+- 能自己查清的代码含义 → 移入 PLAN「依据」，删除假设。
 - 技术发现 → 写进 **研发备注**，问句用业务语言。
 
 ### 步骤 4：同步与回复
 
-1. `apm sync-document` 同步计划（及 API 文档）。
-2. **有假设**：`@项目经理` 请其在 Web **「待您确认」** Panel 点选；说明「以上假设确认前不开始开发」。**禁止**在聊天里粘贴研发术语。
-3. **无假设**：回复计划已就绪，可进入测试要点编写。
+1. `apm sync-document --file FRONTEND-ASSUMPTIONS.md`（或 BACKEND）**先于** PLAN。
+2. `apm sync-document --file FRONTEND-PLAN.md`（或 BACKEND）。
+3. **有假设**：@项目经理 请其在 Web **「待您确认」** Panel 点选；说明「以上假设确认前不开始开发」。
+4. **无假设**：`append_message` 发送「本端需求理解」摘要并 @项目经理 请确认。
 
-### 假设回填
+### 假设确认后更新计划
 
-项目经理确认后由 **`apm-confirm-assumptions`** 技能执行（读 `assumptions.json`，**禁止**读 messages.xml 猜 PM 回复）。
+项目经理在 Web 确认假设后，执行 **`apm-update-plan`** 技能（读 ASSUMPTIONS.md，**禁止**读 assumptions.json）。
 
 ---
 

package/template/skills/apm-write-plan/assumptions-template.md

@@ -0,0 +1,16 @@
+# 前端待确认口径
+
+> 本文件由 apm sync-document 写入；PM 确认后服务端回写「状态/确认结果」。
+> **禁止**手动编辑；已确认条目 AI 禁止修改。
+
+#### A1
+- **问**：（业务语言问句，禁止字段名/文件路径）
+- **场景**：（需求未说明的背景）
+- **选项**：
+  - opt_a：（选项说明）
+  - opt_b：（选项说明）
+- **研发备注**：（仅研发可见的技术说明，可选）
+- **状态**：待确认
+- **确认结果**：
+
+> 无假设时正文仅一行：无，口径均有依据。

package/template/skills/apm-write-plan/plan-template.md

@@ -1,7 +1,8 @@
 # 计划文档模板
 
 > 后端写 `docs/BACKEND-PLAN.md` + `docs/API.md`（两份文档禁止合并）。
-> 前端写 `docs/FRONTEND-PLAN.md`；接口细节只读 `docs/API.md`，禁止在计划中重复抄写。
+> 前端写 `docs/FRONTEND-PLAN.md` + `docs/FRONTEND-ASSUMPTIONS.md`。
+> 假设写在独立的 `*-ASSUMPTIONS.md`，计划内仅保留摘要与链接。
 
 ## 后端计划（BACKEND-PLAN.md）
 
@@ -12,94 +13,60 @@
 
 用 3 ～ 5 行复述本端要做什么（产品语言），不复制需求原文。
 
-## 2. 依据与假设
+## 2. 依据与待确认口径
 
 ### 依据（口径 + 来源）
 
 | #   | 口径                           | 来源                          |
 | --- | ------------------------------ | ----------------------------- |
 | 1   | 「是否加分」与「是否扣分」互斥 | 需求原文第 1 条               |
-| 2   | 加分项不汇总进分类分值         | 需求原文第 2 条               |
-| 3   | 分值字段现状为 varchar         | 代码现状：inspection_class 表 |
 
-### 假设（待项目经理确认，确认前不开发）
+### 待确认口径
 
-#### A1
-- **问**（prompt）：审批被驳回后，申请人能否修改并重新提交？
-- **场景**：需求写了审批流程，未说明驳回后的操作
-- **选项**：
-  - opt_resubmit：允许修改后重新提交
-  - opt_new：不允许，需新建申请
-- **研发备注**：代码 `inspection_flow.status=5` 表示 REJECTED（仅研发可见）
+本端有 **N** 项待项目经理确认，详见 [BACKEND-ASSUMPTIONS.md](./BACKEND-ASSUMPTIONS.md)。确认前不开始开发。
 
-> PM 若需表达复合口径，在 Web Panel 选 **「其他」** 并文字说明。
+> N 与链接由 sync ASSUMPTIONS 时服务端自动更新，AI 不写具体数字。
 
 ## 3. 实现步骤
 
 1. 第一步做什么（对应哪条口径）
-2. 第二步做什么
-3. ...（通常 3 ～ 6 步，不写代码细节）
-
-> 若涉及表结构或数据变更，在步骤中注明「开发须产出 `docs/SQL.md`」，SQL 语句不写在本计划内。
-> 若涉及接口变更，在步骤中注明「须同步产出 `docs/API.md`」，接口参数表不写在本计划内。
+2. ...
 
 ## 4. 改动文件白名单
 
-> 开发只允许改这些文件；diff 评审会逐一对账，越界会被打回。
-> 开发中确需新增，先更新本清单并在群里说明原因。
-
-- `src/.../InspectionProjectController.java` — 新增保存入参校验
-- `src/.../InspectionProjectService.java` — 互斥逻辑
-- ...
+- `src/.../Foo.java` — 说明
 ```
 
 ## 前端计划（FRONTEND-PLAN.md）
 
-> 写计划前必须先 **Read** `docs/API.md`；不存在则退出并 `@后端`，禁止自行编造接口或写「期望接口」。
-
 ```markdown
 # <需求名> · 前端实现计划
 
 ## 1. 需求理解
 
-用 3 ～ 5 行复述本端要做什么（产品语言），不复制需求原文。
+用 3 ～ 5 行复述本端要做什么（产品语言）。
 
-## 2. 依据与假设
+## 2. 依据与待确认口径
 
 ### 依据（口径 + 来源）
 
-| #   | 口径                           | 来源            |
-| --- | ------------------------------ | --------------- |
-| 1   | 「是否加分」与「是否扣分」互斥 | 需求原文第 1 条 |
-| 2   | 加分项不汇总进分类分值         | 需求原文第 2 条 |
+| #   | 口径 | 来源 |
+| --- | ---- | ---- |
+| 1   | …    | …    |
 
-### 假设（待项目经理确认，确认前不开发）
+### 待确认口径
 
-#### A1
-- **问**（prompt）：…
-- **场景**：…
-- **选项**：
-  - opt_a：…
-  - opt_b：…
-
-> 无假设时写「无，口径均有依据」。
+本端有 **N** 项待项目经理确认，详见 [FRONTEND-ASSUMPTIONS.md](./FRONTEND-ASSUMPTIONS.md)。确认前不开始开发。
 
 ## 3. 实现步骤
 
-1. 第一步做什么（对应哪条口径）
-2. 第二步做什么
-3. 对接 `API.md` 中的某某接口（只写调用时机，不复制参数表）
-4. ...
+1. ...
 
 ## 4. 改动文件白名单
 
-- `src/views/inspection/InspectionProjectForm.vue` — 新增「是否加分」单选与互斥逻辑
-- `src/api/inspection.ts` — 新增字段透传
-- ...
+- `src/.../Foo.vue` — 说明
 
 ## 5. 接口对接要点（引用 API.md，禁止复制）
 
-- 列表：<何时请求、首屏传什么>（见 `API.md` § xxx）
-- 详情：<选中后怎么走>（见 `API.md` § xxx）
-- 注意：<禁止用列表数据代替详情等>
+- ...
 ```