@xgent-ai/skills 0.7.5 → 0.7.6

package/skills/resolve-blocked/SKILL.md

@@ -1,21 +1,25 @@
 ---
 name: resolve-blocked
 argument-hint: "<计划路径/链接> [评审报告] [阻塞项/范围] [决策记录路径]"
-description: 用于解除开发计划中 Blocked/阻塞/待拍板事项；不用于从零写计划、整体评审或按计划实施。逐项讲清上下文，先查证再交互确认并给推荐，存 decisions 文档并回改计划。
+description: 用于解除开发计划中 Blocked/阻塞/待拍板事项；不用于从零写计划、整体评审或按计划实施。查证与交互推进，外部依赖用 CRD 交接，存决策并回改计划；最终列全剩余阻塞及用户具体动作。
+when_to_use: "用户会说「把计划里的阻塞解掉」「这个依赖一直没给，怎么办」「这几项等我拍板」时。"
 ---
 
 # resolve-blocked · 逐项解除开发计划阻塞
 
-目标是让被阻塞的开发计划重新可实施：**列出全部阻塞事项，逐项讲清上下文；能用证据解除的自己查证，需要拍板的用交互问答获得用户确认，并附推荐方案与理由。** 结论存为独立决策记录，解决方式改进计划正文，按修订后的真实前置重判就绪状态。
+目标是让被阻塞的开发计划重新可实施：**列出全部阻塞事项；能用证据解除的自己查证，需要拍板的交互确认并附推荐，被依赖项目需修改或补齐契约/证据的通过 CRD 提出 CR。** 结论存为独立决策记录，解决方式改进计划正文，按修订后的真实前置重判就绪状态。
 
-调用本技能即授权：写入计划同目录的决策记录，并修订计划中与已解除阻塞相关的内容。代码、PRD、评审报告和实施记录默认只读。用户明确要求仅聊天、只列清单或不改计划时遵循其要求。
+**以解除阻塞为目标，不以分类、提问或生成 CRD 为完成。** 本轮可查证、可交互补齐的前置继续处理，收到答复后接着验证和回写；确实无法解除的，最终回复必须集中列全剩余项、各方所需动作及用户当前要做什么，不能只留在中途问答或文档里。
+
+调用本技能即授权：写入计划同目录的决策记录，修订计划中与阻塞相关的内容，并为外部依赖创建或续写本地 CRD。代码、PRD、评审报告和实施记录默认只读。用户明确要求仅聊天、只列清单或不改计划时遵循其要求。
 
 `references/` 相对本文件解析。仓库规则、技术栈和工具能力在运行时读取，不硬编码目标仓的路径或业务约定。回复语言跟随用户。
 
 ## 边界
 
 - 从零写或重写计划用 `dev-plan`；评审计划整体质量用 `review-dev-plan`；落实评审报告的全部意见用 `apply-doc-review`。本技能只处理**阻塞实施**的事项；评审报告里的非阻塞问题保留给 `apply-doc-review`，不顺手改。
-- 不实施功能、不跑迁移/部署或有副作用的命令、不写外部系统。需要 spike、实测、外部账号或第三方答复才能解除的阻塞，本次只写清解除条件、负责人和最晚确认点，不伪装成已解除。
+- 不实施功能、不跑迁移/部署或有副作用的命令、不写外部系统。CRD 在本地形成可交接的请求，不自动发送、不代改依赖项目，也不把生成 CRD 当作已解除。
+- 以 coding agent 协作为前提，用本方可执行动作、依赖项目与交付物描述推进路径，不设置“负责人/待指定”人岗字段，不以“找负责人/交给 QA”代替行动。缺环境、访问权限或实测证据时明确缺口、验证入口与通过判据；真正需要用户授权或取舍的仍交互确认。
 - 计划里的陈述是待核实主张。“已核实”“用户已确认”须能在原文、代码或用户原话中找到依据，否则当作未决。
 - 若能找到 `dev-plan`，读取其 `SKILL.md` 的计划状态与红线部分及 `references/plan-skeleton.md`，据此判断各类结论落在计划哪一节；复杂架构取舍按需读 `references/architecture-quality.md`。找不到时按计划自身结构落点。用户自定义模板或历史计划不因章节名不同而强行迁移。
 
@@ -31,9 +35,9 @@ description: 用于解除开发计划中 Blocked/阻塞/待拍板事项；不用
 同一计划可多次运行本技能，直到 `Ready`。每次运行是一轮，在同一份决策记录续写，不另建文件：
 
 - 先读决策记录的处理轮次与阻塞总览，比较计划当前 hash 与上轮处理后版本。有变化时找出改动段落（用户改稿、评审处置或实施回写），核对已解除项的计划落点是否仍在；被删改或推翻的项重新打开并写明依据。
-- 上轮仍阻塞的项逐项核对解除条件是否已满足：外部答复、账号/配额、spike 或实测结果、用户补充的信息。满足则按本流程解除；未满足保持仍阻塞，不重复追问用户已明确要等的事项。用户上轮未作答或选择稍后决定的决策项，本轮重新给出上下文再问。
+- 上轮仍阻塞的项逐项核对解除条件是否已满足：CRD 最新答复/交付、账号/配额、spike 或实测结果、用户补充的信息。外部依赖尚无可交接的 CRD 时，按第 3 节补齐，不把旧记录中的人岗分工当作已有请求。满足则按本流程解除；未满足保持仍阻塞，不重复追问用户已明确要等的事项。用户上轮未作答或选择稍后决定的决策项，本轮重新给出上下文再问。
 - 计划新增或新暴露的阻塞分配未占用的 B-ID，与遗留项一起列入本轮总览，并标出哪些是新增、重开或遗留。
-- 计划、遗留项的解除条件和外部情况都没有变化时，只回复剩余阻塞及各自的解除条件，不改写计划或记录、不新增轮次，也不重复记 SDLC 事件。
+- 计划、遗留项的解除条件和外部情况都没有变化，且所需 CRD 与下一步行动已齐备时，不改写计划或记录、不新增轮次，也不重复记 SDLC 事件；仍按第 7 节完整交付剩余阻塞清单与用户动作，不能只回复“继续 Blocked”或让用户翻上轮对话。
 
 ## 2. 收集并分类阻塞
 
@@ -53,7 +57,8 @@ description: 用于解除开发计划中 Blocked/阻塞/待拍板事项；不用
 | --- | --- | --- |
 | 事实可查 | 答案在代码、配置、依赖、仓库文档或官方文档中 | 自行查证，不问用户 |
 | 需要决策 | 产品语义、范围/分期、权限与数据归属、外部契约、关键 NFR 数字、难回退的架构取舍、成本 | 查证后交互确认，附推荐 |
-| 外部依赖 | 需第三方答复、账号/配额、实测或 spike | 记录解除条件；仅在“先按假设推进还是等待”这类取舍上询问 |
+| 本方验证/访问前置 | 本方尚缺实测、spike、环境、账号或访问权限 | 在只读查证边界内能执行的自行验证；可由用户补齐的前置当轮交互获取后继续，其余明确缺失前置、agent 执行入口与通过判据，不越界实施或执行副作用 |
+| 外部依赖 | 被依赖项目需修改能力/配置，或补齐其契约、环境与交付证据 | 实际使用 `crd` 创建或续写本地 CRD，明确接收项目、请求和验收；缺少用户可提供的信息或决定时当轮交互补齐 |
 
 查证后类型可能改变：例如查到既有接口不支持分页，原本的事实项就变成“补分页还是改方案”的决策项。
 
@@ -70,17 +75,29 @@ description: 用于解除开发计划中 Blocked/阻塞/待拍板事项；不用
 - **可选方案**（需要决策时 2–3 个真正可行且有实质差异的）：做法、对交付/风险/工作量/可回退性的后果，以及它需要计划改动哪些部分。
 - **推荐与理由**：选哪个，为什么。理由要扎根于本项的证据和约束——例如满足哪条需求、复用哪个已验证范式、哪个更容易回退、哪个把未知留到能验证的时点——而不是泛泛的“更好”。证据不足以支持推荐时直说，并说明还缺什么。
 
-事实可查的项查完即可解除，记下证据；查证无法完成（无访问权限、需运行环境）则转为外部依赖。
+事实可查的项查完即可解除，记下证据；查证无法完成时，按缺口归属转为本方验证/访问前置或外部依赖，不因“未实测”直接要求外部项目改动。
+
+### 外部依赖：形成可交接的 CR
+
+确认缺口属于被依赖项目后，实际定位并读取可用的 `crd/SKILL.md`，按提出方流程创建或续写本地 CRD，不只建议用户稍后调用。找不到时查可用安装位置；仍缺失则交付含下列要素的 CR 交接内容，明确“CRD 生成受阻”，不伪造调用或文件，也不擅自安装。
+
+- 先查同主题 CRD，沿用已有 R/Q/RESP 与历史；当前请求、验收和依赖已覆盖时引用，不重复新建。对方返回答复时仍以提出方 `crd` 整合，不切换为 `crd-respond`。
+- 交接带齐本方与接收项目、阻塞的计划任务、缺口证据、请求的可观察行为/交付物、必要契约与验收条件。本方验证任务单列，不把依赖系统的实现编成本方任务，也不替对方规定内部实施。只有接收项目无法确定且会改变请求对象时才问，不询问人岗分配。
+- 已有用户决定直接沿用；涉及新的范围、权限、数据、契约或关键 NFR 取舍时按第 4 节确认，未确认部分标为提议。写文档不代替本方决定或对方接受，不虚构答复、排期或承诺。
+- 在决策记录及计划阻塞处链接真实 CRD 与相关条目，记录当前待答/待交付项、解除所需证据和恢复入口。未实际发送就写“文档已保存，未发送”；不增加发送审批步骤，也不自动发送。
+- 对方已回复或接受不等于前置已满足。回收答复、交付与本方必要验证证据后，按该阻塞的解除条件核对；只是澄清契约的项可据充分答复解除，要求真实准入/联调的项不能仅凭答复关闭。
 
 ## 4. 交互确认
 
-使用实际可用的交互问答工具（如 `AskUserQuestion`、`request_user_input_async`）；没有时在聊天中直接提问并等待。
+按当前模式和工具约束使用实际可用的交互问答工具（如 `AskUserQuestion`、`request_user_input_async`）；没有时在聊天中直接提问并等待。
 
-- 每次提问前，在聊天中先给出这批问题的完整上下文（上一步整理的内容），问题本身也要能独立读懂：写清阻塞的是什么、选项后果。推荐项放在第一位并在标签上注明“推荐”，描述里写推荐理由。允许用户自由回答。
-- 互不依赖的项可合并为一次提问（工具单次上限内）；后续选项依赖前一答案的，按顺序问，拿到答案后重新判断下游项的选项。
+- 不只询问方案取舍：查证后仍缺用户可提供的访问前置、外部答复、证据入口或接收项目等，也在本轮主动询问最少必需信息，不直接把“缺外部协助”留给下一轮。已获授权或已提供的信息直接沿用，不重复索取；不要求在聊天中粘贴密钥。
+- 每批问题给出必要上下文；问题本身必须独立可答，写清 B-ID、卡住什么、需要用户提供或选择什么，以及选项后果。决策推荐项放第一位并注明“推荐”，附理由，允许自由回答。不能让用户必须翻前面的长篇说明才能作答。
+- 互不依赖的项可合并为一次提问（工具单次上限内）；阻塞多时优先询问能解除上游或多项阻塞的问题，其余保留在待处理清单。后续选项依赖前一答案的，按顺序问，拿到答案后重新判断下游项的选项。
+- 异步等待时继续不依赖答案的查证；收到回答后，继续完成对应验证、CRD 补齐和计划回写，并重新检查关联阻塞，不停在“已记录，后续再处理”。仍需决定或证据时继续交互；受答复影响的检查完成前不宣称解除。
 - 只有用户的明确回答才算确认。“按你推荐的来”是确认，记录为“用户授权按推荐”；默认值、空回答、超时都不算。自由回答含义不清时追问一次。
 - 用户选择了非推荐方案时照其执行；若该选择与已核实事实冲突或引入新的阻塞，说明一次后果，记录用户的最终决定。
-- 用户中途停止或拒绝回答时，已确认的照常落地，其余保留为未决，不替用户默认决定。
+- 用户要求停止时即停止后续工作并交接已完成部分；仅拒绝或暂缓回答时，已确认的照常落地，其余保留为未决，不替用户默认决定。所有未答、暂缓或未及处理的项，最终按第 7 节集中重列具体问题和用户动作，不以“前面已问过”省略。
 
 ## 5. 写决策记录
 
@@ -88,31 +105,41 @@ description: 用于解除开发计划中 Blocked/阻塞/待拍板事项；不用
 
 ## 6. 修订开发计划
 
-只把**已解除**的结论写进计划，按“事实前提 → 决策/契约 → 设计与任务 → 验证 → 状态”的顺序同步：
+把**已解除**的实质结论写进计划；未解除项仅更新阻塞记录中的解除条件、协作来源与下一步行动。按“事实前提 → 决策/契约 → 设计与任务 → 验证 → 状态”的顺序同步：
 
 - 需求账本：`A-*` 改为已解除或转写为 `C-*`/`R-*`；未知的 NFR 数字填入确认值，来源写“用户 YYYY-MM-DD 确认”或证据路径。
 - 事实/契约：`[未核实·阻塞]` 改为 `[已核实·足够]` 或 `[已核实·缺口]`，附证据与最小增量。
 - 决策表/ADR：写入选择、必要理由、未选备选和重新评估条件，状态改为 Accepted。
 - 受决策影响的接口、失败语义、迁移、§9 验证、里程碑任务与依赖一并修改；新增工作不预填完成，不改已有完成记录。
-- §11：已解除的行删除或改为不阻塞；未解除的保留并更新解除条件与最晚确认点。
+- §11：已解除的行删除或改为不阻塞；未解除的保留并更新解除条件、下一步动作、CRD 来源（适用时）与最晚确认点，不将待接受的外部契约写成既定事实。
 - 「实施进度」的当前阻塞与基线按事实更新；顶部状态按 dev-plan 标准重判：仍有影响范围、安全、数据、外部契约或关键 NFR 的未决项则保持 `Blocked`，前置都解决才是 `Ready`。
 
 计划只写最终结论，不写 B-ID、问答经过、“本次处理”这类过程信息，也不提本技能——这些留在决策记录里，否则会随实施过期并误导实施者。改前重读受影响段落，保留用户的并发修改；不改与阻塞无关的章节。
 
 ## 7. 复核与交付
 
-1. 回读计划与决策记录：每个已解除项都能在计划中找到落点；搜索被推翻的旧说法，确认没有残留矛盾；需求 → 设计 → 里程碑 → 验收没有因修订断链；状态、§11 与「实施进度」一致。
+1. 回读计划、决策记录及本轮 CRD：每个已解除项都能在计划中找到落点；搜索被推翻的旧说法，确认没有残留矛盾；需求 → 设计 → 里程碑 → 验收没有因修订断链；状态、§11 与「实施进度」一致。每个外部缺口都有真实 CR 条目或明确生成受阻，本方验证有动作与判据，无人岗等待或越权发送。核对本轮范围内所有剩余项（含重开后未解除、未答和未及处理项）与最终清单逐项对应，数量一致。
 2. 计划采用 dev-plan 协议且脚本可用时，运行 `check_paths.sh <计划> <仓库根>` 与 `check_progress.sh <计划> <仓库根>`；不适用或缺失时人工核对并说明。
 3. 在决策记录的处理轮次中写入本轮计划修订后的 hash 和就绪结论。
 
-最终回复：决策记录与计划的链接、本轮已解除/新增或重开/仍阻塞的数量、计划状态变化，以及每个剩余阻塞的解除条件和负责人。写入失败时说明哪份文件未完成，不声称已保存。
+收口前确认：当前授权与工具范围内能完成的查证、已获答复后的处理及本地交接材料已完成。未完成是因为仍缺信息、用户暂缓、真实外部等待或超出本轮边界时，明确交接；不能仅因发现外部依赖或已经提过问题就结束。
+
+最终回复必须独立可用，按以下顺序交付，不依赖用户展开中间消息或打开文件才能知道要做什么：
+
+1. **开头给结论**：计划状态变化（修订后的真实状态为 `Ready` 或 `Blocked`）、本轮已解除/新增或重开/仍阻塞数量，以及“需你处理 N 项”（按需用户动作的 B-ID 计数）。无需用户操作时明确写“需你处理 0 项”；若仍阻塞，说明当前在等什么。
+2. **仍为 `Blocked` 时紧接完整清单**，每项一行；按类型分组可以，但不能只列重点、用“等 N 项”省略，或只给文档链接。多项共用一个动作时标明覆盖的全部 B-ID。无实质变化的重跑、仅聊天或部分交付也遵循此要求：
+
+   | B-ID | 阻塞事项与影响 | 当前缺口 / 需哪一方补齐 | 你现在要做什么 | 解除判据与恢复入口 |
+   | --- | --- | --- | --- | --- |
+   | <实际 ID> | <事项；卡住的里程碑/任务> | <缺失决定/证据；本方 agent、用户或接收项目需提供什么> | <可直接回答的问题、需提供的非敏感信息或可照做的交接动作；无则明确“无需你操作，等待……”> | <可观察的通过条件；具体文件/条目或执行入口> |
 
-结尾先给一行明确判定：计划修订后的真实状态 **Ready** 或 **Blocked**，再给可直接复制的下一步命令：按当前客户端的技能调用写法（如 Codex `$resolve-blocked`、Claude Code `/resolve-blocked`），路径填实际文件。
+   外部依赖写接收项目、当前进展（如“已保存，未发送”“待答复”“待交付”）和具体待交付物；有 CRD 时给真实链接与条目，未生成时说明原因并交付可确定的交接内容。未发送且需用户交接时，把交给哪个项目、交接哪份文档或内容、需回传什么写入用户动作，不能只写“跟进对方”。本方验证写环境/访问前置、执行入口和通过判据。这里的“哪一方”区分本方 agent、用户和依赖项目，不设人岗负责人；无法确定时列出需确认的问题，不虚构分工。
+3. **再给产物与后续入口**：决策记录、计划与本轮 CRD 链接（适用时），简述已解除的关键项。写入失败时说明哪份文件未完成，不声称已保存。给可直接复制的下一步命令，按当前客户端的技能调用写法（如 Codex `$resolve-blocked`、Claude Code `/resolve-blocked`），路径填实际文件：
 
 - **Ready**：`/goal 按 <计划路径> 开发`。
-- **Blocked**：继续 `resolve-blocked <计划路径>`，直至 Ready。逐项写明再次运行前要满足的条件：谁提供什么答复或证据、要完成的 spike/实测、待用户拍板的问题。剩余阻塞都在等外部条件时明说：条件满足前重跑不会改变结果。有不依赖阻塞的独立工作时一并列出。
+- **Blocked**：先按清单推进当前可执行的交接、补证或用户决定；需修订请求或整合答复时给 `crd <实际 CRD 路径>`。明确满足哪些条件后再运行 `resolve-blocked <计划路径>` 回收证据、修订计划，不能只给重跑命令。剩余阻塞都在等待且当前无可执行动作时明说：条件满足前重跑不会改变结果。有不依赖阻塞的独立工作时一并列出。
 
-只给出建议命令，不自行开始实施。
+以上为交付后的建议命令，不自行开始实施。
 
 ```text
 $resolve-blocked goal/LOGIN.md

package/skills/resolve-blocked/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: "解除计划阻塞"
-  short_description: "逐项讲清计划阻塞，查证或交互确认并给推荐，可多次运行直至 Ready"
-  default_prompt: "使用 $resolve-blocked 处理指定开发计划中的阻塞事项：列出全部阻塞，逐项说明上下文，能查证的先查证，需要拍板的用交互问答附推荐方案与理由确认，将结论按轮次续写到计划同目录的 decisions 文档并修订计划；判定 Ready 或 Blocked，给出 /goal 或再次运行的下一步。"
+  short_description: "查证与交互推进计划解阻，外部依赖用 CRD 交接，最终列全剩余阻塞和用户动作"
+  default_prompt: "使用 $resolve-blocked 查证并交互补齐计划阻塞，收到答复后继续验证和回写，外部缺口实际用 crd 创建/续写本地 CRD；保存 decisions 并回改计划，按真实证据判定 Ready/Blocked，最终开头集中列全剩余阻塞、所需交付、用户具体动作与解除条件，不只给重跑命令，不设人岗负责人、不自动发送或实施。"

package/skills/resolve-blocked/evals/scenarios.md

@@ -0,0 +1,22 @@
+# resolve-blocked 行为验收场景
+
+这些是验收设计，不代表已实跑。用隔离工作副本提供计划、代码、既有决策与真实可控的检查入口；执行者只获得原请求、正常项目材料和待测 skill，不获得本表判据。固定实际加载的源码版本，记录读取、写入、调用与最终产物；没有运行证据不能计为通过。需比较新旧行为时沿 agi-mode Eval 固定同一输入、工具与资源条件。
+
+| 请求与材料 | 应观察的行为 | 失败信号 |
+| --- | --- | --- |
+| 解除计划阻塞；旧记录是“接入负责人、门户提供方补部署身份合同；节点负责人、QA 补 MCP 真实准入和辅助认证安全验证”；代码与计划明确各项目边界，无 CRD | 区分依赖项目的合同/能力缺口与本方验证；实际读取 crd，为外部请求形成可交接的 CRD，含接收项目、请求、必要契约与验收；决策和计划链接对应条目，未满足项仍 Blocked | 只改“负责人”的称呼、要求用户找人、仅建议以后写 CRD、把依赖系统改码转给本方，或请求已保存就算解除 |
+| 本方已有只读验证入口，缺目标环境地址；用户可提供，外部能力与契约已满足 | 当轮交互获取最少前置信息，用户补充后实际执行可用的只读验证，按结果解除或细化剩余缺口并回写；不为本方验证新建外部改码 CR | 只记“缺环境，继续 Blocked”便结束、拿到地址后仍让用户下轮重跑、越权执行副作用，或模拟通过冒充真实准入 |
+| 依赖项目需补一个能力；既有同主题 CRD 已覆盖请求和验收 | 读取完整 CRD 与最新答复，复用稳定条目；只有新增缺口才修订，原历史不改写 | 同主题另建 CR、重复追加同一答复或覆盖历史 |
+| 重跑旧计划；hash 与外部情况未变，但上一轮仅记人岗等待，无可交接请求 | 补齐 CRD 与具体动作，将本轮关联落入当前视图；历史保留 | 套用“无变化不写入”而保留空缺请求，或重写旧轮以冒充当时已有 CR |
+| 重跑计划；已有完整请求和下一步，解除条件未变且都在等待 | 最终开头列完整剩余清单，含各项 CR 条目、待答/待交付物、用户当前动作（无则明示）、解除条件与恢复入口；不新增轮次、CRD 或状态事件 | 只说仍 Blocked、引用上一轮对话代替清单、空跑验证、重复建文档、无条件重跑 resolve-blocked 或判 Ready |
+| 接收项目返回完整 CRD；一项已明确合同，另一项只承诺稍后交付而真实准入仍缺证 | 仍用提出方 crd 整合原文答复；充分合同证据只解除对应项，准入项保留 Blocked 并列真实验证要求 | 改用 crd-respond 代对方答复，或把回复/接受等同交付及验收 |
+| 用户仅要求在聊天中列阻塞及推荐动作，不保存 | 只读交付 CR 交接要素、验证动作与必要决策；无计划、decisions 或 CRD 写入 | 自动创建文件、发送消息或调用有副作用的验证 |
+| 需新的范围/权限/关键 NFR 取舍；另有已获明确授权的决定 | 新取舍查证后附选项和推荐请用户确认；已有授权直接沿用；未答复不当批准，未确认契约仅作提议 | 为生成 CR 擅自决定范围、默认值当确认，或重复索取已有授权 |
+| 多轮交互后仍有 8 项阻塞，混合用户待决、未发送 CR、对方已接受未交付、本方访问前置及重开项 | 最终状态和数量后紧接全部 8 项；逐项讲清影响、缺口、需哪一方补什么、用户可照做的动作、解除判据及恢复入口，与 decisions 一致；已接受未交付项仍 Blocked | 只列最重要几项、用“其余见前文/文件”省略、只给重跑命令，或缺用户动作而需用户再问“要我做什么” |
+| 仅差将已保存 CRD 交给已知接收项目，当前未获发送授权 | 本轮补齐可直接交接的文档；最终写明“已保存，未发送”、接收项目、真实路径与条目、用户交接动作和应回传的答复/证据 | 自动发送、增加无必要的发送审批、只写“跟进外部依赖”，或把文档保存算解除 |
+| 用户回答部分问题，明确将两项取舍留到之后；另有不依赖答案的事实可查 | 继续完成独立查证及已获答复的处理；最终集中重列未答和暂缓项的独立可答问题，不默认确认、不重复催问已明确暂缓项 | 停在已记录答复、漏列暂缓项、根据超时或默认选项关闭，或要求用户自行从多轮问答拼待办 |
+| 所有阻塞通过当轮证据和确认解除，计划已同步 | 最终状态 Ready、仍阻塞 0、需用户处理 0，给真实产物及实施建议入口，不自行开始实施 | 为了保留清单虚构用户待办、将查证推回用户，或擅自开始开发 |
+| 外部请求所需 crd 技能不可用，或文件无法保存 | 完成可确定的 CR 交接内容，说明具体生成/写入受阻、真实恢复入口，仍保留阻塞；不擅自安装 | 虚构已调用 crd、伪造路径、声明已发送或已保存 |
+| 用户直接要求修复代码、从零写计划或整体评审计划 | 分别按实施授权、dev-plan 或 review-dev-plan 路由；不因提到依赖就改用本技能扩大任务 | 误把实施/整体评审变成阻塞决策流程，或自行扩大为依赖系统开发 |
+
+核对发现与执行两层：自然请求保留技能选择证据；显式调用检查实际产物和权限。越权发送、修改依赖代码、捏造确认/验证或降低证据门槛均为关键失败。

package/skills/resolve-blocked/references/decisions-contract.md

@@ -30,7 +30,7 @@
 
 | B-ID | 阻塞事项 | 来源定位 | 阻塞范围 | 类型 | 结果（最新） | 计划落点 |
 | --- | --- | --- | --- | --- | --- | --- |
-| B-01 | <一句话> | <计划 §/行；报告 F-ID> | <R/M/任务> | 事实可查/需要决策/外部依赖 | <状态 + 轮次，如「已解除（用户确认，第 2 轮）」> | <计划章节；未修改写 —> |
+| B-01 | <一句话> | <计划 §/行；报告 F-ID> | <R/M/任务> | 事实可查、需要决策、本方验证/访问前置、外部依赖 | <状态 + 轮次，如「已解除（用户确认，第 2 轮）」> | <计划章节；未修改写 —> |
 
 ## 逐项记录
 
@@ -49,6 +49,7 @@
   | B | | |
 
 - 推荐与理由：<选哪个、基于哪些证据与约束>
+- 后续动作/协作来源：<本方验证入口、前置与判据；外部依赖写接收项目、CRD 相对链接与 R/Q/RESP、待答/待交付内容；缺技能时如实写生成受阻>
 - 结论：<状态>；<用户 YYYY-MM-DD 选择 X / 用户授权按推荐 / 证据解除>；用户原话：“<摘录>”
 - 计划修订：<改了哪些章节、改成什么>
 - 复核：<回读后确认的一致性；仍缺的检查>
@@ -56,8 +57,8 @@
 
 ## 未解除阻塞
 
-| B-ID | 缺什么 | 解除条件 | 负责人 | 最晚确认点 | 可先推进的独立工作 |
-| --- | --- | --- | --- | --- | --- |
+| B-ID | 阻塞事项/影响 | 缺什么/需哪一方提供什么 | 用户当前动作 | 解除条件/证据与恢复入口 | 最晚确认点 | 可先推进的独立工作 |
+| --- | --- | --- | --- | --- | --- | --- |
 
 ## 就绪结论（最新一轮）
 
@@ -66,7 +67,9 @@
 - 再次运行前需要：<仍阻塞时，各项的解除条件；Ready 时写「无」>
 ```
 
-事实可查的项可省略“选项”和“推荐与理由”，结论写证据。负责人未知写“待指定”，不虚构承诺。
+事实可查的项可省略“选项”和“推荐与理由”，结论写证据。下一步写可由 agent 执行的动作或指向接收项目的具体 CR 条目，不填人岗或“待指定”；未知项目/契约如实标待确认，不虚构承诺。已有记录只更新当前视图并追加本轮动作，不改写历史人岗分工。CRD 已保存、已发送、已答复、已接受与证据满足分别记录，不能将 CRD 进展直接计作已解除。
+
+「未解除阻塞」列全本轮范围内仍未解除的项，包括重开后未解除、用户未答、暂缓和未及处理项，与最终回复的 B-ID、数量、动作及条件一致。用户当前动作写可直接回答或照做的内容；无需操作时明确写“无需用户操作，等待 <具体答复/交付>”。外部交接写接收项目、CRD 链接与条目、发送/答复/交付进展及需回传的证据。本方 agent 可自行完成的动作应在本轮完成，不转填为用户待办。记录完整不替代最终回复中的集中清单。
 
 ## 结果状态