msdevflow 0.8.3 → 0.8.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "msdevflow",
-  "version": "0.8.3",
+  "version": "0.8.5",
   "description": "Install the msdevflow GitCode skill and its runtime dependencies",
   "type": "module",
   "bin": {

package/skill/msd/README.md

@@ -420,5 +420,6 @@ typed CLI command
 - [references/ci-and-review.md](references/ci-and-review.md)：CI 和作者 discussion 深层规则。
 - [scripts/openlibing_ci.py](scripts/openlibing_ci.py)：openLiBing 只读诊断与交互 OAuth 客户端。
 - [scripts/gitcode_review.py](scripts/gitcode_review.py)：`code-review` 固定 snapshot/context/finding/lgtm/cleanup 适配器。
-- [scripts/test_openlibing_ci.py](scripts/test_openlibing_ci.py)：openLiBing 无凭证控制流测试。
-- [scripts/test_gitcode_review.py](scripts/test_gitcode_review.py)：GitCode review 适配器的无网络回归测试。
+- [scripts/gitcode_verify.py](scripts/gitcode_verify.py)：`pr`/`ci` 的 PR 回读、评论回读、CI 轮询和监控 helper。
+
+测试文件（`scripts/test_openlibing_ci.py`、`scripts/test_gitcode_review.py`）只存在于 [源仓库](https://gitcode.com/msbuilder/msdevflow)，不随 npm 包或 skill 安装产物分发；安装目录中没有这两个文件是预期行为。

package/skill/msd/SKILL.md

@@ -45,7 +45,7 @@ msd-merge
 | `create-issue` | 按仓库或 community 模板创建 Issue | canonical、问题描述或类型 | `issue-created` | [references/create-issue.md](references/create-issue.md)；公共启动读 [references/setup-and-issue.md](references/setup-and-issue.md) |
 | `issue` | 接取并核验指定 Issue | Issue URL/编号、canonical | `verified` | [references/setup-and-issue.md](references/setup-and-issue.md) |
 | `develop` | 分析、设计、建分支、实现和本地验证 | 已核验 Issue、本地仓库 | `locally-verified` | [references/design-and-development.md](references/design-and-development.md) |
-| `pr` | commit、push 并创建普通 PR | 已实现分支、Issue、canonical/source | `pr-open` | [references/pr-and-ci.md](references/pr-and-ci.md) |
+| `pr` | commit、push 并创建普通 PR，然后触发并监控 CI | 已实现分支、Issue、canonical/source | `ci-passed`、`pr-open`（CI 协议无法确定时）或 `blocked` | [references/pr-and-ci.md](references/pr-and-ci.md) |
 | `ci` | 监控、诊断并修复当前 PR 的 CI | canonical PR | `ci-passed` | [references/pr-and-ci.md](references/pr-and-ci.md)；失败时读 [references/ci-and-review.md](references/ci-and-review.md) |
 | `openlibing-auth` | 验证 GitCode → openLiBing OAuth | 当前工作区 canonical | `openlibing-authenticated` | [references/openlibing-ci.md](references/openlibing-ci.md) |
 | `feedback` | 处理自己 PR 收到的检视意见 | canonical PR 及可写 source branch | `feedback-resolved` 或 `waiting-for-review` | [references/review-and-merge.md](references/review-and-merge.md)；结构化 discussion 时读 [references/ci-and-review.md](references/ci-and-review.md) |
@@ -61,7 +61,7 @@ msd-merge
 1. 只执行指定 action；达到完成条件后立即停止，只报告证据、当前 head、blocker 和建议的下一个 action。
 2. 启动时只读重建该 action 所需事实，不相信旧摘要、旧 head 或调用方声称的阶段已完成。
 3. 前置条件缺失时不得自动执行上游 action；只读核验后返回 `blocked`、缺失证据和建议的上游 action。
-4. 不执行下游 action。例如 `action=ci` 通过后不得处理 feedback 或 merge；`action=pr` 创建 PR 后不得自动触发 CI。
+4. 不执行下游 action。例如 `action=ci` 通过后不得处理 feedback 或 merge。`action=pr` 的 CI 触发与监控属于本 action 的完成链路（见 [references/pr-and-ci.md](references/pr-and-ci.md)），创建 PR 后自动触发 CI 并监控到 `ci-passed` 才停止；这不授权处理 feedback、merge 或请求检视。
 5. action 自身为安全完成所必需的复验属于本 action：例如 `pr` 在提交前重新运行适用本地门禁，`feedback` 修改后运行受影响本地测试。这不授权执行独立的下游 `ci`、补做缺失的产品实现或扩大范围。
 6. `ci` 和完整 E2E 在 openLiBing 只读接口返回 401/403 时可运行 OAuth 认证子流程并恢复原流程；这是读取当前 CI 证据的必要步骤，不视为越界执行显式 `openlibing-auth` action。
 7. 每个 action 在自身边界内连续执行到完成状态；不得在分析、设计、编辑、验证等中间步骤询问是否继续。能从权威证据、仓库约定和已确认目标可靠推导的结论直接采用，并报告依据，不把可自行完成的判断转交用户。
@@ -82,7 +82,7 @@ discover -> issue -> develop -> pr -> ci
 - 用户已给出 Issue 时无需先列候选，但仍执行环境、仓库画像和 Issue 核验。
 - 已有 PR 时仍补做最小充分的 Phase 0 仓库画像，再从权威 PR/head/CI/review 状态定位当前位置。
 - `pr` 创建普通 PR，不创建 Draft PR，不存在 Ready 转换。
-- 完整 E2E 在 `pr-open` 后不询问是否继续，直接路由到 `ci`；这只是编排器阶段切换，显式 `action=pr` 仍立即停止且不触发 CI。
+- 完整 E2E 在 `pr-open` 后不询问是否继续，直接路由到 `ci`；显式 `action=pr` 也按 [references/pr-and-ci.md](references/pr-and-ci.md) 在创建 PR 后自动触发并监控 CI 到 `ci-passed` 才停止，两者的 CI 触发行为一致。
 - 不请求检视、不触发检视机器人；当前 head CI 通过且无现有意见或独立审批时，暂停为 `waiting-for-review`。
 - 有未解决意见时进入 `feedback`；产生新 head 后重新进入 `ci`。
 - 独立审批门禁满足后才可进入 `merge`，最终合入始终需要用户针对当前 PR 明确确认。
@@ -126,6 +126,7 @@ discovered -> claimed -> verified -> analyzed -> designed
 - 不跳过 hooks/测试/CI/review，不默认 force push、关闭 Issue、删除分支或重写共享历史。
 - 创建 Issue/PR、评论、触发 CI、resolve 和 merge 前检查幂等状态；`create-issue` 在最终预览确认前禁止远端写入，每个 run 最多执行一次已确认的真实创建，禁止测试 Issue、POST 探测、失败重试或替代 Issue，只在写结果不确定时有界只读恢复；其他写结果不确定时也先回读。
 - `code-review` 的 GitCode 网络访问只能由 `scripts/gitcode_review.py` 执行；helper 输出不完整或能力不足即阻断，不回退现场命令、文本解析或 endpoint 探测。受管 snapshot 必须结束时清理，受管 write receipt 只用于固定 head 上评论写入的幂等恢复。
+- `pr`/`ci` 的 PR 回读、评论回读和 CI 轮询固定使用 `scripts/gitcode_verify.py`，不每轮现场生成 python/PowerShell 内联 JSON 解析；脚本报告 FAIL 或退出码非 0 时按验证失败阻断，先原地修复再回读。
 - Agent 写入 GitCode 的 PR 正文、Issue/PR 评论、discussion 回复和其他人类可读正文必须按 [references/state-and-safety.md](references/state-and-safety.md) 在末尾恰好附加一次 `——msdevflow`。
 - 所有人类可读远端文本必须通过 UTF-8 安全通道写入并逐字回读；发现乱码、`?`、截断或尾签损坏时阻断依赖动作，先原地修复。
 - 严格机器协议 payload 保持原样，不把尾签拼进 `compile`、`/lgtm`、`/merge` 等命令。除 `code-review` 检视通过时只发送精确 `/lgtm` 外，其他协议按 [references/state-and-safety.md](references/state-and-safety.md) 发布并验证带尾签的独立人类可读说明。
@@ -143,7 +144,7 @@ discovered -> claimed -> verified -> analyzed -> designed
 - `create-issue`：按确认的仓库或同类型 community 模板创建一个 Issue；创建参数显式设置已核实的平台类型，必需标签完整分页核验后应用，标题包含仓库/模板约定或默认的类型前缀。开放里程碑唯一时自动选择、多个时由用户选择、没有时明确为 `none`；远端回读必须确认平台类型与用户意图一致、前缀标题逐字一致、必需标签齐全，以及目标、完整正文、唯一尾签和其余元数据一致。类型错误或不可验证、缺少必需标签均为 `blocked`，不报告 `issue-created`；不创建标签或里程碑，也不执行查重、接取或开发。
 - `issue`：接取状态按授权完成或确认可继续，Issue、关联 PR 和 canonical 默认分支已核验，无重复开发。
 - `develop`：范围和方案已确认，工作分支基于最新 canonical，任务实现且适用本地门禁有实际证据。
-- `pr`：普通 canonical PR 回读确认 source/head/base、Issue 关联、标题和正文正确，且 PR 里程碑与目标 Issue 精确一致或两者均为 `none`。
+- `pr`：普通 canonical PR 回读确认 source/head/base、Issue 关联、标题和正文正确，且 PR 里程碑与目标 Issue 精确一致或两者均为 `none`；随后按 [references/pr-and-ci.md](references/pr-and-ci.md) 触发 CI 并监控当前 head，CI 协议确定时达到 `ci-passed` 或诊断出 blocker 才停止，无法确定 CI 协议时报告 `pr-open` 并建议 `action=ci`。
 - `ci`：当前 head SHA 的必需 CI 全绿；openLiBing 要求认证时，OAuth 子流程已验证并继续当前 CI。
 - `openlibing-auth`：在当前 canonical 内确定性选择并固定一个 openLiBing run，交互 OAuth 后对该 run 的只读请求成功；只持久化专用 GitCode 浏览器会话，Token 未输出或落盘。浏览器不可用时只输出 OAuth 链接并停止为 `blocked: browser-required`，不算完成。
 - `feedback`：调用时已有的阻塞 discussion 已逐条处理、回复并在允许时 resolve；代码修改已通过受影响本地测试并推送。若产生新 head，停止并建议 `action=ci`，不在本 action 内运行远端 CI；没有现有意见时停止为 `waiting-for-review`。

package/skill/msd/references/pr-and-ci.md

@@ -8,7 +8,7 @@
 
 只读确认：
 
-- Issue 已核验，canonical 默认分支没有闭环实现或重复 PR；
+- Issue 已核验，canonical 默认分支没有闭环实现或重复 PR；用户明确说明本次是不关联 Issue 的独立文档/维护修复时，按下方“独立 PR”执行，不要求 Issue 核验；
 - 当前分支不是默认分支，且基于已确认的 canonical 基线；
 - 任务实现与已确认范围一致；
 - 适用本地门禁有实际通过证据；
@@ -17,6 +17,16 @@
 
 前置条件缺失时返回 `blocked` 和建议的上游 `action=issue` 或 `action=develop`，不得自动补跑。为防止过期证据，提交前复验受影响的最小本地门禁属于 `pr` action。
 
+### 独立 PR（无 Issue）
+
+用户明确说明本次是不关联 Issue 的独立修复（文档文件名/typo/注释、模板或 CI 配置微调等）时，跳过 Issue 接取和核验，不返回 `blocked: issue-required`。要求：
+
+- change_type 记录为 `standalone-docs` 或 `standalone-maintenance`，issue/milestone 均为 `none`；
+- 用户没有明确说明独立修复、改动又明显超出文档/维护范围时，不得自行归类，返回 `blocked` 并建议 `action=issue`；
+- PR 正文关联 Issue 写 `N/A`，不虚构 Issue 编号；仓库模板要求 Issue 关联字段时按模板结构保留 `N/A`；
+- PR milestone 必须为 `none`，不继承、不选择其他里程碑；
+- 仍执行完整 commit 规范、本地门禁、push、PR 创建、回读验证和后续 CI 触发监控；禁止把独立 PR 当理由跳过任何门禁。
+
 ### Commit
 
 只暂存本任务文件，检查凭证和大文件。遵循仓库 commit 规范；无规范时使用 Conventional Commits。贡献规范要求时 sign-off：
@@ -30,7 +40,7 @@ git commit -s -m "<type>(<scope>): <summary>"
 
 ### Push
 
-展示 source remote、分支和 commits。guided 模式首次 push 前确认：
+展示 source remote、分支和 commits。用户原始请求或本轮已确认内容已经覆盖提交与推送动作时（例如明确说“可以提交推送了”），直接执行 push，不再单独确认。只有首次 push、push 目标/分支与已确认计划不同，或用户要求确认时才询问：
 
 ```bash
 git push -u <source-remote> HEAD:<branch>
@@ -38,6 +48,15 @@ git push -u <source-remote> HEAD:<branch>
 
 默认不 force push。
 
+push 被服务器以 `Git LFS upload failed: missing objects`、`missing or corrupt local objects` 等 LFS 错误拒绝时：
+
+1. 先确认本次待推送 diff 是否包含 LFS tracked 文件（`git lfs ls-files` 对照 `git diff --name-only <remote>/<default>..HEAD`）；
+2. 本次 diff 不含 LFS 文件、缺失对象属于历史数据时，在 guided 模式展示原因并取得用户确认后，使用一次性配置完成本次 push，不写入全局或仓库永久配置：
+   ```bash
+   git -c lfs.allowincompletepush=true push -u <source-remote> HEAD:<branch>
+   ```
+3. 本次 diff 包含 LFS tracked 文件时，不得使用该 bypass；先执行 `git lfs fetch --all` 和 `git lfs fsck` 补齐对象，无法补齐时返回 `blocked` 并报告缺失对象清单。
+
 ### 普通 PR
 
 使用仓库画像从 canonical repository 最新默认分支确认的 PR 模板，保留其标题、章节、检查项和说明，不从 Fork、工作分支或本地未提交文件重新取模板。正文按模板填写背景与 Issue、变更、验证、风险/回滚和未覆盖项；模板缺少必要信息时补入最合适的现有章节，不随意删除模板要求。若仓库没有模板，使用：
@@ -71,9 +90,18 @@ PR 里程碑严格继承已核验目标 Issue：Issue 有里程碑时，PR 必
 
 已经关联同一 number 时跳过编辑；关联了不同里程碑时必须展示当前值和目标 Issue 值，并在 guided 模式重新确认后才可覆盖。目标 Issue 为 `none` 但已有 PR 带里程碑时，只有当前 schema/help 明确提供并验证了清空语义才可在确认后清空，否则返回 `blocked: milestone-conflict`；不得猜测 `--milestone 0`。创建或编辑结果不确定时先回读同一 PR，不重复创建或盲目重试。
 
-随后逐字回读标题和完整正文，验证末尾恰好存在一次尾签，再验证 canonical、source、head、base、Issue 关联、PR 为 open，以及 PR 里程碑的 number/title 与目标 Issue 精确一致；目标 Issue 为 `none` 时验证 PR 也未关联里程碑。标题或正文出现乱码、`?`、截断、尾签缺失、重复或其他不一致，或者里程碑关联失败时，阻断后续动作，优先原地修复同一 PR 并再次回读。
+随后逐字回读标题和完整正文，验证末尾恰好存在一次尾签，再验证 canonical、source、head、base、Issue 关联、PR 为 open，以及 PR 里程碑的 number/title 与目标 Issue 精确一致；目标 Issue 为 `none` 时验证 PR 也未关联里程碑。PR 回读验证固定使用 Skill 随附脚本，不现场拼接 python/PowerShell JSON 解析：
+
+```bash
+python <skill-scripts-dir>/gitcode_verify.py verify-pr <canonical> <pr-number> \
+  --title <exact-title> --body-file <body-file> --issue <issue-number> --milestone <issue-milestone-or-omit>
+```
+
+脚本输出逐项 PASS/FAIL，退出码非 0 即验证失败。标题或正文出现乱码、`?`、截断、尾签缺失、重复或其他不一致，或者里程碑关联失败时，阻断后续动作，优先原地修复同一 PR 并再次回读。
+
+### PR 后自动触发 CI
 
-显式 `action=pr` 达到 `pr-open` 后立即停止：不得主动触发 CI、处理 CI、请求检视、处理 feedback 或 merge。平台自动启动的 CI 只作为已观察事实报告，不继续监控。完整作者 E2E 则由核心编排器在 `pr-open` 后无需用户确认直接进入 `ci` 阶段；这不改变独立 `pr` action 的边界。
+`pr-open` 回读通过后，`pr` action 不停止，继续按下方 Action `ci` 的规则触发并监控 CI：先读取 [ci-and-review.md](ci-and-review.md) 确定 CI 适配器；触发器是评论命令（如 `compile`）时，按 [state-and-safety.md](state-and-safety.md) 先发布带唯一尾签的说明评论并逐字回读，再单独发送精确 payload；随后用 `scripts/gitcode_verify.py watch-ci` 监控当前 head。CI 通过即达到 `ci-passed` 并停止；失败时按 CI 诊断流程处理或形成 blocker；无法唯一确定 CI 协议时报告 `pr-open`、说明缺失证据并建议 `action=ci`，不算失败。PR 创建的既有确认同时覆盖本次 CI 触发，不再单独询问。与完整作者 E2E 的差异只在起点：E2E 由编排器路由进 `ci`，显式 `action=pr` 在本 action 内完成同样的触发与监控；两者到达 `ci-passed` 后都不请求检视、不处理 feedback、不 merge。
 
 ### `pr` 输出
 
@@ -85,8 +113,10 @@ Milestone: <number + exact title inherited from Issue, or none>
 Commits: sha + summary
 Local gates: passed + unrun
 Current head: ...
+CI: triggered + watched, passed head sha | pr-open (protocol undetermined) | blocker
+Next state: ci-passed | pr-open | blocked
 Blocker: none | details
-Suggested next action: ci
+Suggested next action: ci（CI 协议未确定时）| feedback（已有意见）| merge（独立门禁满足时）| 等待外部检视
 ```
 
 ## Action `ci`：CI 监控与恢复
@@ -95,7 +125,7 @@ Suggested next action: ci
 
 只读确认 canonical PR 已存在且 open，source/head/base 可验证，并取得当前 head SHA。PR 不存在时返回 `blocked` 并建议 `action=pr`，不得创建 PR；无法唯一确定 CI 协议时返回 blocker，不得猜测或套用其他仓库协议。
 
-读取 [ci-and-review.md](ci-and-review.md) 的 CI 部分，识别自动 CI、平台 checks、标签/评论、`compile`、外部机器人或其他实际适配器。
+读取 [ci-and-review.md](ci-and-review.md) 的 CI 部分，识别自动 CI、平台 checks、标签/评论、`compile`、外部机器人或其他实际适配器。监控输出与回读固定使用 Skill 随附的 `scripts/gitcode_verify.py`（用法见下文），不再每轮现场生成 python 内联 JSON 解析；脚本输出不完整或与预期不符时按验证失败处理。
 
 以 `<canonical>#<PR> + head SHA` 为幂等键：
 
@@ -105,8 +135,22 @@ Suggested next action: ci
 4. 分类当前改动、连带失败、canonical 基线、基础设施、权限或证据不足；
 5. guided 模式确认修复；`autonomous-ci` 只在已授权最小范围内自动修改、验证、新 commit、push 和重触发；
 6. 新 push 后获取新 head，旧 head 结果失效；
-7. openLiBing detail/log 返回 401/403 时，按 [openlibing-ci.md](openlibing-ci.md) 使用 setup 创建的受管 Python 运行时和其中的 Playwright，并用已有的系统 Chrome/Edge 或 Playwright Chromium 打开可见浏览器；action 内不调用 pip，也不自动下载浏览器。受管运行时不可用时要求运行 `npx msdevflow@latest setup`；用户完成 GitCode 登录/授权且固定 run 验证成功后恢复当前 CI 诊断，浏览器不可用时输出 OAuth 链接并停止为 `blocked: browser-required`；
-8. 循环至当前 head 全绿或形成证据充分的 blocker。
+7. 轮询和回读固定使用 Skill 随附脚本，不每轮现场生成 python 内联解析：
+
+```bash
+# 触发评论发布后逐字回读（说明评论按 body-file，机器命令按 --contains）
+python <skill-scripts-dir>/gitcode_verify.py verify-comment <canonical> <pr-number> --body-file <note-file>
+python <skill-scripts-dir>/gitcode_verify.py verify-comment <canonical> <pr-number> --contains "compile"
+
+# 监控 CI：输出 ci/pipeline 标签与机器人评论摘要（机器人登录名按 ci-and-review.md 识别结果固定）
+python <skill-scripts-dir>/gitcode_verify.py poll-ci <canonical> <pr-number> --comment-author <bot-login>
+
+# 持续监控直到 passed/failed 或超时：自适应间隔，running 时逐步拉长到 --max-interval
+python <skill-scripts-dir>/gitcode_verify.py watch-ci <canonical> <pr-number> --timeout 60
+```
+
+8. openLiBing detail/log 返回 401/403 时，按 [openlibing-ci.md](openlibing-ci.md) 使用 setup 创建的受管 Python 运行时和其中的 Playwright，并用已有的系统 Chrome/Edge 或 Playwright Chromium 打开可见浏览器；action 内不调用 pip，也不自动下载浏览器。受管运行时不可用时要求运行 `npx msdevflow@latest setup`；用户完成 GitCode 登录/授权且固定 run 验证成功后恢复当前 CI 诊断，浏览器不可用时输出 OAuth 链接并停止为 `blocked: browser-required`；
+9. 循环至当前 head 全绿或形成证据充分的 blocker。
 
 重试不能代替根因分析。CI 修复不得扩大 Issue 范围；发现产品实现缺失或方案错误时返回 `blocked` 并建议 `action=develop`，不得把 CI action 变成补开发流程。
 

package/skill/msd/references/setup-and-issue.md

@@ -72,6 +72,12 @@ pr_number（如已有）
 
 从 URL、Git remotes、remote HEAD 和 PR base 交叉验证。canonical 身份不等于写授权。
 
+source repository 按以下优先级确定：
+1. 用户本轮显式提供的 `source` 优先，不得被本地 remote 自动识别结果覆盖。
+2. 本地 remote 精确匹配该 source 且指向同一仓库时直接复用。
+3. 本地没有匹配 remote 时，允许创建 `fork` remote；若已有同名 remote 但指向不同仓库，生成唯一 remote 名或请求用户确认。
+4. 后续 push 和 PR create 必须使用用户指定的 source，不得因后续 remote 探测结果而静默更换。
+
 ### 仓库画像
 
 读取适用范围的 `AGENTS.md`、`CLAUDE.md`、`CONTRIBUTING*`、README、Issue/PR 模板、OWNERS/CODEOWNERS、CI、pre-commit 和测试配置。PR 模板必须来自 canonical repository 最新默认分支，不得从个人 Fork、当前工作分支或本地未提交文件读取。先检查贡献指南或仓库配置明确指定的路径，再依次检查：

package/skill/msd/references/state-and-safety.md

@@ -97,6 +97,19 @@ Agent 创建或修改的 Issue/PR 正文，以及发布的 Issue 评论、PR 普
 - `code-review` 完整检视通过时只发送正文恰好为 `/lgtm` 的评论，不发布检视摘要、前置说明或其他伴随评论；发送前后都回读并确认 `review_head_sha` 未变化，再逐字回读 `/lgtm`。
 - 尾签只标识文本由 msdevflow 发布，不代表 reviewer/approver 身份，也不替代独立审批或仓库门禁。
 
+### 机器人命令分级
+
+所有必须精确匹配的机器人/机器协议命令按风险分级执行，行为不再依赖临场判断：
+
+| 命令 | 风险级别 | 行为 |
+|---|---|---|
+| `/check-cla`、`/check-sign` 等只读状态重检 | 低风险 | 用户明确要求该命令后，可直接发送精确 payload 并回读，无需前置说明评论 |
+| `compile`、`retry`、`stop` 等 CI 触发命令 | 中风险 | 必须先发布带唯一尾签的独立说明评论并逐字回读，再单独发送精确 payload |
+| `/lgtm` | reviewer 门禁 | 仅 `code-review` 完整检视通过且用户针对当前 PR/head 明确确认后发送精确 payload |
+| `/merge`、`/approve` | 最终合入/审批入口 | 仅 `merge` 阶段、门禁满足且用户确认后发送；作者不得发送 `/approve` |
+
+低风险命令的判定标准：命令只触发只读重检或状态刷新，不启动构建、不改变 PR/Issue 状态、不产生审批语义。不确定分类时按中风险处理（前置说明评论 + 精确 payload），不猜测。仓库机器人协议与该分级冲突时以仓库文档为准并记录适配器证据。
+
 ## 授权范围
 
 `autonomous` 授权至少包含 canonical、Issue、source、branch 和目标。授权只适用于该运行，不能扩展到其他 Issue、PR 或仓库。
@@ -115,7 +128,7 @@ Agent 创建或修改的 Issue/PR 正文，以及发布的 Issue 评论、PR 普
 - 自领/修改 Issue assignee 或发布接取评论；
 - 权威证据和用户原始请求无法唯一确定、且会实质改变范围、公共行为、兼容性、性能目标或风险的需求结论和方案选择；
 - 修改范围发生变化；
-- 首次 push；
+- push 目标、分支或 commits 与用户原始请求或本轮已确认计划不同；用户已明确授权提交推送时按 [pr-and-ci.md](pr-and-ci.md) 直接执行，不再单独确认；
 - 创建 PR，包括从目标 Issue 继承的里程碑及创建后必要的 `pr edit --milestone`；
 - 每个非预先授权的 CI 修复方案；
 - 发布 discussion 回复或其他人类可读远端评论；

package/skill/msd/scripts/gitcode_verify.py

@@ -0,0 +1,228 @@
+#!/usr/bin/env python3
+"""Fixed verification helpers for msdevflow pr/ci actions.
+
+Replaces the ad-hoc inline python snippets the workflow used to generate per
+run (PR readback, comment readback, CI label polling). Each subcommand prints
+a small deterministic report; exit code 0 = verified, 3 = verification failed.
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import re
+import subprocess
+import sys
+import tempfile
+from pathlib import Path
+
+SIGNATURE = "——msdevflow"
+DEFAULT_LIMIT = 100
+
+if os.name == "nt":
+    sys.stdout.reconfigure(encoding="utf-8")
+    sys.stderr.reconfigure(encoding="utf-8")
+
+
+def run_gitcode(args: list[str]) -> dict:
+    result = subprocess.run(
+        ["gitcode", *args],
+        capture_output=True,
+        text=True,
+        encoding="utf-8",
+        timeout=120,
+    )
+    if result.returncode != 0:
+        print(f"gitcode {' '.join(args)} failed: exit {result.returncode}", file=sys.stderr)
+        print(result.stderr[-2000:], file=sys.stderr)
+        raise SystemExit(3)
+    return json.loads(result.stdout)
+
+
+def pr_payload(repo: str, number: int) -> dict:
+    return run_gitcode(["pr", "view", str(number), "-R", repo, "--json"])
+
+
+def comments_payload(repo: str, number: int, limit: int) -> list[dict]:
+    data = run_gitcode(["pr", "comments", str(number), "-R", repo, "--limit", str(limit), "--json"])
+    if isinstance(data, list):
+        return data
+    return data.get("comments") or data.get("items") or []
+
+
+def normalize(text: str) -> str:
+    return (text or "").replace("\r\n", "\n").strip()
+
+
+def check(condition: bool, label: str) -> bool:
+    print(f"{'PASS' if condition else 'FAIL'} {label}")
+    return condition
+
+
+def cmd_verify_pr(args: argparse.Namespace) -> int:
+    d = pr_payload(args.repo, args.number)
+    ok = True
+    ok &= check(d.get("state") == "open", f"state=open (actual {d.get('state')})")
+    if args.title:
+        ok &= check(normalize(d.get("title")) == normalize(args.title), "title verbatim")
+    if args.body_file:
+        expected = Path(args.body_file).read_text(encoding="utf-8")
+        ok &= check(normalize(d.get("body")) == normalize(expected), "body verbatim")
+    body = d.get("body") or ""
+    ok &= check(body.count(SIGNATURE) == 1, f"signature exactly once (actual {body.count(SIGNATURE)})")
+    head = d.get("head") or {}
+    ok &= check(bool(head.get("sha")), f"head sha present ({head.get('sha')})")
+    base = (d.get("base") or {}).get("repo") or {}
+    base_name = base.get("full_name") or base.get("path_with_namespace") or base.get("name")
+    ok &= check(base_name == args.repo, f"base repo is canonical (actual {base_name})")
+    if args.issue:
+        ok &= check(f"#{args.issue}" in body, f"body references Issue #{args.issue}")
+    milestone = d.get("milestone") or {}
+    if args.milestone is not None:
+        ok &= check(
+            milestone.get("number") == args.milestone,
+            f"milestone number {args.milestone} (actual {milestone.get('number')})",
+        )
+        ok &= check(bool(milestone.get("title")), f"milestone title present ({milestone.get('title')})")
+    print(f"number={d.get('number')} head={head.get('sha')} milestone={milestone.get('number')} {milestone.get('title') or 'none'}")
+    return 0 if ok else 3
+
+
+def cmd_verify_comment(args: argparse.Namespace) -> int:
+    items = comments_payload(args.repo, args.number, args.limit)
+    expected = normalize(Path(args.body_file).read_text(encoding="utf-8")) if args.body_file else None
+    ok = False
+    for c in items:
+        body = normalize(c.get("body"))
+        if expected is not None and body == expected:
+            ok = True
+            print(f"PASS comment {c.get('id')} by {c.get('user', {}).get('login')} verbatim; sig={body.count(SIGNATURE)}")
+        elif args.contains and args.contains in body:
+            ok = True
+            print(f"PASS comment {c.get('id')} by {c.get('user', {}).get('login')} contains {args.contains!r}")
+    if not ok:
+        print(f"FAIL no matching comment among {len(items)}")
+        for c in items[-5:]:
+            print(f"  recent: {c.get('id')} {(c.get('user') or {}).get('login')} {normalize(c.get('body'))[:120]!r}")
+        return 3
+    return 0
+
+
+def cmd_poll_ci(args: argparse.Namespace) -> int:
+    d = pr_payload(args.repo, args.number)
+    labels = [l.get("name") for l in (d.get("labels") or [])]
+    ci_labels = [name for name in labels if name and ("ci" in name.lower() or "pipeline" in name.lower())]
+    print("labels:", ci_labels or labels)
+    if args.comment_author:
+        items = comments_payload(args.repo, args.number, args.limit)
+        matches = [c for c in items if (c.get("user") or {}).get("login") == args.comment_author]
+        for c in matches[-args.max_comments:]:
+            text = re.sub(r"<[^>]+>", " ", c.get("body") or "")
+            text = re.sub(r"\s+", " ", text).strip()
+            print(f"bot {c.get('id')}: {text[:args.truncate]}")
+        if not matches:
+            print(f"no comments by {args.comment_author} among {len(items)}")
+    head = (d.get("head") or {}).get("sha")
+    print(f"state={d.get('state')} head={head}")
+    return 0
+
+
+PASS_LABELS = {"ci-pipeline-passed", "ci-pipeline-success"}
+FAIL_LABELS = {"ci-pipeline-failed", "ci-pipeline-failure"}
+
+
+def ci_verdict(d: dict) -> str:
+    labels = {l.get("name") for l in (d.get("labels") or [])}
+    if labels & PASS_LABELS:
+        return "passed"
+    if labels & FAIL_LABELS:
+        return "failed"
+    if any(name and ("running" in name.lower()) for name in labels):
+        return "running"
+    return "unknown"
+
+
+def cmd_watch_ci(args: argparse.Namespace) -> int:
+    """Poll CI until passed/failed or timeout. Adaptive intervals: short while
+    unconfirmed, longer once running, with a hard deadline."""
+    import time
+
+    deadline = time.monotonic() + args.timeout * 60
+    delay = args.interval
+    last_head = None
+    verdict = "unknown"
+    polls = 0
+    while time.monotonic() < deadline:
+        polls += 1
+        d = pr_payload(args.repo, args.number)
+        head = (d.get("head") or {}).get("sha") or ""
+        if last_head is not None and head != last_head:
+            print(f"head changed {last_head[:8]} -> {head[:8]}; resetting delay")
+            delay = args.interval
+        last_head = head
+        verdict = ci_verdict(d)
+        elapsed = args.timeout * 60 - max(0, deadline - time.monotonic())
+        print(f"poll#{polls} t+{elapsed:.0f}s verdict={verdict} head={head[:10]}")
+        if verdict in ("passed", "failed"):
+            break
+        time.sleep(min(delay, 60))
+        # adaptive: running pipelines poll less often
+        if verdict == "running":
+            delay = min(delay * 2, args.max_interval)
+        else:
+            delay = args.interval
+    labels = [l.get("name") for l in (d.get("labels") or [])]
+    print(f"final: verdict={verdict} head={last_head} polls={polls}")
+    print("labels:", labels)
+    if verdict == "unknown":
+        print(f"timeout after {args.timeout} minutes without a decisive verdict")
+        return 4
+    return 0 if verdict == "passed" else 3
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description=__doc__)
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    p = sub.add_parser("verify-pr", help="read back a PR and verify title/body/head/milestone")
+    p.add_argument("repo")
+    p.add_argument("number", type=int)
+    p.add_argument("--title", help="expected exact title")
+    p.add_argument("--body-file", help="expected body file (UTF-8)")
+    p.add_argument("--issue", type=int, help="expected Issue number referenced in body")
+    p.add_argument("--milestone", type=int, help="expected milestone number")
+
+    p = sub.add_parser("verify-comment", help="verify a comment was published verbatim")
+    p.add_argument("repo")
+    p.add_argument("number", type=int)
+    p.add_argument("--body-file", help="expected comment body file (UTF-8)")
+    p.add_argument("--contains", help="match comment containing this exact text")
+    p.add_argument("--limit", type=int, default=DEFAULT_LIMIT)
+
+    p = sub.add_parser("poll-ci", help="summarize CI labels and bot comments of a PR")
+    p.add_argument("repo")
+    p.add_argument("number", type=int)
+    p.add_argument("--comment-author", help="filter latest comments by bot login")
+    p.add_argument("--limit", type=int, default=DEFAULT_LIMIT)
+    p.add_argument("--max-comments", type=int, default=3)
+    p.add_argument("--truncate", type=int, default=400)
+
+    p = sub.add_parser("watch-ci", help="poll PR CI labels until passed/failed or timeout")
+    p.add_argument("repo")
+    p.add_argument("number", type=int)
+    p.add_argument("--interval", type=int, default=30, help="initial poll interval seconds")
+    p.add_argument("--max-interval", type=int, default=300, help="max poll interval seconds while running")
+    p.add_argument("--timeout", type=int, default=60, help="give up after this many minutes")
+
+    args = parser.parse_args()
+    if args.command == "verify-pr":
+        return cmd_verify_pr(args)
+    if args.command == "verify-comment":
+        return cmd_verify_comment(args)
+    if args.command == "watch-ci":
+        return cmd_watch_ci(args)
+    return cmd_poll_ci(args)
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())