Home / mingdui / ming-qa · CLAUDE.md · GitHub

CLAUDE.md claudeA

CLAUDE.md is agent-read markdown (claude) from mingdui/ming-qa.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# ming-qa

端到端 QA 验收工具包:`skills/` 下 8 个 skill + 一个 Python CLI。
运行时**零第三方依赖**(只用标准库),开发期只多一个 pytest。

## 常用命令

```bash
cd skills/quality-assurance-agent
python -m pytest tests/ -q          # 48 个测试文件;任何改动后必跑

cd ../..                             # 回仓库根
python skills/quality-assurance-agent/scripts/qa_agent.py check-mojibake . --strict
```

## 改动的验收标准

**修 bug 必须验证判别力**:把修复回滚掉,确认对应用例**变红**,再恢复。

只写一个「能通过」的测试不算完成——要能证明它在**没有这个修复时会失败**。
仓库里既有提交都按这条做过,新改动请保持一致。

## 这个仓库特有的三个坑

1. **提交信息不要用 heredoc 传中文。** Windows + Git Bash 会把中文写成乱码字符
   (U+FFFD),而 pytest 抓不到——它扫仓库文件,不扫 git 历史。
   稳妥做法:用 Write 写进临时文件,再 `git commit -F <文件>`。
   注意:本文件自身也不能出现那个字面字符,否则会被 `test_source_mojibake` 判违规。

2. **提交前确认 git 身份。** 全局配置是公司邮箱;本仓库已用**仓库级**身份覆盖为
   `mingdui`。不要动全局配置,也不要把它改回去。

3. **内部标识扫描会拒绝合并。** CI 拦内部项目名、业务词、私有网段 IP
   (规则见 `.github/workflows/ci.yml` 的 `SENTINELS`)。
   写测试示例用中性词,IP 用 RFC 5737 文档网段(`192.0.2.x`)。
   业务模块名和 API 路径也在此列——它们最容易从内部项目抄进测试注释。

## `qa_agent.py` 是 11000 行单文件

改动前按函数名定位,别整文件读。主要入口:

| 区域 | 函数 |
|---|---|
| CLI 分发 | `build_parser` · `run_with_env` · `aggregate_runs` · `render_report` |
…

Read the whole file at its exact version.

How to install

Latest version
mdr add mingdui/ming-qa/CLAUDE.md@git:20260920.56e926f
Exact content
mdr add mingdui/ming-qa/CLAUDE.md@sha256:b635a814a32674ba

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_oa4hnb3l7x36mcco.svg)](https://markdownregistry.com/a/art_oa4hnb3l7x36mcco)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260920.56e926f latest2026-09-20 56e926f 2,830 BA view

Audit of the latest version

A  14 of 14 checks passed. Deterministic, no model, same answer every run.
  • pass: Size between 200 bytes and 200 KB (2830 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

GitHub

mingdui/ming-qa · 28 stars · license MIT · pushed 2026-09-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_oa4hnb3l7x36mcco
GET https://markdownregistry.com/api/v1/resolve?ref=mingdui/ming-qa/CLAUDE.md
GET https://markdownregistry.com/api/v1/blob/b635a814a32674baa6909ee57e445b1bae9671fcf2695ecdba308aa9dd98ae78

Your agent 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.

More from mingdui/ming-qa

qa-code-reviewer skill
mingdui/ming-qa · skills/qa-code-reviewer/SKILL.md · QA 流程倒数第二步的独立审查环节。在 qa-test-runner 执行完成后,以独立视角审查代码本身——检查架构、安全、并发正确性、数据一致性、 回归风险、测试覆盖缺口——不受执行方结论的影响。产出…
git:20260918.2d0e957 · audit A · 28 stars
qa-context-profiler skill
mingdui/ming-qa · skills/qa-context-profiler/SKILL.md · QA 上游阶段——为仓库构建事实画像和环境证据。当你需要收集模块的代码上下文、索引已有用例和测试、 检查前后端服务可达性、准备环境快照时触发。只收集事实,不做风险分析、不写用例、不判断质量。 通常在…
git:20260918.2d0e957 · audit A · 28 stars
qa-report-generator skill
mingdui/ming-qa · skills/qa-report-generator/SKILL.md · QA 流程的收口阶段——汇总执行(completion)、审查(code-review)、就绪(readiness)三个门禁产物,渲染最终 HTML 报告,给出最终就绪判定。 在 qa-test-runner…
git:20260918.2d0e957 · audit A · 28 stars
qa-risk-analyzer skill
mingdui/ming-qa · skills/qa-risk-analyzer/SKILL.md · 在测试用例设计之前,先识别高风险业务路径和必需的验证断言(oracle)。分析需求文档、代码 diff、已有用例和上下文, 找出资金/权限/状态机/并发/异步/数据一致性等高危区域,输出每条风险的…
git:20260920.56e926f · audit A · 28 stars
qa-test-runner skill
mingdui/ming-qa · skills/qa-test-runner/SKILL.md · 在 spec-task 和测试脚本就绪后,逐条执行、分类失败、修最小根因、收集证据、跑 completion 门禁。 你只负责"跑"——不生成报告、不审查代码、不判 Ready。审查留给 qa-code-reviewer,报告与判定留给…
git:20260918.2d0e957 · audit B · 28 stars
qa-test-script-generator skill
mingdui/ming-qa · skills/qa-test-script-generator/SKILL.md · 在用户确认用例之后,把已确认的业务用例展开为可执行的 spec-task 和测试脚本。你产出的是 test-spec-tasks.json——后续执行阶段通过它逐条运行并收集证据。…
git:20260920.56e926f · audit A · 28 stars
qa-testcase-designer skill
mingdui/ming-qa · skills/qa-testcase-designer/SKILL.md · 在风险分析完成后、写测试代码之前,生成中文业务用例并等待用户确认。这是整个 QA 流程中唯一的强制人工门禁——确认后不可回头改用例。 从 context、risk-analysis、已有用例索引出发,生成只含业务行为的…
git:20260918.f90ddaf · audit A · 28 stars
quality-assurance-agent skill
mingdui/ming-qa · skills/quality-assurance-agent/SKILL.md · 端到端 QA 验收编排器。当用户要求做功能验收、回归测试、质量检查、或对某个模块/流程/branch/PR进行系统化测试时触发。 作为顶层路由器,按阶段调度子 skill(上下文收集 → 风险分析 → 用例设计 → 脚本生成 →…
git:20260920.56e926f · audit A · 28 stars

Every file in mingdui/ming-qa

Other files named CLAUDE.md

CLAUDE.md claude
obra/superpowers · CLAUDE.md
git:20260919.5bf4e78 · audit B · 291,204 stars
CLAUDE.md claude
affaan-m/ecc · CLAUDE.md
git:20260528.04c68e4 · audit A · 266,832 stars
CLAUDE.md claude
firecrawl/firecrawl · CLAUDE.md
git:20260615.fe8d358 · audit A · 184,144 stars
CLAUDE.md claude
garrytan/gstack · CLAUDE.md
git:20260924.06ed920 · audit A · 134,082 stars
CLAUDE.md claude
juliusbrussee/caveman · CLAUDE.md
git:20260908.bb1cfc8 · audit B · 107,708 stars
CLAUDE.md claude
addyosmani/agent-skills · CLAUDE.md
git:20260720.8fd2081 · audit A · 98,554 stars
CLAUDE.md claude
nexu-io/open-design · CLAUDE.md
git:20260430.9b57c22 · audit B · 97,933 stars
CLAUDE.md claude
thedotmack/claude-mem · CLAUDE.md
git:20260723.e29d221 · audit A · 94,550 stars

Browse by kind, by grade A, or by owner.