메뉴
创建、更新或删除 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 |
指南随实践积累持续扩展。当发现新的场景类型有独特的设计模式时，创建新的指南文件并 在此注册。