[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7D74ASSSXYA5G33JMTQSHCP":3,"skill-same:01M7D74ASSSXYA5G33JMTQSHCP":46},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M7D74ASSSXYA5G33JMTQSHCP","ac-blackbox",null,"AllstarCoding 流水环节 10-11 使用。当白盒测试完成、需要探测黑盒执行通道、按三态分流产出黑盒测试文档 v2、在宿主能力允许时自动执行黑盒用例（可选自测）、组织用户核验与修复循环时加载本技能。","hxquan-q\u002Fopen-forge","hxquan-q","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F180607655?v=4","01M7D70QBFWC9ZVGC49W3Y6J1M","xquan","01M7D70QC45F445W6V1AK76JZ7",1,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fhxquan-q\u002Fopen-forge\u002Fblob\u002Fmain\u002Fpackages\u002Fplugins\u002Fpresets\u002Fallstar-coding\u002Fagent\u002Fskills\u002Fac-blackbox\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: ac-blackbox\ndescription: AllstarCoding 流水环节 10-11 使用。当白盒测试完成、需要探测黑盒执行通道、按三态分流产出黑盒测试文档 v2、在宿主能力允许时自动执行黑盒用例（可选自测）、组织用户核验与修复循环时加载本技能。\n---\n\u003C!-- Copyright The Open Forge contributors. -->\n\n# AC 黑盒测试（流水环节 10-11：探测 → 三态分流 → 出文档 →（可选）自测 → 用户核验）\n\n目标：白盒通过后，探测本宿主下 Agent 可用的黑盒执行通道，按三态分流产出**黑盒测试文档 v2**；宿主能力允许时由黑测子自动执行用例并留痕（自测），用户从全量执行者变为**核验者**（环节 11 必经门语义不变，从「用户手动测试」变为「用户终审」）。\n\n**执行者**：探测\u002F出文档\u002F自测\u002F核验回填各由黑测子 spawn（按阶段重生的一次性子代理，写域仅 `docs\u002Fac\u002Fblackbox.md`，T1）；服务起停与环境探测委派 helper；分流交互与核验卡全部由主控发起（黑测子不直接对话用户）。\n\n## 0. 总流程（环节 10-11 内部细化）\n\n```\n环节 10（黑盒准备〔含自测〕）\n  10.1 通道探测      黑测子 spawn#1：按有序清单探测，报告三态结论\n  10.2 分流          主控：情况一→直接继续；情况二→引导用户激活→重新探测；\n                            拒绝\u002F失败→降级手测；情况三→告知用户，出手测版\n  10.3 环境探测      主控委派 helper：读项目配置\u002F代码，产出运行接口卡；\n                      自测模式下并在自测前起被测服务、黑测子 settlement 后停服务\n  10.4 出文档        黑测子 spawn#2：读 docs\u002Fac 上游产物 + 接口卡 → blackbox.md\n  10.5 自测执行      黑测子 spawn#3（仅自测模式）：逐条执行、回填总表、\n                      全部完成后置「待核验」并报告；手测模式本步 skipped\n环节 11（用户核验门，必经）\n  用户逐条核验或整批确认 → 主控转述、黑测子 spawn#4 回填核验列\n  → 全部通过 → 已执行（通过），环节 done → 打 stage 档 → 进环节 12\n```\n\n- 探测与出文档分为两个 spawn：中间夹着三态分流的用户交互（情况一无交互，仍保持统一节奏）。\n- 环节 10 的 userConfirmation 恒为 `not_required`（情况二\u002F三的交互是引导\u002F告知，不设门）；**必经门只在环节 11**。\n\n## 1. 通道探测协议（10.1）\n\n探测对象是「该宿主下 Agent 可用的黑盒执行通道」的**有序清单**（数据而非硬编码；未来新通道往清单加条目，不改流程）：\n\n| 顺序 | 通道 | 探测方法 | 可用判定 |\n|---|---|---|---|\n| 1 | browser_tab | 调 `browser_tab {action:\"snapshot\"}`（L0 读类，免审批） | ok:true → 可用；no_browser_session → 能力在、活动面板浏览器 tab 未开（情况二特征）；工具不在清单 → 本通道不存在 |\n| 2 | agent-browser | shell `agent-browser --version`（在黑测子 shell 白名单内） | exit 0 → 可用 |\n\n三态判定：\n\n- **情况一（可自测）**：任一通道可用。记录命中的**首个**通道为执行通道，不请示直接进入自测。\n- **情况二（能力在但未激活）**：browser_tab 报 no_browser_session 且无其他通道可用。\n- **情况三（无能力）**：全部通道的工具\u002F命令不存在。\n\n不预判项目形态：不按「被测物是否 Web」预分流，只探通道。通道可用但目标不可达（如无 URL 可导航）→ 黑测子报告，降级手测（探测记录注明原因）。\n\n## 2. 三态分流（10.2，主控）\n\n| 情况 | 主控动作 |\n|------|----------|\n| 一 | 直接继续 10.3（无交互） |\n| 二 | ask_user_question 引导用户：**打开活动面板的浏览器 tab**（Agent 无法代开）；同时预告——自测首条写类操作（click\u002Ffill\u002Fpress\u002Fnavigate）会弹一次 L3 工具审批，勾选「记住」后同工具后续免打扰（这是宿主预期行为，不是 bug）。引导后**新 spawn 重新探测**；成功 → 升级情况一；用户拒绝或引导失败 → 降级手测（探测记录注明「用户跳过引导」），**不二次确认** |\n| 三 | 告知用户本宿主无黑盒执行通道，出手测版文档，流水不断 |\n\n降级路径汇总（任何降级都不中断流水）：\n\n| 触发 | 处置 |\n|------|------|\n| 情况二用户拒绝引导 | 手测版文档 |\n| 情况三 | 手测版文档，告知用户 |\n| 通道可用但目标不可达 | 黑测子报告 → 手测版文档（探测记录注明） |\n| 自测中服务崩溃 | 黑测子走 help_protocol 报「待主控处理」→ 主控交 helper 重启 → 复测受影响项 |\n| 自测中通道失效（同工具跨条目连续 3 次报错，stale_reference 不计 \u002F L3 审批被拒 \u002F 面板被关） | 黑测子停止重试，未执行条目自测列留空，报主控（附首条错误原文）→ 主控重探或换备用通道续测剩余条目；确认不可用 → 剩余条目转用户手测，核验门简报首先点名 |\n\n注：自测中用户在 L3 工具审批弹窗点「拒绝」→ 视同通道失效，走上表对应行；引导卡已预告过该弹窗，不重复打扰。\n\n## 3. 环境探测与接口卡（10.3，helper 委派）\n\n主控 spawn helper（task_name `help_env` 前缀）委派**运行环境探测**：读项目配置\u002F代码，产出**运行接口卡**。接口卡是这类委派的输出格式合同（固定五字段），不是对 helper 裁量权的收窄——它照旧按风险分级自行判断怎么办：\n\n```\n- 启动命令: `bun run dev`（仓库根目录）\n- 访问地址: http:\u002F\u002Flocalhost:5173\n- 就绪判定: 打开首页 30 秒内返回内容\n- 依赖安装: 首次运行需先 `bun install`\n- 环境变量: 无\n```\n\n- 服务生命周期：自测模式由 helper 在自测前起、黑测子 settlement 后停（黑测子一次性，不自管进程，避免泄漏）；起长驻进程属 helper 分级语义中「有风险但可控」，回执主控后执行。\n- 信息防火墙：主控把接口卡**原文转述**进黑测子任务书（环境事实流动，实现知识不流动）。\n- 留痕照旧：`[helper] \u003C环节>-\u003C发起者>: \u003C命令摘要> → \u003C结果>`。\n\n## 4. 黑盒文档 v2（10.4，黑测子 spawn#2）\n\n### 4.1 用例设计原则（不变部分）\n\n- **用户能执行\u002F能核验**：每条用例 = 明确操作步骤 + 预期现象，不需要看代码。\n- **覆盖三重心**（用例分组，来源标注不变）：\n  1. **业务逻辑正确性**——requires.md 验收标准（A#）派生的用户可感知场景\n  2. **整体运行稳定**——启动、常规操作连续使用、异常操作不崩\n  3. **新旧功能接洽**——本次改动涉及区域的既有功能回归（design.md 改动面邻近行为）\n- **粒度**：核心路径全写，边缘挑代表；总用例 10-20 条（一屏可扫）。\n- 与白盒用例呼应但不重复（白盒测不到的\"用户感知\"才是黑盒价值）。\n\n### 4.2 文档模板（自测模式；示例数据在出文档时替换为真实用例，结果列初始为空）\n\n````markdown\n# 黑盒测试文档\n\n状态: 待核验\n执行模式: 自测（browser_tab）\n探测记录: 2026-10-05 browser_tab snapshot → ok（面板已开，工具可用）\n最后更新: 2026-10-05 14:30（黑测子）\n\n## 0. 运行环境（接口卡）\n\n> 由辅助者探测产出、主控原文转述。自测模式黑测子据此起验；手测模式用户据此自行启动服务。\n\n- 启动命令: `bun run dev`（仓库根目录）\n- 访问地址: http:\u002F\u002Flocalhost:5173\n- 就绪判定: 打开首页 30 秒内返回内容\n- 依赖安装: 首次运行需先 `bun install`\n- 环境变量: 无\n\n## 1. 结果总表\n\n> 自测列：自测模式逐项填写；手测模式预勾 ✓（语义=跳过自测）。\n> 核验列：用户填写，或用户告知主控、主控转述黑测子代填。\n> 取值：✓=通过 ✗=失败（详见问题清单 P#） 豁=豁免（理由见清单） 空=未进行\n\n| # | 用例（来源） | 自测 | 核验 | 问题描述 |\n|---|---|---|---|---|\n| B1 | 登录后跳转首页（A1） | ✓ | ✓ | — |\n| B2 | 错误密码给出提示（A1） | ✗ | ✗ | P1 |\n| B3 | 连续操作无卡顿崩溃（稳定性） | ✓ | | |\n| B4 | 既有导出功能不受影响（回归） | ✓ | | |\n| B5 | 弱网下保存有反馈（A3） | 豁 | | P2 |\n\n## 2. 用例明细\n\n### 组一：业务逻辑正确性（A# 派生）\n\n#### B1: 登录后跳转首页（对应 A1）\n- 前置: 账号 test@example.com \u002F 密码 123456\n- 测试操作: 1. 打开 \u002Flogin 2. 填入账号密码 3. 点击「登录」\n- 预期: 跳转 \u002Fhome；顶栏显示「test」\n- 自测记录: navigate → fill → click 后 URL=\u002Fhome，顶栏含 test（10-05）\n\n#### B2: 错误密码给出提示（对应 A1）\n- 前置: 账号 test@example.com \u002F 错误密码 000000\n- 测试操作: 1. 打开 \u002Flogin 2. 填入账号与错误密码 3. 点击「登录」\n- 预期: 停留 \u002Flogin；出现「密码错误」类提示\n- 自测记录: 提交后无任何提示，停留原页 → ✗，登记 P1（10-05）\n\n### 组二：整体运行稳定\n\n#### B3: 连续操作无卡顿崩溃（稳定性）\n- 测试操作: 依次访问 首页→列表→详情→设置 并返回，重复 3 轮\n- 预期: 全程响应正常，无白屏、报错弹窗、崩溃\n- 自测记录: 3 轮 12 次导航均正常响应，console 无 error（10-05）\n\n### 组三：新旧功能接洽（回归）\n\n#### B4: 既有导出功能不受影响（回归·design.md 改动面邻近）\n- 测试操作: 列表页点击「导出 CSV」\n- 预期: 正常下载，内容与列表一致\n- 自测记录: 下载成功，行数与列表条数一致（10-05）\n\n#### B5: 弱网下保存有反馈（对应 A3）\n- 前置: 网络受限环境\n- 测试操作: 编辑页修改内容后点击「保存」\n- 预期: 有 loading\u002F重试反馈，不静默失败\n- 自测记录: 自测通道无法模拟弱网 → 豁免登记 P2，交核验定夺（10-05）\n\n## 3. 问题与豁免清单\n\n### P1（B2 · 自测发现 10-05）\n- 现象: 错误密码提交后无提示，停留在登录页\n- 复现: 3\u002F3 次均复现\n- 定位线索: 无（黑盒侧不读实现）\n- 修复状态: 待派发\n\n### P2（B5 · 豁免登记 10-05）\n- 类型: 豁免\n- 理由: 自测通道无法模拟弱网环境\n- 处置: 交用户核验——可实测或确认豁免\n````\n\n### 4.3 手测模式差异（仅三处）\n\n1. 头部：`执行模式: 手测`；探测记录写失败\u002F跳过原因（如「工具不存在」「用户跳过引导」「目标不可达」）。\n2. 总表自测列：**预勾全 ✓**（语义=跳过自测）。\n3. 用例明细：无「自测记录」行。\n\n其余（含接口卡节）与自测模式完全一致。\n\n### 4.4 状态机与更新规则\n\n- 文档头状态：`待执行 → 自测中 → 待核验 → 已执行（通过）| 已执行（含豁免）`；手测模式 `待执行 → 待核验`（跳过中间态）。\n- 结果只落总表；明细只定义用例 + 自测记录留痕，不重复维护结果。\n- 证据落盘全部在 blackbox.md 内（结果总表 + 自测记录行 + P# 清单）；截图留会话附件，核验对话中由主控展示。\n- 失败不中断自测：跑完全部用例后统一报告（现象记入 P#）。\n- 修复不改历史：P# 修复复测通过后，对应 B# 行重勾、P# 的修复状态推进为「已修复复测通过（日期）」，历史记录不删。\n- 豁免不删行，走 P# 清单登记，保留审计痕迹。\n\n## 5. 自测执行（10.5，黑测子 spawn#3，仅自测模式）\n\n黑测子最小权限闭包（权限跟着工具走——「黑测所需工具」需要什么就放什么；未来新通道若需其他命令，围栏白名单加条目即可，权限模型不变）：\n\n| 维度 | 权限 | 实现层 |\n|---|---|---|\n| 写 | 仅 `docs\u002Fac\u002Fblackbox.md` | fence 既有基线（BASELINE_MATRIX.blackbox） |\n| 读 | 仅 `docs\u002Fac\u002F**`（任务书点名 requires\u002Fdesign\u002Fwhitebox\u002Ftasks 路径，直接 read） | fence 读域过滤 |\n| 通道工具 | browser_tab；agent-browser（经 shell 白名单） | function 类放行 + shell 白名单 |\n| shell | 白名单：仅 `agent-browser` 前缀命令；其余全 block（含 git 只读——黑测子不需要 git） | fence 白名单 |\n| spawn \u002F git 写 | 禁（既有） | 既有 |\n\n执行纪律：\n\n1. 逐条执行（按总表顺序），每条完成后**原地回填**自测列与自测记录行（带日期）。\n2. 失败先分类：**工具调用本身的报错**（错误码原文）不是产品失败——零产品证据，该条自测列留**空**、不登记 P#，按第 6 条通道失效处置；**产品行为不符预期**才当场登记 P#（现象\u002F复现次数\u002F定位线索=无），**不中断**，跑完全部用例后统一报告。\n3. 自测通道无法覆盖的场景（如弱网）→ 该条记「豁」+ P# 登记（类型:豁免\u002F理由\u002F处置=交用户核验定夺）。\n4. 全部完成后：文档状态置 `待核验`，报告主控（含 B# 结果摘要与 P# 清单）。\n5. 服务崩溃\u002F环境异常 → 走 help_protocol 报「待主控处理」，等主控交 helper 处置后复测受影响项。\n6. 通道失效（与第 5 条边界：第 5 条管被测服务，本条管自测通道）：**跨条目累计、任一成功清零**——同一工具连续 3 次调用报错（**stale_reference 不计**——重新 snapshot 后重试是正常工作流；no_browser_session \u002F invalid_input \u002F 超时等均计）→ 停止逐条重试（防无限空转）。已执行条目保留真实结果；未执行条目不再调用工具、自测列留**空**；`探测记录` 补一行（时间 + 首条错误原文 + 末条已执行 B#）；文档照常置 `待核验` 并报告主控（首条错误原文必带）→ 主控重探或换备用通道续测剩余条目；确认不可用 → 剩余条目转用户手测，流水不断。\n\n## 6. 用户核验门（环节 11，主控）\n\n1. 主控向用户简报：执行模式、自测结果摘要（通过\u002F失败\u002F豁免计数）、重点请用户过目的条目（失败项、豁免项、关键路径抽查）；**若自测中途通道失效降级，简报第一句点名未自测条目区间（如 B4–B8），请用户重点人工核验**。\n2. **核验卡**（ask_user_question）：选项「全部通过 \u002F 有失败项（编号+现象）\u002F 需豁免裁定」；用户可整批确认或逐条报。\n3. 用户反馈 → 主控转述 → 黑测子 spawn#4 回填核验列（代填，非用户手写）。\n4. 全部通过 → 文档状态 `已执行（通过）`（存在被用户确认的豁免 → `已执行（含豁免）`）；state.md 环节 11 done（userConfirmation confirmed）→ 打 stage 档（`stage 11\u002F黑盒测试: 用户核验通过`，含 blackbox.md 状态更新与黑盒轮修复改动，经轻量 git 子代理 + V4，§0.5）→ 进环节 12（ac-deploy）。\n\n## 7. 反馈处理与修复循环（主控驱动）\n\n| 反馈 | 处理 |\n|------|------|\n| 全部通过 | 收口（见 §6 第 4 步） |\n| 有失败 | 问题逐条登记 P#（现象\u002F复现\u002F定位线索），转入修复循环（§7.1） |\n| 需豁免裁定 | 用户确认豁免 → P# 处置更新「用户确认豁免（日期）」，B# 核验列记「豁」 |\n\n### 7.1 修复循环\n\n1. 自测\u002F核验失败项 → P# 登记（现象\u002F复现\u002F状态）→ 问题定位到任务产物 → `followup_task(dev_t\u003Cn>, ...)` 唤醒对应开发子修复（P# 字段即派发材料，主控直接抄：问题描述+复现步骤+相关 design.md 节+\"修复后说明根因与修法\"）；无法定位 → 主控评估指派新修复子。\n2. 修复后**只复测受影响 B#**（不是全量重走）：黑测子 spawn 复测该批条目，回填结果。\n3. 修复触及核心调用链 → 回白盒补相关用例小循环（既有规则）。\n4. 根因在上游文档 → 既有打回规则（修订标记 + 受影响下游作废重走）。\n5. 修复记录追加 reviews.md「黑盒轮」节（既有约定）供追溯。\n6. 循环直至用户确认全部通过或豁免；轮次上限 3 轮，超限上报裁决。每轮更新 blackbox.md 各条状态与 state.md（executions+1）。\n\n## 8. state.md 映射\n\n- 环节 10 用 subSteps 表达：10.1 探测与分流 \u002F 10.2 出文档 \u002F 10.3 自测执行（手测模式 skipped）；artifacts 均为 `docs\u002Fac\u002Fblackbox.md`；executor blackbox；agentRef 一次性 null。\n- 环节 11：必经门语义为「用户核验」，userConfirmation confirmed 才能 done。\n- 黑盒轮修复计入 executions（沿用 >3 上报）。\n\n## 9. 边界\n\n- 黑盒修复**不受原任务卡限制**：自测\u002F核验暴露的问题就是要修的对象（这是需求的一部分），但修复记录追加进 reviews.md（\"黑盒轮\"节）供追溯。\n- 用户反馈含糊（\"好像有点卡\"）→ 主控先问清复现条件（ask_user_question），不猜着修。\n- 不改内核：browser_tab 的 L3 审批、WebView 生命周期、agent-browser 安装管理全部复用现状；情况二靠用户点开面板（Agent 无代开工具）。\n","\u003C!-- Copyright The Open Forge contributors. -->\n\n# AC 黑盒测试（流水环节 10-11：探测 → 三态分流 → 出文档 →（可选）自测 → 用户核验）\n\n目标：白盒通过后，探测本宿主下 Agent 可用的黑盒执行通道，按三态分流产出**黑盒测试文档 v2**；宿主能力允许时由黑测子自动执行用例并留痕（自测），用户从全量执行者变为**核验者**（环节 11 必经门语义不变，从「用户手动测试」变为「用户终审」）。\n\n**执行者**：探测\u002F出文档\u002F自测\u002F核验回填各由黑测子 spawn（按阶段重生的一次性子代理，写域仅 `docs\u002Fac\u002Fblackbox.md`，T1）；服务起停与环境探测委派 helper；分流交互与核验卡全部由主控发起（黑测子不直接对话用户）。\n\n## 0. 总流程（环节 10-11 内部细化）\n\n```\n环节 10（黑盒准备〔含自测〕）\n  10.1 通道探测      黑测子 spawn#1：按有序清单探测，报告三态结论\n  10.2 分流          主控：情况一→直接继续；情况二→引导用户激活→重新探测；\n                            拒绝\u002F失败→降级手测；情况三→告知用户，出手测版\n  10.3 环境探测      主控委派 helper：读项目配置\u002F代码，产出运行接口卡；\n                      自测模式下并在自测前起被测服务、黑测子 settlement 后停服务\n  10.4 出文档        黑测子 spawn#2：读 docs\u002Fac 上游产物 + 接口卡 → blackbox.md\n  10.5 自测执行      黑测子 spawn#3（仅自测模式）：逐条执行、回填总表、\n                      全部完成后置「待核验」并报告；手测模式本步 skipped\n环节 11（用户核验门，必经）\n  用户逐条核验或整批确认 → 主控转述、黑测子 spawn#4 回填核验列\n  → 全部通过 → 已执行（通过），环节 done → 打 stage 档 → 进环节 12\n```\n\n- 探测与出文档分为两个 spawn：中间夹着三态分流的用户交互（情况一无交互，仍保持统一节奏）。\n- 环节 10 的 userConfirmation 恒为 `not_required`（情况二\u002F三的交互是引导\u002F告知，不设门）；**必经门只在环节 11**。\n\n## 1. 通道探测协议（10.1）\n\n探测对象是「该宿主下 Agent 可用的黑盒执行通道」的**有序清单**（数据而非硬编码；未来新通道往清单加条目，不改流程）：\n\n| 顺序 | 通道 | 探测方法 | 可用判定 |\n|---|---|---|---|\n| 1 | browser_tab | 调 `browser_tab {action:\"snapshot\"}`（L0 读类，免审批） | ok:true → 可用；no_browser_session → 能力在、活动面板浏览器 tab 未开（情况二特征）；工具不在清单 → 本通道不存在 |\n| 2 | agent-browser | shell `agent-browser --version`（在黑测子 shell 白名单内） | exit 0 → 可用 |\n\n三态判定：\n\n- **情况一（可自测）**：任一通道可用。记录命中的**首个**通道为执行通道，不请示直接进入自测。\n- **情况二（能力在但未激活）**：browser_tab 报 no_browser_session 且无其他通道可用。\n- **情况三（无能力）**：全部通道的工具\u002F命令不存在。\n\n不预判项目形态：不按「被测物是否 Web」预分流，只探通道。通道可用但目标不可达（如无 URL 可导航）→ 黑测子报告，降级手测（探测记录注明原因）。\n\n## 2. 三态分流（10.2，主控）\n\n| 情况 | 主控动作 |\n|------|----------|\n| 一 | 直接继续 10.3（无交互） |\n| 二 | ask_user_question 引导用户：**打开活动面板的浏览器 tab**（Agent 无法代开）；同时预告——自测首条写类操作（click\u002Ffill\u002Fpress\u002Fnavigate）会弹一次 L3 工具审批，勾选「记住」后同工具后续免打扰（这是宿主预期行为，不是 bug）。引导后**新 spawn 重新探测**；成功 → 升级情况一；用户拒绝或引导失败 → 降级手测（探测记录注明「用户跳过引导」），**不二次确认** |\n| 三 | 告知用户本宿主无黑盒执行通道，出手测版文档，流水不断 |\n\n降级路径汇总（任何降级都不中断流水）：\n\n| 触发 | 处置 |\n|------|------|\n| 情况二用户拒绝引导 | 手测版文档 |\n| 情况三 | 手测版文档，告知用户 |\n| 通道可用但目标不可达 | 黑测子报告 → 手测版文档（探测记录注明） |\n| 自测中服务崩溃 | 黑测子走 help_protocol 报「待主控处理」→ 主控交 helper 重启 → 复测受影响项 |\n| 自测中通道失效（同工具跨条目连续 3 次报错，stale_reference 不计 \u002F L3 审批被拒 \u002F 面板被关） | 黑测子停止重试，未执行条目自测列留空，报主控（附首条错误原文）→ 主控重探或换备用通道续测剩余条目；确认不可用 → 剩余条目转用户手测，核验门简报首先点名 |\n\n注：自测中用户在 L3 工具审批弹窗点「拒绝」→ 视同通道失效，走上表对应行；引导卡已预告过该弹窗，不重复打扰。\n\n## 3. 环境探测与接口卡（10.3，helper 委派）\n\n主控 spawn helper（task_name `help_env` 前缀）委派**运行环境探测**：读项目配置\u002F代码，产出**运行接口卡**。接口卡是这类委派的输出格式合同（固定五字段），不是对 helper 裁量权的收窄——它照旧按风险分级自行判断怎么办：\n\n```\n- 启动命令: `bun run dev`（仓库根目录）\n- 访问地址: http:\u002F\u002Flocalhost:5173\n- 就绪判定: 打开首页 30 秒内返回内容\n- 依赖安装: 首次运行需先 `bun install`\n- 环境变量: 无\n```\n\n- 服务生命周期：自测模式由 helper 在自测前起、黑测子 settlement 后停（黑测子一次性，不自管进程，避免泄漏）；起长驻进程属 helper 分级语义中「有风险但可控」，回执主控后执行。\n- 信息防火墙：主控把接口卡**原文转述**进黑测子任务书（环境事实流动，实现知识不流动）。\n- 留痕照旧：`[helper] \u003C环节>-\u003C发起者>: \u003C命令摘要> → \u003C结果>`。\n\n## 4. 黑盒文档 v2（10.4，黑测子 spawn#2）\n\n### 4.1 用例设计原则（不变部分）\n\n- **用户能执行\u002F能核验**：每条用例 = 明确操作步骤 + 预期现象，不需要看代码。\n- **覆盖三重心**（用例分组，来源标注不变）：\n  1. **业务逻辑正确性**——requires.md 验收标准（A#）派生的用户可感知场景\n  2. **整体运行稳定**——启动、常规操作连续使用、异常操作不崩\n  3. **新旧功能接洽**——本次改动涉及区域的既有功能回归（design.md 改动面邻近行为）\n- **粒度**：核心路径全写，边缘挑代表；总用例 10-20 条（一屏可扫）。\n- 与白盒用例呼应但不重复（白盒测不到的\"用户感知\"才是黑盒价值）。\n\n### 4.2 文档模板（自测模式；示例数据在出文档时替换为真实用例，结果列初始为空）\n\n````markdown\n# 黑盒测试文档\n\n状态: 待核验\n执行模式: 自测（browser_tab）\n探测记录: 2026-10-05 browser_tab snapshot → ok（面板已开，工具可用）\n最后更新: 2026-10-05 14:30（黑测子）\n\n## 0. 运行环境（接口卡）\n\n> 由辅助者探测产出、主控原文转述。自测模式黑测子据此起验；手测模式用户据此自行启动服务。\n\n- 启动命令: `bun run dev`（仓库根目录）\n- 访问地址: http:\u002F\u002Flocalhost:5173\n- 就绪判定: 打开首页 30 秒内返回内容\n- 依赖安装: 首次运行需先 `bun install`\n- 环境变量: 无\n\n## 1. 结果总表\n\n> 自测列：自测模式逐项填写；手测模式预勾 ✓（语义=跳过自测）。\n> 核验列：用户填写，或用户告知主控、主控转述黑测子代填。\n> 取值：✓=通过 ✗=失败（详见问题清单 P#） 豁=豁免（理由见清单） 空=未进行\n\n| # | 用例（来源） | 自测 | 核验 | 问题描述 |\n|---|---|---|---|---|\n| B1 | 登录后跳转首页（A1） | ✓ | ✓ | — |\n| B2 | 错误密码给出提示（A1） | ✗ | ✗ | P1 |\n| B3 | 连续操作无卡顿崩溃（稳定性） | ✓ | | |\n| B4 | 既有导出功能不受影响（回归） | ✓ | | |\n| B5 | 弱网下保存有反馈（A3） | 豁 | | P2 |\n\n## 2. 用例明细\n\n### 组一：业务逻辑正确性（A# 派生）\n\n#### B1: 登录后跳转首页（对应 A1）\n- 前置: 账号 test@example.com \u002F 密码 123456\n- 测试操作: 1. 打开 \u002Flogin 2. 填入账号密码 3. 点击「登录」\n- 预期: 跳转 \u002Fhome；顶栏显示「test」\n- 自测记录: navigate → fill → click 后 URL=\u002Fhome，顶栏含 test（10-05）\n\n#### B2: 错误密码给出提示（对应 A1）\n- 前置: 账号 test@example.com \u002F 错误密码 000000\n- 测试操作: 1. 打开 \u002Flogin 2. 填入账号与错误密码 3. 点击「登录」\n- 预期: 停留 \u002Flogin；出现「密码错误」类提示\n- 自测记录: 提交后无任何提示，停留原页 → ✗，登记 P1（10-05）\n\n### 组二：整体运行稳定\n\n#### B3: 连续操作无卡顿崩溃（稳定性）\n- 测试操作: 依次访问 首页→列表→详情→设置 并返回，重复 3 轮\n- 预期: 全程响应正常，无白屏、报错弹窗、崩溃\n- 自测记录: 3 轮 12 次导航均正常响应，console 无 error（10-05）\n\n### 组三：新旧功能接洽（回归）\n\n#### B4: 既有导出功能不受影响（回归·design.md 改动面邻近）\n- 测试操作: 列表页点击「导出 CSV」\n- 预期: 正常下载，内容与列表一致\n- 自测记录: 下载成功，行数与列表条数一致（10-05）\n\n#### B5: 弱网下保存有反馈（对应 A3）\n- 前置: 网络受限环境\n- 测试操作: 编辑页修改内容后点击「保存」\n- 预期: 有 loading\u002F重试反馈，不静默失败\n- 自测记录: 自测通道无法模拟弱网 → 豁免登记 P2，交核验定夺（10-05）\n\n## 3. 问题与豁免清单\n\n### P1（B2 · 自测发现 10-05）\n- 现象: 错误密码提交后无提示，停留在登录页\n- 复现: 3\u002F3 次均复现\n- 定位线索: 无（黑盒侧不读实现）\n- 修复状态: 待派发\n\n### P2（B5 · 豁免登记 10-05）\n- 类型: 豁免\n- 理由: 自测通道无法模拟弱网环境\n- 处置: 交用户核验——可实测或确认豁免\n````\n\n### 4.3 手测模式差异（仅三处）\n\n1. 头部：`执行模式: 手测`；探测记录写失败\u002F跳过原因（如「工具不存在」「用户跳过引导」「目标不可达」）。\n2. 总表自测列：**预勾全 ✓**（语义=跳过自测）。\n3. 用例明细：无「自测记录」行。\n\n其余（含接口卡节）与自测模式完全一致。\n\n### 4.4 状态机与更新规则\n\n- 文档头状态：`待执行 → 自测中 → 待核验 → 已执行（通过）| 已执行（含豁免）`；手测模式 `待执行 → 待核验`（跳过中间态）。\n- 结果只落总表；明细只定义用例 + 自测记录留痕，不重复维护结果。\n- 证据落盘全部在 blackbox.md 内（结果总表 + 自测记录行 + P# 清单）；截图留会话附件，核验对话中由主控展示。\n- 失败不中断自测：跑完全部用例后统一报告（现象记入 P#）。\n- 修复不改历史：P# 修复复测通过后，对应 B# 行重勾、P# 的修复状态推进为「已修复复测通过（日期）」，历史记录不删。\n- 豁免不删行，走 P# 清单登记，保留审计痕迹。\n\n## 5. 自测执行（10.5，黑测子 spawn#3，仅自测模式）\n\n黑测子最小权限闭包（权限跟着工具走——「黑测所需工具」需要什么就放什么；未来新通道若需其他命令，围栏白名单加条目即可，权限模型不变）：\n\n| 维度 | 权限 | 实现层 |\n|---|---|---|\n| 写 | 仅 `docs\u002Fac\u002Fblackbox.md` | fence 既有基线（BASELINE_MATRIX.blackbox） |\n| 读 | 仅 `docs\u002Fac\u002F**`（任务书点名 requires\u002Fdesign\u002Fwhitebox\u002Ftasks 路径，直接 read） | fence 读域过滤 |\n| 通道工具 | browser_tab；agent-browser（经 shell 白名单） | function 类放行 + shell 白名单 |\n| shell | 白名单：仅 `agent-browser` 前缀命令；其余全 block（含 git 只读——黑测子不需要 git） | fence 白名单 |\n| spawn \u002F git 写 | 禁（既有） | 既有 |\n\n执行纪律：\n\n1. 逐条执行（按总表顺序），每条完成后**原地回填**自测列与自测记录行（带日期）。\n2. 失败先分类：**工具调用本身的报错**（错误码原文）不是产品失败——零产品证据，该条自测列留**空**、不登记 P#，按第 6 条通道失效处置；**产品行为不符预期**才当场登记 P#（现象\u002F复现次数\u002F定位线索=无），**不中断**，跑完全部用例后统一报告。\n3. 自测通道无法覆盖的场景（如弱网）→ 该条记「豁」+ P# 登记（类型:豁免\u002F理由\u002F处置=交用户核验定夺）。\n4. 全部完成后：文档状态置 `待核验`，报告主控（含 B# 结果摘要与 P# 清单）。\n5. 服务崩溃\u002F环境异常 → 走 help_protocol 报「待主控处理」，等主控交 helper 处置后复测受影响项。\n6. 通道失效（与第 5 条边界：第 5 条管被测服务，本条管自测通道）：**跨条目累计、任一成功清零**——同一工具连续 3 次调用报错（**stale_reference 不计**——重新 snapshot 后重试是正常工作流；no_browser_session \u002F invalid_input \u002F 超时等均计）→ 停止逐条重试（防无限空转）。已执行条目保留真实结果；未执行条目不再调用工具、自测列留**空**；`探测记录` 补一行（时间 + 首条错误原文 + 末条已执行 B#）；文档照常置 `待核验` 并报告主控（首条错误原文必带）→ 主控重探或换备用通道续测剩余条目；确认不可用 → 剩余条目转用户手测，流水不断。\n\n## 6. 用户核验门（环节 11，主控）\n\n1. 主控向用户简报：执行模式、自测结果摘要（通过\u002F失败\u002F豁免计数）、重点请用户过目的条目（失败项、豁免项、关键路径抽查）；**若自测中途通道失效降级，简报第一句点名未自测条目区间（如 B4–B8），请用户重点人工核验**。\n2. **核验卡**（ask_user_question）：选项「全部通过 \u002F 有失败项（编号+现象）\u002F 需豁免裁定」；用户可整批确认或逐条报。\n3. 用户反馈 → 主控转述 → 黑测子 spawn#4 回填核验列（代填，非用户手写）。\n4. 全部通过 → 文档状态 `已执行（通过）`（存在被用户确认的豁免 → `已执行（含豁免）`）；state.md 环节 11 done（userConfirmation confirmed）→ 打 stage 档（`stage 11\u002F黑盒测试: 用户核验通过`，含 blackbox.md 状态更新与黑盒轮修复改动，经轻量 git 子代理 + V4，§0.5）→ 进环节 12（ac-deploy）。\n\n## 7. 反馈处理与修复循环（主控驱动）\n\n| 反馈 | 处理 |\n|------|------|\n| 全部通过 | 收口（见 §6 第 4 步） |\n| 有失败 | 问题逐条登记 P#（现象\u002F复现\u002F定位线索），转入修复循环（§7.1） |\n| 需豁免裁定 | 用户确认豁免 → P# 处置更新「用户确认豁免（日期）」，B# 核验列记「豁」 |\n\n### 7.1 修复循环\n\n1. 自测\u002F核验失败项 → P# 登记（现象\u002F复现\u002F状态）→ 问题定位到任务产物 → `followup_task(dev_t\u003Cn>, ...)` 唤醒对应开发子修复（P# 字段即派发材料，主控直接抄：问题描述+复现步骤+相关 design.md 节+\"修复后说明根因与修法\"）；无法定位 → 主控评估指派新修复子。\n2. 修复后**只复测受影响 B#**（不是全量重走）：黑测子 spawn 复测该批条目，回填结果。\n3. 修复触及核心调用链 → 回白盒补相关用例小循环（既有规则）。\n4. 根因在上游文档 → 既有打回规则（修订标记 + 受影响下游作废重走）。\n5. 修复记录追加 reviews.md「黑盒轮」节（既有约定）供追溯。\n6. 循环直至用户确认全部通过或豁免；轮次上限 3 轮，超限上报裁决。每轮更新 blackbox.md 各条状态与 state.md（executions+1）。\n\n## 8. state.md 映射\n\n- 环节 10 用 subSteps 表达：10.1 探测与分流 \u002F 10.2 出文档 \u002F 10.3 自测执行（手测模式 skipped）；artifacts 均为 `docs\u002Fac\u002Fblackbox.md`；executor blackbox；agentRef 一次性 null。\n- 环节 11：必经门语义为「用户核验」，userConfirmation confirmed 才能 done。\n- 黑盒轮修复计入 executions（沿用 >3 上报）。\n\n## 9. 边界\n\n- 黑盒修复**不受原任务卡限制**：自测\u002F核验暴露的问题就是要修的对象（这是需求的一部分），但修复记录追加进 reviews.md（\"黑盒轮\"节）供追溯。\n- 用户反馈含糊（\"好像有点卡\"）→ 主控先问清复现条件（ask_user_question），不猜着修。\n- 不改内核：browser_tab 的 L3 审批、WebView 生命周期、agent-browser 安装管理全部复用现状；情况二靠用户点开面板（Agent 无代开工具）。\n",{"name":5,"description":7},"main","5b8347d653ab3cc1323c53dbeddd4c009b330d96","packages\u002Fplugins\u002Fpresets\u002Fallstar-coding\u002Fagent\u002Fskills\u002Fac-blackbox",0,"https:\u002F\u002Fgithub.com\u002Fhxquan-q\u002Fopen-forge","https:\u002F\u002Fwww.openvetta.com","https:\u002F\u002Fgithub.com\u002Fhxquan-q","2026-11-13 17:08:23",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add hxquan-q\u002Fopen-forge --skill ac-blackbox",{"tool":38,"command":39},"bunx","bunx skills add hxquan-q\u002Fopen-forge --skill ac-blackbox",{"tool":41,"command":42},"pnpm","pnpm dlx skills add hxquan-q\u002Fopen-forge --skill ac-blackbox","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fhxquan-q\u002Fopen-forge\u002Fblob\u002Fmain\u002Fpackages\u002Fplugins\u002Fpresets\u002Fallstar-coding\u002Fagent\u002Fskills\u002Fac-blackbox\u002FSKILL.md",true,[],[47,54,61,68,75,82],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":19},"01M7D79WJRKSSY9DXVHJ8VXS2G","review-canvas","Present a multi-file code review as a Canvas diff artifact. Use when the user asks for a review, 代码评审, 变更审查, or a cross-file summary of changes — not for a single edit (the chat diff card already shows it) or a prose report (report-canvas).","https:\u002F\u002Fgithub.com\u002Fhxquan-q\u002Fopen-forge\u002Fblob\u002Fmain\u002Fpackages\u002Fskill-presets\u002Freview-canvas\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M7D79QD1TTMEJSC0XQN8ADSJ","report-canvas","Produce a standalone report, audit board, or long-form analysis as a Canvas artifact. Use when the user asks for a report, 报告, 审计看板, or a deliverable that should live beside chat — not when they only want a short chat answer or to inspect a live web page.","https:\u002F\u002Fgithub.com\u002Fhxquan-q\u002Fopen-forge\u002Fblob\u002Fmain\u002Fpackages\u002Fskill-presets\u002Freport-canvas\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M7D79JZ390ZN0950BFNQGE6J","publish-ability","Publish a skill, scene, MCP server, plugin, or bundle to the Vetta ability marketplace. Use when the user asks to upload\u002Fpublish\u002Fsubmit an ability, put a plugin on the marketplace, share a skill with other users, or migrate an existing package into Vetta.","https:\u002F\u002Fgithub.com\u002Fhxquan-q\u002Fopen-forge\u002Fblob\u002Fmain\u002Fpackages\u002Fskill-presets\u002Fpublish-ability\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M7D79DP3TX2CCZBT0W8CTZKT","install-ability","在本机 Vetta 中安装能力——插件（plugin）、Skill\u002F场景（scene）与 MCP 服务器。用户说「装一个插件 \u002F install plugin \u002F 从能力市场安装 \u002F 加一个 MCP server \u002F 配置 MCP \u002F 装个 skill」，或插件装完没生效、需要 reload、pending 版本没应用时使用。不用于安装 npm 依赖、IDE 插件、浏览器扩展，也不用于开发插件（那是 plugin-workbench）或创作 Skill（那是 create-skill）。","https:\u002F\u002Fgithub.com\u002Fhxquan-q\u002Fopen-forge\u002Fblob\u002Fmain\u002Fpackages\u002Fskill-presets\u002Finstall-ability\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M7D799QHEKZBTFA47YXAWFJS","database-analysis","Answer business questions from connected databases with read-only queries, then analyze metrics, trends, rankings, breakdowns, and period comparisons. Use for 问数、查数、数据库分析、销量\u002F收入\u002F用户指标、同比环比 or follow-up data questions. Not for application database migrations or modifying records.","https:\u002F\u002Fgithub.com\u002Fhxquan-q\u002Fopen-forge\u002Fblob\u002Fmain\u002Fpackages\u002Fskill-presets\u002Fdatabase-analysis\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M7D795QA8HPGGC6NJ6J5EEJC","create-skill","Create or update Vetta-compatible Agent Skills. Use when the user asks to create a skill, add a SKILL.md workflow, register a skill in skills-manifest.json, package a skill in a Vetta plugin, or add a built-in Vetta skill preset.","https:\u002F\u002Fgithub.com\u002Fhxquan-q\u002Fopen-forge\u002Fblob\u002Fmain\u002Fpackages\u002Fskill-presets\u002Fcreate-skill\u002FSKILL.md",[],[]]