tidy
Installation
SKILL.md
Skill: tidy
WHAT
Purpose và context
- Purpose: dọn + validate kho nháp và render (
wiki/sources/draft/*.md+llmwiki/html/*.html) khi phình to: PROMOTE bản chất quý lên wiki, ARCHIVE nháp đã xong (tracked, không xoá), KEEP canonical, rồi RE-INDEX. - Trigger (when to use):
- Đầu phiên thấy
🧹 [tidy] draft/ có N file .md tầng gốc (> ngưỡng 10)— hooksession_start.pyhỏi user; user ĐỒNG Ý → chạy skill này. User TỪ CHỐI → bỏ qua, không hỏi lại trong phiên. - User tự gọi
/tidykhi thấydraft/hoặcllmwiki/html/lộn xộn, khó tìm, sợ mất bản chất quý. /lintbước 8c (docs-sprawl pulse) hoặcmedicprobetidybáo warn.
- Đầu phiên thấy
- Non-goals: không xoá nháp, không archive draft còn sống chỉ vì cũ, không "sửa cho đúng chuẩn" file đã nằm trong
archive/.
Mental model
Vì sao 3 tầng (không chỉ "merge"): Cái QUÝ trong nháp là quyết định / bài học / pattern — nó phải lên wiki (concept/ADR, travel + được commit + được index). Còn nháp đã thi hành xong và render html là lịch sử → archive (giữ, không xoá). Tool tất định lo đếm + phân loại + dời + index; phần đọc-hiểu để promote là việc của agent.
draft/ + html/ → check (đếm) → plan (KEEP · ARCHIVE · PROMOTE?) → agent promote → apply (git mv vào archive/<nhóm>/) → re-index → verify + commit.