@ifrankwang/openspec-agents 0.138.0 → 0.140.0

package/.mcp-server/cli.mjs

@@ -22211,7 +22211,7 @@ function isTaskGroupSettled(item) {
   return noTags && childrenSettled;
 }
 function isFinalTaskGroup(state, item) {
-  return state.workItems.filter((w) => w.id.startsWith("task:") && w.id !== item.id).every(isTaskGroupSettled);
+  return state.workItems.filter((w) => w.id.startsWith("task:") && w.id !== item.id).every((w) => isTerminalPhase(w.phase) || w.metadata["completed_at"] !== undefined);
 }
 function isBlockingSeverity(severity) {
   return severity !== undefined && BLOCKING_SEVERITIES.includes(severity);
@@ -27373,9 +27373,9 @@ function renderTerminalPhase(item, state, caller) {
       "",
       `- **完成时间**: ${item.metadata["completed_at"]}`,
       "",
-      finalGroup ? "本任务组为最后一个收口任务组，change 收口已完成：变更分支已合并回基准分支，编排已完成并收尾。" : "本任务组已完成，变更保留在 change 分支上，待全部任务组完成后统一收口合并。",
+      finalGroup ? "本任务组为最后一个收口任务组，change 收口已完成：变更分支已合并回基准分支，编排已完成并收尾。" : `本任务组已完成，变更保留在 change 分支上，待全部任务组完成后统一收口合并。${cancelTaskGroupNote(state)}`,
       "",
-      ...renderDeploymentNotesSection(state, caller)
+      ...renderDeploymentNotesSection(state, item, caller)
     ].join(`
 `);
   }
@@ -27385,16 +27385,21 @@ function renderTerminalPhase(item, state, caller) {
     "全部审核层已通过。",
     finalGroup ? "调用 `opx_orch_complete_task_group` 完成 change 收口（把变更分支合并回基准分支并清理）。" : "调用 `opx_orch_complete_task_group` 完成任务组收尾（变更保留在 change 分支，统一收口时合并）。",
     "",
-    ...renderDeploymentNotesSection(state, caller)
+    ...renderDeploymentNotesSection(state, item, caller)
   ].join(`
 `);
 }
-function renderDeploymentNotesSection(state, caller) {
+function cancelTaskGroupNote(state) {
+  if (!state)
+    return "";
+  return `若某任务组已确认不再执行，当前版本不支持取消任务组，须人工编辑编排 state 文件（openspec/states/${state.changeId}.json）将该任务组的 phase 改为 "cancelled"，收口合并才会触发。`;
+}
+function renderDeploymentNotesSection(state, item, caller) {
   if (!caller?.orchestrator || !state || state.kind === "review")
     return [];
-  const taskGroups = state.workItems.filter((w) => w.id.startsWith("task:"));
-  if (!taskGroups.every(isTaskGroupSettled))
+  if (!isFinalTaskGroup(state, item))
     return [];
+  const taskGroups = state.workItems.filter((w) => w.id.startsWith("task:"));
   const lines = [
     "## 部署注意事项汇报",
     "",
@@ -29182,7 +29187,7 @@ async function completeTaskGroupLocked(params, ctx) {
   if (!isFinalTaskGroup(state, item)) {
     item.metadata["completed_at"] = new Date().toISOString();
     await writeState(ctx.worktree, state);
-    const doneMessage = "任务组已完成。本任务组变更保留在 change 分支上，待全部任务组完成后统一收口合并（本次不合并、不销毁 worktree）。";
+    const doneMessage = `任务组已完成。本任务组变更保留在 change 分支上，待全部任务组完成后统一收口合并（本次不合并、不销毁 worktree）。若某任务组已确认不再执行，当前版本不支持取消任务组，须人工编辑编排 state 文件（openspec/states/${state.changeId}.json）将该任务组的 phase 改为 "cancelled"，收口合并才会触发。`;
     return checkboxWarning ? `${doneMessage}
 ${checkboxWarning}` : doneMessage;
   }
@@ -30424,7 +30429,7 @@ async function ensureDefaultUnattended(args, ctx) {
     }
   } catch {}
 }
-var PKG_VERSION = "0.138.0";
+var PKG_VERSION = "0.140.0";
 function buildMcpServer(worktree, opts = {}) {
   const mcp = new McpServer({ name: "openspec-agents", version: PKG_VERSION });
   for (const [name, spec] of Object.entries(TOOL_SPECS)) {

package/assets/skills/api-test/SKILL.md

@@ -100,15 +100,15 @@ API 测试脚本运行前需获取有效认证凭证。常见模式：
 ```
 1. **MUST** 启动基础设施（Docker compose 项目名带隔离标识：`docker compose -p <namespace> up -d`，避免与并发 change 的容器冲突；隔离对象不限于数据库——mock 服务、消息队列/缓存等中间件、扫描分析平台等一切为本变更启动的资源均须经隔离标识启动，禁止复用宿主既有实例或共享端口）
 2. **MUST** 准备 SQL 前置数据（写入本 change 的隔离容器内 DB）
-3. **MUST** 启动服务（端口用编排会话建议端口：`--server.port=<建议端口>`，避免并发 change 端口冲突）
+3. **MUST** 启动服务（端口用编排会话建议端口：`--server.port=<建议端口>`，避免并发 change 端口冲突），启动后记录服务进程 PID，并确认实际监听端口与会话建议端口一致；不一致视为启动失败，修正端口参数重新启动，禁止让服务落回项目默认端口
 4. API 测试脚本（BASE_URL 使用上述端口）
-5. **MUST** 停止服务并清理隔离环境（`docker compose -p <namespace> down`），随后幂等自检：本 change 隔离标识下无残留容器（`docker compose -p <namespace> ps` 为空）、建议端口无进程监听
+5. **MUST** 停止服务并清理隔离环境（`docker compose -p <namespace> down`），随后幂等自检：本 change 隔离标识下无残留容器（`docker compose -p <namespace> ps` 为空）、本变更记录的服务进程已退出且隔离端口（建议端口）无进程监听；自检中发现无法确认归属本变更的进程（工作目录不在本变更工作目录内）禁止清理，在结果中标注说明
 ```
 
 以上第 1、2、3、5 条为 MUST：隔离（独立 compose 项目名、隔离数据库、隔离 mock 服务/中间件/扫描分析平台、建议端口、down 清理）是并发安全硬约束，不适用本文件开头「项目规范优先」的推荐豁免。
 
 - SQL 在前：先准备数据，再启动应用确保应用启动时读取到完整数据
-- 隔离标识 `<namespace>` 与建议端口来自编排会话上下文
+- 隔离标识 `<namespace>`、建议端口与本变更工作目录同来自编排会话上下文
 - 隔离对象不限于数据库：除数据库外，mock 服务、消息队列/缓存等中间件、扫描分析平台等其余为本变更启动的环境资源均须按隔离标识隔离；仅隔离数据库不满足并发安全要求
 - 启动服务：按项目构建文件确定的启动方式（mvn / gradle / npm 等），端口用编排会话建议端口
 - API 脚本：BASE_URL 使用上述建议端口，依赖运行中的服务

package/assets/skills/environment-cleanup/SKILL.md

@@ -9,12 +9,19 @@ capabilities: ["cleanup"]
 
 ## 停止残留的服务实例
 
-按项目的启动方式反向停止本次变更启动的服务实例：
+停止本次变更启动的服务实例，禁止误杀其他变更或他人启动的进程：
 
-- 经进程启动的服务：定位本次启动的进程并停止（如按启动命令/端口反查 PID），禁止误杀其他变更或他人启动的进程
+- 经进程启动的服务：确认归属本变更后停止，按以下顺序判别
 - 经容器编排启动的服务：按本变更的隔离标识停止对应 compose 项目
 
-停止后确认端口监听已释放：监听端口不再有进程响应即视为已停止。
+经进程启动的服务按以下顺序确认归属：
+
+1. 优先按启动时记录的进程 PID 停止；停止前核对该 PID 对应进程的启动命令或工作目录仍属于本变更（操作系统可能复用已退出进程的 PID），确认后方可停止
+2. 无 PID 记录时，以会话分配的隔离端口（专属本变更）为唯一定位入口：隔离端口无进程占用即视为无本变更服务残留；有占用时查询该进程的工作目录，位于本变更工作目录内（来源：会话分配的隔离上下文，含隔离标识、建议端口、本变更工作目录）方可停止，不在即禁止停止
+3. 禁止按启动命令关键字全局搜索进程作为定位手段（本变更工作区与主仓库的启动命令相同，无法区分归属）
+4. 无法确认归属本变更的进程（含监听在项目默认端口上的进程）一律不停止、不干扰；目标端口被其他进程占用属于本变更启动失败，应修正端口参数重新以隔离方式启动，禁止为腾出端口而停止任何进程
+
+停止确认以被停止的进程已退出为准；端口随后被其他进程占用不构成本变更未停止（如用户或他人进程占用同一端口），不得据此二次清理。
 
 ## 清理隔离环境
 
@@ -40,7 +47,7 @@ capabilities: ["cleanup"]
 
 清理完成后自检以下各项，全部无残留即通过：
 
-- 无残留的服务进程（本次启动的进程已停止，端口监听已释放）
+- 无残留的服务进程（以本变更启动的进程已退出为准，端口被其他进程占用不构成本变更未停止）
 - 无残留的隔离容器（隔离标识下 compose ps 为空）
 - 无残留的隔离 mock 服务/中间件（按隔离标识查询不存在或容器已移除）
 - 无残留的隔离扫描分析项目（按隔离标识查询不存在）

package/assets/workflows/review-simple.yaml

@@ -43,7 +43,7 @@ phases:
           - "执行边界缺省整个 worktree（独立审查无分析环节，不生成边界白名单）；issue 的 file 字段指向的文件即修复边界，修复这些文件（含回归引入问题）不算越界；可按 issue 的 suggestion 直接执行修复；reviewer 的 boundary_expansion 已并入边界"
           - "对修复未过次数≥2 的 issue 须先完成 5-Why 根因分析再动手，不得跳过分析直接改代码"
           - "修复完成后先 git commit 再提交；提交前按已加载的质量门类 skill 完成本地构建验证，并按维度规范类 skill（style/architecture/performance/security/maintainability 能力类别）对本次修复文件逐项自检，自检结论与工具检查结果一并汇总进 self_check_results"
-          - "自证/验证需启动服务或基础设施时，一律按已加载技术栈 skill 的隔离启动规范以隔离方式启动，隔离标识与建议端口以视图 Worktree 区块为准；验证完成后停止本次启动的实例，不留残留；禁止为腾出端口或资源而停止、复用或干扰非本会话启动的进程"
+          - "自证/验证需启动服务或基础设施时，一律按已加载技术栈 skill 的隔离启动规范以隔离方式启动，隔离标识与建议端口以视图 Worktree 区块为准；验证完成后停止本次启动的实例，不留残留，残留判定遵循已加载清理规范的归属判别，无法确认归属本变更的进程一律不清；禁止为腾出端口或资源而停止、复用或干扰非本会话启动的进程"
           - "确定性质量工具检查出的问题不得以压制手段（压制注解/注释抑制/规则排除配置/平台状态标注/构建跳过开关等）静默规避：确需压制时，必须在压制处代码注释说明清楚理由，并经 exempt_issue_ids 申请豁免由报源 reviewer 裁定；不得以 fixed_issue_ids 冒充修复"
           - "提交 opx_agent_submit：必传 verdict；修复完成的 issue 经 fixed_issue_ids 上报、不可修 issue 经 exempt_issue_ids 申请豁免"
         constraints:

package/assets/workflows/review.yaml

@@ -42,7 +42,7 @@ phases:
           - "执行边界缺省整个 worktree（独立审查无分析环节，不生成边界白名单）；issue 的 file 字段指向的文件即修复边界，修复这些文件（含回归引入问题）不算越界；可按 issue 的 suggestion 直接执行修复；reviewer 的 boundary_expansion 已并入边界"
           - "对修复未过次数≥2 的 issue 须先完成 5-Why 根因分析再动手，不得跳过分析直接改代码"
           - "修复完成后先 git commit 再提交；提交前按已加载的质量门类 skill 完成本地构建验证，并按维度规范类 skill（style/architecture/performance/security/maintainability 能力类别）对本次修复文件逐项自检，自检结论与工具检查结果一并汇总进 self_check_results"
-          - "自证/验证需启动服务或基础设施时，一律按已加载技术栈 skill 的隔离启动规范以隔离方式启动，隔离标识与建议端口以视图 Worktree 区块为准；验证完成后停止本次启动的实例，不留残留；禁止为腾出端口或资源而停止、复用或干扰非本会话启动的进程"
+          - "自证/验证需启动服务或基础设施时，一律按已加载技术栈 skill 的隔离启动规范以隔离方式启动，隔离标识与建议端口以视图 Worktree 区块为准；验证完成后停止本次启动的实例，不留残留，残留判定遵循已加载清理规范的归属判别，无法确认归属本变更的进程一律不清；禁止为腾出端口或资源而停止、复用或干扰非本会话启动的进程"
           - "确定性质量工具检查出的问题不得以压制手段（压制注解/注释抑制/规则排除配置/平台状态标注/构建跳过开关等）静默规避：确需压制时，必须在压制处代码注释说明清楚理由，并经 exempt_issue_ids 申请豁免由报源 reviewer 裁定；不得以 fixed_issue_ids 冒充修复"
           - "提交 opx_agent_submit：必传 verdict；修复完成的 issue 经 fixed_issue_ids 上报、不可修 issue 经 exempt_issue_ids 申请豁免"
         constraints:

package/assets/workflows/task-simple.yaml

@@ -32,7 +32,7 @@ phases:
           - "按 Task 项顺序逐个实现，聚焦当前子任务，不超出执行边界"
           - "实施前识别 spec 描述的一并操作行为组（如状态变更与数据入队这类需同时发生的多个行为）；实施后逐项自证每个行为真实生效，禁止以单一状态字段的实现替代其他行为"
           - "涉及数据模型或流程产出变更（含字段/实体承载位置搬迁、AI 生成等流程产物）时，自证须包含关键数据产出断言：产出字段已持久化到 spec 指定承载位置且值完整非空、搬迁承接与同一输入产出基线一致（按已加载接口测试规范执行）；禁止仅以流程跑通/接口成功替代"
-          - "自证/验证需启动服务或基础设施时，一律按已加载技术栈 skill 的隔离启动规范以隔离方式启动，隔离标识与建议端口以视图 Worktree 区块为准；隔离对象不限于数据库——为本变更启动的 mock 服务、消息队列/缓存等中间件、扫描分析平台等一切环境资源均须按隔离标识隔离，禁止复用既有实例或共享端口；启动前发现隔离环境有残留时，先按已加载的清理规范幂等清空再启动"
+          - "自证/验证需启动服务或基础设施时，一律按已加载技术栈 skill 的隔离启动规范以隔离方式启动，隔离标识与建议端口以视图 Worktree 区块为准；隔离对象不限于数据库——为本变更启动的 mock 服务、消息队列/缓存等中间件、扫描分析平台等一切环境资源均须按隔离标识隔离，禁止复用既有实例或共享端口；启动前发现隔离环境有残留时，先按已加载的清理规范幂等清空再启动；残留判定遵循已加载清理规范的归属判别，无法确认归属本变更的进程一律不清"
           - "涉及接口契约或数据口径变更（按已加载的接口测试规范判定）时，实施过程中即时更新/新建与变更接口对应的 `.http` 测试脚本（已有脚本更新为匹配变更后契约，尚无脚本则新建，并同步 SQL 前置数据脚本），按已加载接口测试规范的完整执行顺序（含 SQL 前置数据准备、隔离启动基础设施与服务、执行 `.http` 脚本）执行接口测试，确保变更内容真实有效；执行结果（附执行顺序与覆盖接口清单）经 test_results 参数提交，作为审查者分级复验的事实输入；修复被驳回 issue 后再次提交前同样须执行"
           - "自证完成后停止本次启动的服务/基础设施实例，不留残留"
           - "环境/基础设施问题（schema 缺失、DDL 未执行、依赖未安装）应通过 migration/初始化脚本等代码层面解决；仅生产级凭据、真实第三方资源、人工运维才走 blocker/豁免"

package/assets/workflows/task.yaml

@@ -62,7 +62,7 @@ phases:
           - "按 Task 项顺序逐个实现，聚焦当前子任务，不超出执行边界"
           - "实施前识别 spec 描述的一并操作行为组（如状态变更与数据入队这类需同时发生的多个行为）；实施后逐项自证每个行为真实生效，禁止以单一状态字段的实现替代其他行为"
           - "涉及数据模型或流程产出变更（含字段/实体承载位置搬迁、AI 生成等流程产物）时，自证须包含关键数据产出断言：产出字段已持久化到 spec 指定承载位置且值完整非空、搬迁承接与同一输入产出基线一致（按已加载接口测试规范执行）；禁止仅以流程跑通/接口成功替代"
-          - "自证/验证需启动服务或基础设施时，一律按已加载技术栈 skill 的隔离启动规范以隔离方式启动，隔离标识与建议端口以视图 Worktree 区块为准；隔离对象不限于数据库——为本变更启动的 mock 服务、消息队列/缓存等中间件、扫描分析平台等一切环境资源均须按隔离标识隔离，禁止复用既有实例或共享端口；启动前发现隔离环境有残留时，先按已加载的清理规范幂等清空再启动"
+          - "自证/验证需启动服务或基础设施时，一律按已加载技术栈 skill 的隔离启动规范以隔离方式启动，隔离标识与建议端口以视图 Worktree 区块为准；隔离对象不限于数据库——为本变更启动的 mock 服务、消息队列/缓存等中间件、扫描分析平台等一切环境资源均须按隔离标识隔离，禁止复用既有实例或共享端口；启动前发现隔离环境有残留时，先按已加载的清理规范幂等清空再启动；残留判定遵循已加载清理规范的归属判别，无法确认归属本变更的进程一律不清"
           - "涉及接口契约或数据口径变更（按已加载的接口测试规范判定）时，实施过程中即时更新/新建与变更接口对应的 `.http` 测试脚本（已有脚本更新为匹配变更后契约，尚无脚本则新建，并同步 SQL 前置数据脚本），按已加载接口测试规范的完整执行顺序（含 SQL 前置数据准备、隔离启动基础设施与服务、执行 `.http` 脚本）执行接口测试，确保变更内容真实有效；执行结果（附执行顺序与覆盖接口清单）经 test_results 参数提交；修复被驳回 issue 后再次提交前同样须执行"
           - "自证完成后停止本次启动的服务/基础设施实例，不留残留"
           - "环境/基础设施问题（schema 缺失、DDL 未执行、依赖未安装）应通过 migration/初始化脚本等代码层面解决；仅生产级凭据、真实第三方资源、人工运维才走 blocker/豁免"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ifrankwang/openspec-agents",
-  "version": "0.138.0",
+  "version": "0.140.0",
   "description": "OpenSpec change orchestration plugin for AI coding agents (Claude Code, Codex, ZCode, DeepSeek Harness, OpenCode)",
   "author": "ifrankwang",
   "license": "MIT",

package/src/core/tools/lifecycle.ts

@@ -1322,8 +1322,9 @@ async function completeTaskGroupLocked(params: { change_id: string }, ctx: ToolC
     // 非最后任务组：门禁 → 勾选 → scope_end → completed_at；无合并、无销毁
     item.metadata["completed_at"] = new Date().toISOString()
     await writeState(ctx.worktree, state)
+    // 取消限制事实说明与终态视图非最后组文案同措辞（cancelTaskGroupNote）
     const doneMessage =
-      "任务组已完成。本任务组变更保留在 change 分支上，待全部任务组完成后统一收口合并（本次不合并、不销毁 worktree）。"
+      `任务组已完成。本任务组变更保留在 change 分支上，待全部任务组完成后统一收口合并（本次不合并、不销毁 worktree）。若某任务组已确认不再执行，当前版本不支持取消任务组，须人工编辑编排 state 文件（openspec/states/${state.changeId}.json）将该任务组的 phase 改为 "cancelled"，收口合并才会触发。`
     return checkboxWarning ? `${doneMessage}\n${checkboxWarning}` : doneMessage
   }
 

package/src/core/workflow/engine.ts

@@ -32,9 +32,10 @@ export function isTerminalPhase(phase: WorkItemPhase): boolean {
   return phase === "done" || phase === "cancelled"
 }
 
-/** 任务组「终态或从未激活」（mode 切换窗口与终态视图共享的单一判定）：
- *  done 或 completed_at 已设置即终态；否则须无执行痕迹（tags 为空）且全部 task children
- *  处于 todo 或终态。 */
+/** 任务组「终态或从未激活」（mode 切换窗口专用判定）：done 或 completed_at 已设置即终态；
+ *  否则须无执行痕迹（tags 为空）且全部 task children 处于 todo 或终态。
+ *  「从未激活」计入收口仅对窗口场景正确（未开工组无进度，切走不丢东西）；收口合并判定
+ *  不得复用此口径（见 isFinalTaskGroup）。 */
 export function isTaskGroupSettled(item: WorkItem): boolean {
   if (item.phase === "done" || item.metadata["completed_at"] !== undefined) return true
   const noTags = Object.keys(item.tags).length === 0
@@ -44,12 +45,14 @@ export function isTaskGroupSettled(item: WorkItem): boolean {
   return noTags && childrenSettled
 }
 
-/** 判断 item 是否为其 change 的最后一个收口任务组：其余全部任务组均「终态或从未激活」。
- *  complete 的 change 级收口判定与终态视图文案分流共用此判定（单一事实源）。 */
+/** 判断 item 是否为其 change 的最后一个收口任务组：其余全部任务组均终态（done 或
+ *  completed_at 已设置）。「从未激活」不计入收口——串行编排下未开工组无任何进度痕迹，
+ *  若计入会令首个完成组被误判为最后组而提前合并销毁。complete 的 change 级收口判定与
+ *  终态视图文案分流/部署注意区块门禁共用此判定（单一事实源）。 */
 export function isFinalTaskGroup(state: { workItems: WorkItem[] }, item: WorkItem): boolean {
   return state.workItems
     .filter((w) => w.id.startsWith("task:") && w.id !== item.id)
-    .every(isTaskGroupSettled)
+    .every((w) => isTerminalPhase(w.phase) || w.metadata["completed_at"] !== undefined)
 }
 
 export function isBlockingSeverity(severity: string | undefined): boolean {

package/src/core/workflow/status.ts

@@ -6,7 +6,7 @@ import type { ExemptionRecord } from "../exemptions.ts"
 import type { LoadedWorkflow } from "./loader.ts"
 import type { EngineRecommendation } from "./engine.ts"
 import type { DetectChangesResult } from "../git.ts"
-import { getStepVerdict, isTerminalPhase, isBlockingSeverity, isTaskGroupSettled, isFinalTaskGroup, phaseStepMismatch, REVIEW_STEP_TO_LAYER, blockingStepChildren } from "./engine.ts"
+import { getStepVerdict, isTerminalPhase, isBlockingSeverity, isFinalTaskGroup, phaseStepMismatch, REVIEW_STEP_TO_LAYER, blockingStepChildren } from "./engine.ts"
 import { agentToReviewDimension, agentToReviewLayer, readIssueSource } from "../constants.ts"
 import { resolveChildIssueFields } from "./reset.ts"
 import { taskListOf, issueChildrenOf } from "../task-children.ts"
@@ -204,9 +204,9 @@ function renderTerminalPhase(item: WorkItem, state?: OrchestrateState, caller?:
       "",
       finalGroup
         ? "本任务组为最后一个收口任务组，change 收口已完成：变更分支已合并回基准分支，编排已完成并收尾。"
-        : "本任务组已完成，变更保留在 change 分支上，待全部任务组完成后统一收口合并。",
+        : `本任务组已完成，变更保留在 change 分支上，待全部任务组完成后统一收口合并。${cancelTaskGroupNote(state)}`,
       "",
-      ...renderDeploymentNotesSection(state, caller),
+      ...renderDeploymentNotesSection(state, item, caller),
     ].join("\n")
   }
   return [
@@ -217,18 +217,25 @@ function renderTerminalPhase(item: WorkItem, state?: OrchestrateState, caller?:
       ? "调用 `opx_orch_complete_task_group` 完成 change 收口（把变更分支合并回基准分支并清理）。"
       : "调用 `opx_orch_complete_task_group` 完成任务组收尾（变更保留在 change 分支，统一收口时合并）。",
     "",
-    ...renderDeploymentNotesSection(state, caller),
+    ...renderDeploymentNotesSection(state, item, caller),
   ].join("\n")
 }
 
+/** 非最后组收口文案的取消限制事实说明（与 complete 非最后组返回体同措辞）：当前版本无取消任务组
+ *  的工具入口，弃做组须人工置 cancelled 后收口合并才会触发。无 state（理论不可达）返回空串。 */
+function cancelTaskGroupNote(state: OrchestrateState | undefined): string {
+  if (!state) return ""
+  return `若某任务组已确认不再执行，当前版本不支持取消任务组，须人工编辑编排 state 文件（openspec/states/${state.changeId}.json）将该任务组的 phase 改为 "cancelled"，收口合并才会触发。`
+}
+
 /** 终态视图的「部署注意事项」区块（仅编排视角、change 会话渲染）：指引编排者读主仓库规划文档提取
  *  部署要点，并聚合各任务组 self_check_results 申报的「部署注意点:」前缀行（实施补充点，编排者纯转述）。
- *  渲染前提：change 全部任务组均终态或从未激活（isTaskGroupSettled，含当前组——渲染到终态时当前组必已
- *  终态），存在未收口组时不渲染（两形态维持既有文案）。全部组无实施补充点时省略补充点段（不渲染空段）。 */
-function renderDeploymentNotesSection(state: OrchestrateState | undefined, caller: StatusViewCaller | undefined): string[] {
+ *  渲染前提：当前组为最后一个收口任务组（isFinalTaskGroup，其余组均终态且渲染到终态时当前组必已
+ *  终态），尚有未收口组时不渲染（两形态维持既有文案）。全部组无实施补充点时省略补充点段（不渲染空段）。 */
+function renderDeploymentNotesSection(state: OrchestrateState | undefined, item: WorkItem, caller: StatusViewCaller | undefined): string[] {
   if (!caller?.orchestrator || !state || state.kind === "review") return []
+  if (!isFinalTaskGroup(state, item)) return []
   const taskGroups = state.workItems.filter((w) => w.id.startsWith("task:"))
-  if (!taskGroups.every(isTaskGroupSettled)) return []
   const lines = [
     "## 部署注意事项汇报",
     "",