القائمة
创建、更新或删除 UAT 场景文档，确保以 tmux 终端交互验证为核心，符合 A2C-SMCP SDK 的 UAT 最佳实践。重型场景自动加载对应设计指南。无参数时自动扫描 Git 变更，分析受影响的场景并批量更新。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
执行 A2C-SMCP Python SDK 的用户验收测试（UAT）。通过 tmux MCP 工具在真实终端环境中验证 CLI 命令和端到端协议流程。
Minimal greet skill for strict-mode seed derivation
Minimal review skill for strict-mode seed derivation
Minimal scan skill for strict-mode seed derivation
Well-formed minimal SKILL used as the canonical happy-path source for UAT seed derivation across mcp / marketplace / user sources.
创建、扩充、验收 A2C-SMCP UAT 种子服务与数据。种子按 SKILL 来源（mcp / marketplace / user / _common）分目录组织，每条种子伴随**可执行的验收方法**，供 UAT scenarios 复用。无参数时进入交互向导；带 source+name 则定向走对应 recipe。
| name | uat-scenario |
| description | 创建、更新或删除 UAT 场景文档，确保以 tmux 终端交互验证为核心，符合 A2C-SMCP SDK 的 UAT 最佳实践。重型场景自动加载对应设计指南。无参数时自动扫描 Git 变更，分析受影响的场景并批量更新。 |
| argument-hint | [create|update|delete] <场景名称> （留空则自动扫描 Git 变更） |
你是一名资深 QA 架构师，负责按标准流程管理 A2C-SMCP SDK 的 UAT 场景体系。你的工作 不仅是编写场景文档，还包括分析测试环境依赖（测试仓库、MCP 配置）、生成环境需求报告、 维护场景参考文档的完整性。
/uat-scenario # 无参数：自动扫描 Git 变更，批量评估受影响场景
/uat-scenario create strict-mode # 新建场景
/uat-scenario update marketplace-ops 增加 refresh 失败用例 # 更新场景
/uat-scenario delete deprecated-scenario # 删除场景
/uat-scenario existing:scenarios/marketplace-ops.md # 改造已有场景
如果省略动作前缀，通过上下文推断：提到已有场景名 + 增/改/删描述 →
update；existing: 前缀 → update（改造模式）；描述全新场景 → create。
| 动作 | 触发条件 | 执行路径 |
|---|---|---|
| auto-scan | 参数为空 | → 自动扫描流程 |
| create | 明确 create 或描述的是新场景 | → 创建流程 |
| update | 明确 update/extend/existing: 前缀，后跟已有场景名 | → 更新流程 |
| delete | 明确 delete/remove | → 删除流程 |
$ARGUMENTS
触发条件：
/uat-scenario不带任何参数。目标：检查自 UAT 场景最后更新以来的所有 Git 变更，评估哪些场景需要新增或更新。
git log --format="%ai %H %s" -- ".claude/skills/UAT/resources/scenarios/" | head -5
取第一行的日期时间作为 基准时间 T。
git log --oneline --after="<T>" -- a2c_smcp/ tests/
如果 commit 较多（>15 条），再用 git diff --stat 聚焦关键文件变动：
a2c_smcp/computer/cli/ — CLI 命令变更a2c_smcp/computer/skills/ — SKILL 系统变更a2c_smcp/server/ — Server 协议变更a2c_smcp/agent/ — Agent 客户端变更a2c_smcp/smcp.py — 协议定义变更tests/e2e/ — e2e 测试变更（可能暴露新的测试点）读取 .claude/skills/UAT/resources/scenarios/ 下所有场景文件，提取功能范围关键词。
映射规则：
| 变更特征 | 可能影响的场景 |
|---|---|
cli/commands/marketplace | marketplace-ops.md |
skills/manifest.py, skills/staging.py | strict-mode.md, skill-discovery.md |
skills/resource.py, utils/blob.py | blob-transfer.md |
server/, smcp.py 中的 events | full-protocol.md |
computer/cli/commands/plugin | plugin-management.md |
computer/cli/commands/settings | settings-scope.md |
computer/skills/watcher.py | skill-discovery.md（watcher 相关用例） |
computer/skills/sandbox.py | 新场景（sandbox-security.md） |
smcp.py 中 ErrorCode 变更 | full-protocol.md（错误码验证） |
| 全新的 CLI 子命令或协议事件，无对应场景文件 | → 候选新增场景 |
在执行修改前，先输出分析报告：
## UAT 场景更新扫描报告
**基准时间**：<T>
**新增 commits**：<N> 条
### 受影响场景评估
| 场景文件 | 影响程度 | 建议动作 | 关联变更摘要 |
|---------|---------|---------|------------|
| marketplace-ops.md | 高 | update | feat: marketplace set 新增 strict 选项 |
| strict-mode.md（新） | — | create | feat: 全新的 strict 模式 |
### 可忽略变更
以下变更判断为不影响 UAT 场景（纯重构/类型标注/文档）：
- <commit>: refactor: ...
按影响程度从高到低，对每个需要变更的场景执行对应的 update 或 create 流程。
✅ 本轮扫描完成：更新 X 个场景，新增 Y 个场景，无需变更 Z 个场景。
向用户确认以下信息：
为什么要做这一步？ 测试环境依赖是 UAT 的地基。如果场景需要的测试仓库或 MCP 配置不存在，测试无法执行。 同样地，种子库（
resources/seeds/）是场景的 fixture 唯一来源——若所需 fixture 在种子库不存在，scenario 不允许 inline 长 fixture，必须先通过/uat-seed补齐。
检查 .claude/skills/UAT/resources/test-env-setup.md 中已有的环境配置：
读 resources/seeds/README.md 索引，按场景需求逐条核对：
| 场景需要的 fixture | 检索方向 |
|---|---|
| MCP Server 暴露 SKILL（mounted/archive/resources/混合） | seeds/mcp/ |
| Marketplace 仓库（happy / strict / entry.skills / plugin source 五类 / 失败） | seeds/marketplace/ |
| User 源 DropIn（home / workdir / 覆盖 / 失败） | seeds/user/ |
| SKILL 包 well-formed 或某种 invalid 形态 | seeds/_common/ |
| 检索结果 | 动作 |
|---|---|
| ✅ 全部命中现有 seed | 直接在场景里路径引用：seeds/<source>/<name>；跳到 Step 4 |
| ❌ 缺 N 条 seed | 进入 Step 3.5: 触发 /uat-seed 补缺口 |
| ⚠️ 命中的 seed 当前 audit FAIL | 暂停场景设计 → 提示用户 /uat-seed audit 复现 + 修复 → 修复后回到 Step 2 |
/uat-seed）将报告输出到 .claude/skills/UAT/resources/env-requests/ 目录，文件名格式
env-request-<场景名>.md：
# 环境需求报告 — [场景名称]
> 关联 UAT 场景：`scenarios/<name>.md` 请求日期：YYYY-MM-DD 状态：🟡 待准备 | 🟢 已就绪
## 需求背景
[一句话说明为什么需要这些环境配置]
## 需求清单
### 1. 测试 Marketplace 仓库
| 字段 | 要求 | 说明 |
| ---- | ---- | ---- |
| manifest strict | true/false | 用于测试 strict 模式 |
| plugin 数量 | ≥2 | 用于测试多 plugin 场景 |
| skill 数量 | ≥3 | 用于测试 skill 发现 |
**仓库结构**：[描述或给出目录树]
### 2. MCP Server 配置
[如有需要]
## 对现有环境的影响
- [ ] 不影响现有环境
- [ ] 需要新建测试仓库
- [ ] 需要修改 test-env-setup.md
## 验证方式
[环境准备完成后，如何验证配置正确]
交接动作：报告生成后告知用户，并暂停场景编写直到环境就绪。
/uat-seed 补缺口触发条件：Step 2b 发现场景需要的 fixture 在
seeds/<source>/<name>不存在。
在待写的场景文档顶部加一节（写完场景时若仍有未补齐的缺口则保留）：
## 待补种子（blocks 场景终稿）
| 缺口 | source | 期望 axis | 触发用例 | 期望被测行为（一句话） |
|---|---|---|---|---|
| server_archive_ok | mcp | MC-ARC happy | F-08 | archive 模式 happy path 注册并校验 sha256 |
| strict-false-conflict | marketplace | MK-STR-02 | M-12 | strict=false + plugin.json 声明组件 → installer 硬失败 |
对每个缺口：
a2c-smcp-protocol/docs/specification/skill.md 找对应条款；
若是失败维度还需 failure-axes.md 已登记。找不到 → 不要创建种子——可能是
/add-feature 协议先行（feature_release_branch 记忆），或 axis 拼错。/uat-seed create <source> <name>：按 uat-seed/resources/recipes/<source>.md
走完创建流程（含 acceptance）/uat-seed audit <source> <name>：必须 PASS 才能算补缺口完成seeds/<source>/<name>如果用户决定当前周期不补该缺口：
(skip until seed) 优先级降为 P3根据场景特征，判断类型并加载对应的设计指南：
| 场景类型 | 特征 | 设计指南 |
|---|---|---|
| CLI 命令类 | 仅涉及 CLI 子命令（无需 Server/Computer/Agent） | 无需加载，遵循通用原则 |
| 协议流程类 | 涉及 Agent↔Server↔Computer 完整链路 | resources/guides/protocol-flow.md |
| Marketplace/Plugin 类 | 涉及 marketplace CRUD、strict 模式、plugin 生命周期 | resources/guides/marketplace-plugin.md |
| 二进制/Blob 传输类 | 涉及 SKILL blob handle、二进制 tool_call、SHA256 校验 | resources/guides/blob-transfer.md |
输出到 .claude/skills/UAT/resources/scenarios/<name>.md。
1. UAT ≠ 单元测试
UAT 的本质是站在用户视角验证产品功能，用户操作的是终端命令行，不是 Python API。
严禁出现：
2. 操作成本感知
3. 环境隔离
使用 A2C_SKILL_HOME=/tmp/a2c-uat-skill-home-$$ 隔离环境，避免污染真实配置。
临时目录在清理步骤中删除。
4. 日志可收集
所有进程输出通过 tee 双写到 /tmp/a2c-uat-logs/，确保三端日志可追溯。
| 类型 | 好的断言 | 坏的断言 |
|---|---|---|
| 退出码 | 命令退出码为 0 | 函数无异常抛出 |
| 输出内容 | JSON 输出包含 "skills": 1 | 内部变量值为 1 |
| 错误信息 | 输出包含 "error": "name conflict" | 异常类型为 ValueError |
| 状态变更 | 再次 list 已不包含该 marketplace | 内部缓存已清除 |
| 进程行为 | Computer pane 显示 "connected" | socketio.Client.connected 为 True |
| 文件状态 | clone 目录存在且包含 marketplace.json | Path.exists() 返回 True |
M-01（Marketplace）、F-01（Full-protocol）如果新场景需要特殊的环境配置（如新的测试仓库结构），更新
.claude/skills/UAT/resources/test-env-setup.md 中对应章节。
缩写-NN 规则，无重复A2C_SKILL_HOME 隔离，不污染真实配置seeds/<source>/<name> 路径引用，无 inline 长 fixture/uat-seed audit 状态 = ✅/uat-seed create + audit PASS，
或显式标 (skip until seed) 并降优先级读取 .claude/skills/UAT/resources/scenarios/<name>.md。
| 变更类型 | 示例 | 影响范围 |
|---|---|---|
| 新增用例 | 「增加 marketplace refresh 失败用例」 | 新增用例，可能调整编排策略 |
| 修改用例 | 「M-04 的预期结果需要改」 | 局部修改，保持编排不变 |
| 调整编排 | 「P1 和 P2 用例重新分组」 | 重排结构，检查依赖 |
| 补充验证点 | 「增加退出码验证」 | 在已有用例中追加断言 |
| 修正错误 | 「这个命令路径写错了」 | 直接修正 |
按质量审计清单检查：
| 检查项 | 问题特征 | 改造方向 |
|---|---|---|
| 缺少 tmux 命令步骤 | 用例仅描述"调用函数" | 补充完整终端命令 |
| 断言不基于终端输出 | 断言为"返回 None" | 改为"输出包含 xxx"、"退出码为 0" |
| 缺少环境隔离 | 未设置 A2C_SKILL_HOME | 补充隔离变量 |
| 缺少退出码验证 | 只验证输出不验证退出码 | 补充退出码断言 |
| 缺少错误输出描述 | 异常用例只说"应报错" | 明确具体的错误信息文本 |
| 缺少清理步骤 | 测试后未清理临时文件/目录 | 补充清理命令 |
| inline fixture | 场景文档里直接放 manifest / SKILL.md / server 脚本片段 | 抽到 seeds/<source>/<name>；走 Step 3.5 |
| 引用不存在的 seed | 路径指向 seeds/... 但实际无此目录 | 同上：走 Step 3.5 创建；或修正路径 |
| 依赖 FAIL 的 seed | 引用的 seed 当前 audit ❌ | 暂停 update → 提示用户 /uat-seed audit 复现 → 修复后再回 |
判断场景类型，加载对应指南，确保变更符合设计原则。
读取并编辑场景文件。变更完成后：
读取目标场景文件，展示基本信息，请用户确认。
检查是否有其他场景或文档引用了该场景。
| 指南 | 适用场景 | 文件 |
|---|---|---|
| 协议流程类 | Server+Computer+Agent 完整链路 | resources/guides/protocol-flow.md |
| Marketplace/Plugin 类 | marketplace CRUD、strict 模式、plugin 生命周期 | resources/guides/marketplace-plugin.md |
| 二进制/Blob 传输类 | blob handle、二进制 tool_call、SHA256 校验 | resources/guides/blob-transfer.md |
指南随实践积累持续扩展。当发现新的场景类型有独特的设计模式时，创建新的指南文件并 在此注册。