baodhgbaodhg/FLOW/skills/flow-test/SKILL.md

flow-test

Skill2 starsChanged 6 days agoMITView on GitHub

Dùng khi viết, chỉnh, chuyển chỗ hoặc đánh giá test trong repo có `.flow/`, gồm test cho task trong plan, test giữ lỗi không quay lại, test hợp đồng, test cho script kiểm hoặc hook, test đồng thời; hoặc khi xanh mà chưa tin. Người dùng hay nói "thêm test", "test trước", "sao test vẫn xanh", "test này chạy thật không", "đủ test chưa".

3 other projects use a version of this.

Adopted by

Most recently taken up by

emiliodominguez/flow-skillstheir own version, first seen Oct 15, 2026
fancylight/skillstheir own version, first seen Jul 23, 2026
timeyour/agentskills-audit-collectiontheir own version, first seen May 24, 2026

Other versions3 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 3
emiliodominguez/flow-skills★ 1same name
fancylight/skills★ 1same name
timeyour/agentskills-audit-collection★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository13 other files it gives its agents.
- flow-contextSkill
- flow-executeSkill
- flow-exploreSkill
- flow-initSkill
- flow-learnSkill
- flow-planSkill
- flow-postSkill
- flow-reviewSkill
- flow-runbookSkill
- flow-secretsSkill
- flowSkill
- flow-syncSkill
- flow-worktreeSkill

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.

≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Distinctive:
Test phải có khả năng thất bại.
line 8

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

SKILL.md

flow-test — thiết kế test

Test phải có khả năng thất bại. Test không thể đỏ thì không chứng minh gì.

Vòng đỏ-xanh

Viết test, chạy, thấy đỏ.
Đọc thông báo đỏ: phải đỏ đúng lý do. Đỏ vì lỗi import hay sai fixture thì chưa tính.
Viết mã, chạy, thấy xanh.
Kiểm test thật sự được chạy: đếm số test trước và sau, số phải tăng đúng phần đã thêm, vì mẫu lọc sai có thể cho xanh với không test nào.
Lỗi khó: tạm tháo bản sửa, xác nhận test đỏ lại, rồi trả bản sửa về.

Lệnh chạy một test và đếm test theo stack: references/stacks.md.

Thiết kế ca

Đối chứng âm và dương: Member đủ điều kiện được mượn, Member đang nợ quá hạn bị từ chối. Thiếu một chiều thì test có thể xanh nhờ hàm luôn trả cùng một kết quả.
Biên: rỗng, một phần tử, đúng ngày hẹn trả, trước và sau một ngày.
Idempotency: gọi hai lần trả Loan thì trạng thái và phí không đổi ở lần hai.
Đồng thời: hai Member cùng mượn cuốn cuối cùng thì chỉ một người được. Dùng tiến trình hoặc kết nối thật, không dùng mock.
Fixture đủ lớn: phân trang, chỉ mục, bộ đệm chỉ lộ lỗi khi vượt ngưỡng.
Mock quá nhiều thì không chứng minh hiệu ứng: nếu test chỉ xác nhận mock được gọi, hãy đọc lại trạng thái thật trong CSDL.
Tên ca mô tả hành vi: từ chối gia hạn khi đã gia hạn một lần, không phải test renew 2. Ngôn ngữ theo language.team.

Công cụ kiểm và hook

Công cụ kiểm cũng là mã và cần test.

Logic thuần, phụ thuộc tiêm vào: hệ tệp, git, đồng hồ đều truyền vào để test được.
Chạy offline, không cần mạng hay dịch vụ ngoài.
Đổi từng yếu tố một giữa các ca, để biết yếu tố nào quyết định kết quả.
Có ca tự đối chứng: một đầu vào biết chắc phải bị bắt, chạy cùng mỗi lần. Ca này không đỏ nghĩa là công cụ hỏng.
Neo theo ngữ nghĩa, không theo số dòng hay thứ tự in, để công cụ không gãy khi đổi định dạng.
Công cụ đỏ thường trực phải sửa hoặc gỡ, vì đỏ quen mắt thì không ai đọc nữa.

Đặt test

Theo quy ước đo được của repo: flow fingerprint và các test xung quanh. Không mang cấu trúc từ repo khác. Dời test thì đếm trước và sau để chắc không mất ca.

Mẫu báo cáo

Ca đã thêm:     <tên ca>
Đỏ trước:       <thông báo đỏ, đúng lý do không>
Xanh sau:       <lệnh>
Đếm:            <trước> → <sau>
Đối chứng:      <âm, dương, hoặc tháo bản sửa>
Chưa kiểm được: <gì, vì sao>

Download now (ZIP)

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

What did you use it for? e.g. Reviewing pull requests in a Rails app

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.

Check your setup, free