test-scenarios SKILL.md skillA
test-scenarios from jimyag/dotfiles is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add jimyag/dotfiles/test-scenarios@git:20261015.f79eac0Pins git:20261015.f79eac0 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- jimyag/dotfiles
- Path
skills/test-scenarios/SKILL.md- Versions recorded
- 6
- Latest version
- git:20261015.f79eac0, committed Oct 15, 2026
- First version recorded
- Sep 18, 2026
- Size
- 12,090 bytes
- Repository stars
- 11
- License
- MIT
Use this skill when the user asks for a test plan, acceptance criteria, E2E checklist, or auditable scenario contract for a non-trivial change; do not use it for simple single-point edits or as a replacement for implementing tests.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# 测试场景契约 ## 目标 在代码实现前把“什么行为必须成立”写成可追踪的场景清单，供实现、测试、评审和人工验收共同使用。场景契约描述验收边界，不是把所有测试代码提前写完。 ## 何时使用 - 新功能或修复会改变用户、API、配置、数据、任务状态或外部服务行为。 - 变更跨越多个模块，存在边界、兼容性、权限、恢复或失败路径。 - 用户要求测试计划、验收标准、E2E 清单，或需要把验证结果整理成可审计文档。 ## 何时不要使用 - 纯拼写、格式、注释或机械重命名。 - 需求和验证方式已经明确，且改动是局部、可逆的单点修改。 - 只需要执行已有测试，不需要新增行为边界。 ## 输入与边界 先读取适用的项目指令、现有测试和相邻实现。明确目标、运行环境、外部依赖、成功标准和会改变验收判断的约束；事实可以从代码、文档或工具确认时，不要把它们变成用户问题。 如果目标仍有会实质改变结果的歧义，先转交 `brainstorming` 收敛目标，不要在场景表里猜测产品行为。不要因为缺少场景契约就擅自扩大实现范围。 ## 最小流程 1. 写下本次变更的目标、关键约束和验收入口。 2. 读取现有测试，标记哪些行为已有覆盖，避免把历史测试重新当成新证据。 3. 按需要枚举：主流程、边界输入、错误处理、兼容性、权限/安全、并发/恢复和人工运行面。只保留会改变实现或验收判断的场景。 4. 为每个场景分配稳定 ID、类型、优先级和状态。 5. 将场景写入默认路径 `docs/dev/<run-slug>/test-scenarios.md`；如果已有 ADR，优先放在 ADR 旁边，使用同一个 slug。 6. 实现和验证过程中更新 `covered` 或 `skipped`，并在 `Evidence` 中记录测试路径、命令、日志、资源状态或跳过原因。 7. 如果包含 `e2e` 或 `manual` 场景，补一份短验收指南：准备条件、用户动作、可观察结果、场景 ID 映射，以及哪些结论仍只能由自动化验证证明。 如果用户只要求列出场景而没有授权写文件，直接在回复中输出契约，不创建持久文件。 ## 场景契约格式 ```markdown # <任务名> 测试场景 ## 范围 - 目标：... - 环境与约束：... - 角色与权限：... - 初始条件与测试数据：... - 外部依赖：... - 完成后的状态与清理：... ## 场景 | ID | Scenario | Given / When / Then | Type | Priority | Status | Evidence | |---|---|---|---|---|---|---| …
Read the whole file at its exact version.
How to install
mdr add jimyag/dotfiles/test-scenarios@sha256:5bd669219b000d1aThe line at the top of this page pins the label git:20261015.f79eac0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_jqwwjzpn5qqfy356)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 6 versions of this file, between Sep 18, 2026 and Oct 15, 2026, about one every 5 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261015.f79eac0 latest | 2026-10-15 | f79eac0 | 12,090 B | A | view · diff |
| git:20260929.603248c | 2026-09-29 | 603248c | 11,166 B | A | view · diff |
| git:20260927.a7267d0 | 2026-09-27 | a7267d0 | 11,007 B | A | view · diff |
| git:20260920.878daed | 2026-09-20 | 878daed | 11,011 B | A | view · diff |
| git:20260919.361331b | 2026-09-19 | 361331b | 11,011 B | A | view · diff |
| git:20260918.f8de0f4 | 2026-09-18 | f8de0f4 | 9,578 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (12090 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
jimyag/dotfiles · 11 stars · license MIT · pushed 2026-10-20 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_jqwwjzpn5qqfy356 GET https://markdownregistry.com/api/v1/resolve?ref=jimyag/dotfiles/test-scenarios GET https://markdownregistry.com/api/v1/blob/5bd669219b000d1a11d745354fdf49ddf58d1ee0f4c7a60d4a37f9a0723bc819
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.