qa-testability-advocacy
Skill31 starsChanged 48 days agoMITView on GitHub
当测试发现"这个功能测不了"、"加个日志就能定位"、"这个模块没法 Mock"时使用此技能。从可控性(能否控制测试条件)、可观察性(能否看到内部状态)、可隔离性(能否独立测试)、自动化性和可诊断性五个维度评估系统的可测试性水平,给出具体的系统改进建议和推动策略。可测试性差的系统一定质量差——不是因为系统本身不好,是因为你根本测不透它。输出可测试性评估报告和各维度的改造建议。 ⚠️ 本技能含废弃测试清理建议,执行前请确认非关键数据。 触发场景:可测试性、难测、不好测、测试推动、架构改进、可测性评审、需要推动架构改进可测试性时。 Use when the user asks about: assessing and improving system testability — controllability, observability, isolatability, automability, and diagnosability.
In this repository50 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- qa-agent-testingSkill
- qa-ai-blindspot-compensationSkill
- qa-ai-context-engineeringSkill
- qa-ai-output-critiqueSkill
- qa-ai-prompt-strategySkill
- qa-api-testingSkill
- qa-boundary-deep-diveSkill
- qa-bug-lifecycleSkill
- qa-bug-reportingSkill
- qa-bug-root-cause-analysisSkill
- qa-ci-cd-testingSkill
- qa-code-review-for-testSkill
- qa-combination-strategySkill
- qa-critical-thinkingSkill
- qa-domain-modelingSkill
- qa-execution-observationSkill
- qa-expert-reviewSkill
- qa-exploratory-testingSkill
- qa-heuristic-checklistSkill
- qa-input-validationSkill
- qa-mobile-testingSkill
- qa-output-validationSkill
- qa-quality-metricsSkill
- qa-question-frameworkSkill
- qa-regression-testingSkill
- qa-release-risk-governanceSkill
- qa-req-deconstructionSkill
- qa-requirement-reviewSkill
- qa-retrospectiveSkill
- qa-risk-intuitionSkill
- qa-scenario-treeSkill
- qa-shift-leftSkill
- qa-shift-rightSkill
- qa-specialized-testingSkill
- qa-stakeholder-communicationSkill
- qa-state-transitionSkill
- qa-team-coachingSkill
- qa-tech-debt-managementSkill
- qa-tech-selectionSkill
- qa-test-automation-archSkill
- qa-test-case-designSkill
- qa-test-data-engineeringSkill
- qa-test-env-dataSkill
- qa-test-estimationSkill
- qa-test-leadershipSkill
- qa-test-reportingSkill
- qa-test-skillsSkill
- qa-test-strategy-designSkill
The file
Files
⚠️ 本技能单独使用效果有限,建议配合完整技能集(12 步工作流)使用。安装:npx skills add Kokxi/qa-test-skills
可测试性推动
核心原则
在架构评审阶段就能识别可测试性问题,推动开发做可测试设计。
加载时机
| 什么时候读 | 读哪个 |
| 逐维打分或找改进项时,取五维详表 | references/testability-dimensions.md |
可测试性检查维度的完整内容已下沉至references/testability-dimensions.md,避免每次触发都占用上下文。
可测试性评估表
| 维度 | 检查点 | 现状 | 目标 | 差距 | 改进措施 |
| 接口层 | Mock点 | 无 | 有 | 大 | 开发Mock接口 |
| 数据层 | 数据构造 | 手动 | 自动 | 中 | 开发数据工厂 |
| 日志层 | TraceId | 无 | 有 | 大 | 接入链路追踪 |
| 配置层 | 功能开关 | 无 | 有 | 中 | 开发开关平台 |
| 依赖层 | 服务Mock | 无 | 有 | 大 | 开发服务虚拟化 |
可测试性改进建议
短期改进(1-2周)
├─ 接口层:添加测试接口
├─ 数据层:编写数据构造脚本
├─ 日志层:添加关键路径日志
├─ 配置层:添加测试配置项
└─ 依赖层:配置Mock数据中期改进(1-2月)
├─ 接口层:开发Mock平台
├─ 数据层:开发数据工厂
├─ 日志层:接入链路追踪
├─ 配置层:开发开关平台
└─ 依赖层:开发服务虚拟化长期改进(3-6月)
├─ 接口层:契约测试平台
├─ 数据层:测试数据管理平台
├─ 日志层:日志分析平台
├─ 配置层:配置中心
└─ 依赖层:服务治理平台应用场景
评审订单系统的架构设计 → 接口层可测试性:订单接口是否支持Mock?是否有测试桩? → 数据层可测试性:数据库是否支持事务回滚?测试数据隔离? → 日志层可测试性:关键操作是否打印日志?日志级别是否可配置? → 配置层可测试性:功能开关是否支持动态配置?第三方服务地址是否可配置? → 依赖层可测试性:依赖服务是否有Mock方案?是否支持降级?
开发说"这个不好测" → 启动可测试性评估,逐维度分析,给出具体改进建议和沟通话术
自检清单
可测试性评估完成后检查:
- 是否评估了五个维度?
- 是否识别了差距?
- 是否制定了改进计划?
- 改进措施是否可行?
- 是否有时间计划?
检查清单
- 可测试性问题是否识别?
- 影响面是否评估?
- 改进建议是否可行?
- 优先级是否标注?
- 推动策略是否制定?
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

