Skip to content
Back to search

tw-marketplace

MarketplaceWorks with Claude CodeGitHub

TapWitness(见信)UI 自动化测试工作流框架市场(单仓库模式:marketplace 与 plugin 同仓库)/UI automation & E2E testing workflow marketplace for Claude Code

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/penghang1223--tapwitness-ui-automation/badge.svg)](/listings/penghang1223--tapwitness-ui-automation)

HTML

<a href="/listings/penghang1223--tapwitness-ui-automation"><img src="/api/listings/penghang1223--tapwitness-ui-automation/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 16 lines
  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "tw-marketplace",
  4. "description": "TapWitness(见信)UI 自动化测试工作流框架市场(单仓库模式:marketplace 与 plugin 同仓库)/UI automation & E2E testing workflow marketplace for Claude Code",
  5. "owner": {
  6. "name": "TapWitness Maintainers"
  7. },
  8. "plugins": [
  9. {
  10. "name": "tw",
  11. "description": "TapWitness(见信)— UI 自动化测试工作流框架(UI automation / E2E testing):31 个命令、8 阶段状态机、录制驱动、Playwright / Appium / Airtest 4 个域包",
  12. "source": "./",
  13. "category": "testing"
  14. }
  15. ]
  16. }
README.md · README · 143 lines
  1. # TapWitness(见信)
  2. 面向 **UI 自动化测试(UI automation / E2E testing)** 的 Claude Code 插件,用于自动化测试用例开发、UI 回归测试与端到端验证。
  3. 它把用例开发从「凭经验写脚本」变成一条可复用、可核验的流水线:8 个阶段逐段推进,每阶段必须通过 Exit Gate 才能进入下一阶段,状态写在磁盘上,跨会话可恢复。技术栈差异由**域包**吸收(Playwright / Appium / Airtest),项目差异由 **profile** 吸收,命令前缀固定为 `/tw:*`,换技术栈不用换命令。另提供**录制驱动**工作流:手工跑通一次流程,即可派生整套用例。
  4. ## 快速开始
  5. ```bash
  6. claude plugin marketplace add penghang1223/tapwitness-ui-automation
  7. claude plugin install tw@tw-marketplace
  8. ```
  9. 新开会话后 `/tw:` 下应可见 31 个命令。第一次接入项目,最小可跑示例:
  10. ```text
  11. /tw:project-scan # 扫描项目,生成 profile 与脚手架
  12. /tw:new-feature login # 建立 8 阶段工作流
  13. /tw:business-context # 阶段 1:业务知识与三道门
  14. /tw:workflow-next # 按 Exit Gate 推进到下一阶段
  15. ```
  16. 完整流程、自动推进与录制驱动见下方[使用教程](#使用教程)。
  17. ## 两条工作流
  18. | | 8 阶段 | 录制驱动 |
  19. |---|---|---|
  20. | 适用 | 需求明确、从零建用例 | 已能手工跑通一条流程 |
  21. | 入口 | `/tw:new-feature` | `/tw:record-feature` |
  22. | 阶段 | 8:业务知识 → 数据 → 断言 → 用例 → 验证 → E2E → 报告 → 知识反哺 | 5:录制 → 用例生成 → 开发 → 执行 → 审查 |
  23. | 状态文件 | `.claude/workflows/<feature>/state.json` | `.claude/record-workflows/<feature>/record_state.json` |
  24. 两者刻意零耦合,各自独立的协议、状态机与看板。状态文件是唯一真相源,`/tw:continue` 从 `.current` 恢复;阶段中发现的坑点按三层路由回流到域包知识库。
  25. ## 使用教程
  26. ### 第 0 步:接入项目(一次性)
  27. ```text
  28. /tw:project-scan
  29. ```
  30. 扫描宿主项目的技术栈,生成 `.claude/project_profile.md` 与子目录脚手架(`.claude/workflows/`、`.claude/record-workflows/`、看板、`tw_feedback.md`、`CLAUDE.md` 中的 TW 章节)。域包由 `tw/packs/*/pack.yaml` 注册表打分判定,推荐结果需你确认;缺 `CLAUDE.md` 时先执行 `/init`。profile 不记明文密码,只记配置位置与所需环境变量。
  31. ### 工作流 A:从零开发(8 阶段)
  32. ```text
  33. /tw:new-feature login # 建 feature(kebab-case),初始化 state.json、.current、看板
  34. /tw:business-context # 阶段 1:业务知识召回,逐道确认需求背景与用例清单
  35. /tw:ui-test-data # 阶段 2:测试数据构造
  36. /tw:ui-test-assertion # 阶段 3:断言设计与校验点
  37. /tw:ui-test-case # 阶段 4:用例开发 / 页面对象
  38. /tw:verify # 阶段 5:本地验证、探查修复循环
  39. /tw:ui-test-e2e # 阶段 6:端到端 / 全量回归
  40. /tw:report # 阶段 7:开发汇报与覆盖率
  41. /tw:wiki-feedback # 阶段 8:知识反哺,写回知识库
  42. ```
  43. 每阶段结束走 **Exit Gate**:产物齐备且校验器 0 ERROR 才允许推进,状态由 Gate 写入 `state.json`,其他命令不写状态。手动推进时用 `/tw:workflow-next` 读取 `current_stage` 并告诉你下一条该执行的阶段命令。
  44. 按需要选择推进方式:
  45. ```text
  46. /tw:auto login # 半自动:阶段 1/3/4/5 出口暂停,展示 [Enter]/[edit]/[skip]/[exit] 审查门
  47. /tw:auto-full login # 全自动:无暂停;阶段 5 七轮验证用尽或任一校验器 ERROR 即停止报告
  48. /tw:continue # 按 state.mode 从暂停点恢复,不重跑已完成阶段
  49. /tw:workflow-status # 只读查看阶段状态、完成度、待确认项与下一个命令
  50. /tw:workflow-bypass 3 "理由" # 跳过阶段 2(跳过的是目标阶段 -1),写 bypasses 留痕
  51. ```
  52. 跳过阶段会置 `status=skipped` 并记录 `human_intervention`,校验器会对账 `bypasses ↔ skipped`,不留痕的跳阶段不会被接受。
  53. 阶段产物与进度落在 `.claude/workflows/<feature>/state.json` 和 `dashboard.md`;`.claude/workflows/.current` 记住当前 feature,换会话、换机器拉到同一目录即可接着跑。
  54. ### 工作流 B:录制驱动(5 阶段)
  55. ```text
  56. /tw:record-feature login # 建录制 feature 与 record_state.json
  57. /tw:record-capture # 阶段 1:录制主流程(1e 人工核对录制结果)
  58. /tw:record-casegen --single # 阶段 2:拆解录制、派生用例
  59. /tw:record-dev # 阶段 3:写用例代码(3a plan)
  60. /tw:record-run # 阶段 4:执行并修复(最多 7 轮)
  61. /tw:record-review # 阶段 5:独立审核与用例对账
  62. ```
  63. ```text
  64. /tw:record-auto login # 半自动:在 1e / 2 / 3a / 5 暂停等你确认
  65. /tw:record-auto login --full # 全自动:遇证据 degraded、环境/真实 bug、校验器 ERROR 即停并报告
  66. /tw:record-status # 查看录制进度
  67. ```
  68. 状态在 `.claude/record-workflows/<feature>/record_state.json`,与 8 阶段工作流互不干扰。`/tw:record` 是独立录制工具,不进状态机。
  69. ### 辅助命令
  70. | 场景 | 命令 |
  71. |---|---|
  72. | 抓取页面证据 | `/tw:dump-page` |
  73. | 失败归因诊断 | `/tw:ui-test-diagnosis` |
  74. | 派生新场景 | `/tw:ui-test-extend` |
  75. | 提交域层坑点 | `/tw:feedback` |
  76. | 运行环境体检 | `/tw:env-setup` |
  77. | 移动端 MCP 配置 | `/tw:setup-mcp` |
  78. ## 命令(31)
  79. 8 阶段工作流 22 个:`new-feature`、`business-context`、`ui-test-data`、`ui-test-assertion`、
  80. `ui-test-case`、`verify`、`ui-test-e2e`、`report`、`wiki-feedback`、`workflow-status`、
  81. `workflow-next`、`workflow-bypass`、`auto`、`auto-full`、`continue`、`project-scan`、
  82. `env-setup`、`feedback`、`dump-page`、`ui-test-diagnosis`、`setup-mcp`、`ui-test-extend`。
  83. 录制驱动工作流 9 个:`record-feature`、`record-capture`、`record-casegen`、`record-dev`、
  84. `record-run`、`record-review`、`record-auto`、`record-status`、`record`(独立工具,不进状态机)。
  85. ## 域包
  86. | 域包 | version | 录制 |
  87. |---|---|---|
  88. | playwright-python | 1.10.0 | 支持 |
  89. | ios-appium | 1.3.0 | 未实现 |
  90. | android-appium | 1.3.0 | 未实现 |
  91. | android-airtest | 1.3.0 | 未实现 |
  92. ## 文档
  93. - [安装与发布](docs/install.md) · [使用教程](docs/使用教程.md) · [架构设计方案(重建规格书)](docs/架构设计方案.md)
  94. - [验收套件说明](tests/README.md):`python3 tests/run_acceptance.py --official`(含官方 CLI 冒烟与真实会话执行)
  95. - [工具目录与适用范围](tw/tools/README.md) · [录制工作流目录说明](tw/workflows/record-driven/README.md)
  96. ## 反馈
  97. 在宿主项目执行 `/tw:feedback`,坑点先写入 `.claude/tw_feedback.md`。命令会预览目标仓库和正文,用户确认后经 `gh issue create` 提交,成功后回写队列与去重记录。脚本会遮蔽常见敏感格式,自由文本仍须在预览时检查。
  98. - 前置:本机安装并登录 GitHub CLI(`gh auth login`);对公开仓库开 Issue 不需要额外权限。
  99. - 未装 `gh` 或未登录时,反馈保留在本地队列,脚本打印预填链接。远端结果不明确时先核对,避免重复提交。
  100. - 预览:`python3 <插件根>/tw/tools/submit_feedback.py --dry-run`。确认后用 `--yes --approval <预览校验值>` 提交;profile 的 `feedback_channel.auto_submit: false` 保持预览模式。
  101. - 若提交结果不明确,按提示核对目标仓库中的标识,用 `--resolve <KEY> --issue-url <URL>` 记录已创建的 Issue,或在确认未创建后用 `--resolve <KEY> --confirm-absent` 允许重试。
  102. - 也可直接手动新建:[反馈表单](https://github.com/penghang1223/tapwitness-ui-automation/issues/new?template=tw-feedback.yml)。
  103. ## License
  104. [AGPL-3.0](LICENSE) © 2026 TapWitness Maintainers。修改本框架并通过网络提供服务时,需按 §13 向使用者提供对应源码。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.