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

flow-learn

Skill2 starsChanged 6 days agoMITView on GitHub

Dùng khi người dùng chỉnh cách bạn làm việc, khi bạn nhận ra mình vừa làm sai, khi vừa tìm ra nguyên nhân gốc của một lỗi, khi ledger có mục ma sát, và ở bước cập nhật ngữ cảnh lúc đóng việc. Người dùng hay nói "nhớ nhé", "từ giờ", "lần sau đừng", "luôn phải", "ghi vào luật", "thêm rule".

1 other project uses a version of this.

Adopted by

Most recently taken up by

cofin/flowtheir own version, first seen Nov 1, 2026

Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
cofin/flow★ 19same 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-planSkill
- flow-postSkill
- flow-reviewSkill
- flow-runbookSkill
- flow-secretsSkill
- flowSkill
- flow-syncSkill
- flow-testSkill
- flow-worktreeSkill

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 0 are distinctive, and 2 are very specific to this project.

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

Common
Distinctive
Very specific

Very specific:
Test: khi hành vi kiểm được bằng mã.
line 33
Very specific:
Check máy: mẫu cấm grep được, khai ở hygiene.customChecks.
line 34

≈ “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-learn — ghi điều học được

Hai kho cục bộ

Kho	Chứa	Ví dụ
`.flow/rules/`	Điều về hệ thống	Một `Book` không có hai `Loan` đang mở
`.flow/memory/`	Điều về cách làm việc	Người dùng muốn thấy diff trước khi commit

Có đáng ghi không

Ghi khi trả lời có cả ba:

Đọc mã không suy ra được?
Lần sau một agent mới có khả năng sai lại?
Có cách kiểm, hoặc là sở thích rõ ràng của người dùng?

Không ghi tóm tắt việc vừa làm, không ghi điều đã có trong mã hay trong git.

Dạng bền nhất có thể

Chọn dạng cao nhất làm được, vì thứ chạy tự động không phụ thuộc vào việc có ai đọc:

test > check máy > gate > luật > memory

Test: khi hành vi kiểm được bằng mã. Dùng skill flow-test.
Check máy: mẫu cấm grep được, khai ở hygiene.customChecks.
Gate: danh sách cần nhìn khi chạm một loại tệp, ở .flow/gates/.
Luật: điều đúng về hệ thống mà máy chưa kiểm được.
Memory: cách làm việc, sở thích.

Ghi

Tìm trùng trước, vì hai luật nói cùng một điều sẽ dần mâu thuẫn. Có rồi thì sửa bản cũ.

flow rules find --text "<từ khoá>"
flow memory --text "<từ khoá>"

Luật:

flow rules new --title "Một Book không có hai Loan đang mở" --type invariant --severity critical --scope "src/loan/**" --tags loan --enforced "test: loan.concurrency"

Mỗi luật có bốn mục, điền đủ, không chép định dạng từ nơi khác:

Luật: một câu, kiểm được
Vì sao: hậu quả khi vi phạm
Cách kiểm: lệnh, test hoặc truy vấn
Sự cố gốc: điều dẫn tới luật này trong dự án

Memory:

flow memory new --type feedback --name "xem-diff-truoc-commit" --desc "Cho người dùng xem diff trước khi commit"

Xong chạy flow reindex, flow doctor.

Ranh giới dự án ↔ bộ skill

Dự án là nơi học. Bộ skill chỉ giữ nguyên lý chung. Hai bên không được lẫn vào nhau, vì bộ skill đi theo người dùng sang mọi dự án khác.

Ở lại trong .flow/ của dự án, không bao giờ đi vào bộ skill: tên, mã, số liệu, sự cố, từ nghiệp vụ, dữ liệu, cùng mọi kiến thức cụ thể khác của dự án.

Chỉ được đưa vào bộ skill một nguyên lý đã khái quát thành thực hành chung, thoả đủ:

Viết lại hoàn toàn bằng lời mới
Không có định danh
Không có số liệu
Không kể chuyện cụ thể
Ví dụ dùng miền hư cấu, như thư viện cho mượn sách
Áp dụng được cho một dự án xa lạ

Không chép mã. Không chép câu từ của dự án.

Quy trình:

Agent không tự sửa bộ skill giữa task, kể cả khi thấy rõ chỗ sai.
Ở bước post, đề xuất cho người dùng trên chat, kèm bản nháp đã khái quát.
Được đồng ý mới sửa.
Chạy, cả hai phải sạch:

flow selftest
flow provenance --against <dự án>

Từ riêng của một dự án (ví dụ thuật ngữ để nhận diện tên định danh) khai trong .flow/profile.json, ở hygiene.namingTerms, không đưa vào bộ skill.

Khi nào

Người dùng sửa cách làm: ghi ngay, không đợi cuối task.
Vừa phát hiện mình sai: ghi trước khi làm tiếp.
Một lỗi tìm ra nguyên nhân gốc: thêm test, rồi luật nếu còn cần.
Ở skill flow-post: đọc mục friction trong ledger, chọn dạng bền nhất.

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