codymaster 4.4.4 → 4.5.1

package/skills/skill-creator-ultra/phases/phase7_iterate.md

@@ -1,103 +0,0 @@
-## Phase 7: 🔄 Iteration Loop — Cải thiện liên tục
-
-> Adapted from Anthropic's improvement methodology.
-> "This task is pretty important — take your time and really mull things over."
-
-### Khi nào chạy Phase 7?
-
-- Sau Phase 6 nếu pass rate < 90%
-- User có feedback muốn cải thiện skill
-- User nói "review skill X, em dùng được Y ngày rồi"
-
----
-
-### 7.1. Thu thập Feedback
-
-**Từ Phase 6 (quantitative):**
-- Xem test cases nào FAIL → phân tích nguyên nhân root cause
-- Xem expectations nào luôn PASS ở cả skill và baseline → có thể bỏ (non-discriminating)
-
-**Từ User (qualitative):**
-> "Anh/chị dùng skill này được bao lâu rồi? Có vấn đề gì không?"
->
-> 1. Skill hoạt động đúng ý bao nhiêu %?
-> 2. Có tình huống nào skill xử lý sai không?
-> 3. Có quy tắc mới cần thêm không?
-
----
-
-### 7.2. Phân tích & Cải thiện
-
-**4 nguyên tắc khi cải thiện (từ Anthropic):**
-
-**1. Generalize from feedback.**
-Đừng thêm rule chỉ cho 1 case cụ thể. Hiểu TẠI SAO nó sai và sửa logic
-tổng quát. Skill sẽ được dùng hàng ngàn lần với input khác nhau. Nếu bạn
-thêm quá nhiều edge-case rules, skill sẽ bloat và AI sẽ mất focus.
-
-**2. Keep the prompt lean.**
-Đọc lại transcripts — nếu AI đang waste time làm thứ không productive, bỏ
-phần instruction đó đi. Mỗi dòng trong skill phải pull its weight.
-
-**3. Explain the why.**
-Nếu bạn thấy mình viết ALWAYS hoặc NEVER caps lock, dừng lại. Hãy reframe:
-giải thích reasoning để AI hiểu. AI hiện đại có theory of mind tốt — khi
-hiểu tại sao, nó xử lý edge cases tốt hơn rote rules.
-
-**4. Look for repeated work.**
-Đọc transcripts từ test runs — nếu AI luôn tự viết cùng 1 helper script,
-đó là signal mạnh: bundle script đó vào `scripts/`. Tiết kiệm cho mỗi
-lần chạy sau.
-
----
-
-### 7.3. Mapping Feedback → Hành động
-
-| Feedback | Hành động | File sửa |
-| --- | --- | --- |
-| "Output format sai" | Sửa Examples + Output Format Anchoring | SKILL.md |
-| "Thiếu trường hợp X" | Thêm logic rẽ nhánh + ví dụ edge case | SKILL.md + examples/ |
-| "Bước Y không cần" | Xóa/gộp step, giữ lean | SKILL.md |
-| "Cần thêm quy tắc Z" | Thêm Constraint (explain why) | SKILL.md |
-| "AI luôn viết cùng 1 script" | Bundle script vào skills/scripts/ | scripts/ |
-| "Instruction mơ hồ" | Cụ thể hóa → Level 3-4 (Specificity Ladder) | SKILL.md |
-| "Output đúng nhưng chậm" | Tối ưu: lazy loading, bớt resource reads | SKILL.md |
-
----
-
-### 7.4. Re-test & So sánh
-
-Sau mỗi vòng sửa:
-
-1. **Chạy lại test cases** từ Phase 6
-2. **So sánh pass rate** trước/sau
-
-```text
-📊 So sánh:
-| Metric     | v1 (trước) | v2 (sau) | Delta  |
-|------------|-----------|---------|--------|
-| Pass Rate  | 67%       | 89%     | +22% ↑ |
-| Avg tokens | 3800      | 3200    | -600 ↓ |
-```
-
-3. **Nếu cải thiện** → tiếp tục hoặc dừng
-4. **Nếu regression** → revert, thử approach khác
-
-### 7.5. Version Tracking
-
-Mỗi vòng sửa → bump version trong skill's CHANGELOG.md:
-
-```markdown
-## v1.1.0 (YYYY-MM-DD)
-- Sửa: [Mô tả thay đổi]
-- Reason: [User feedback / Eval failure / Performance]
-- Pass rate: 67% → 89%
-```
-
-### 7.6. Điều kiện dừng
-
-Dừng iterate khi:
-- ✅ User nói hài lòng
-- ✅ Feedback trống (mọi thứ OK)
-- ✅ Pass rate ≥ 90%
-- ⚠️ Không tiến bộ sau 2 vòng (diminishing returns)

package/skills/skill-creator-ultra/phases/phase8_optimize.md

@@ -1,113 +0,0 @@
-## Phase 8: 🎯 Description Optimization — Tối ưu Trigger Accuracy
-
-> Adapted from Anthropic's description optimization system.
-> Description là thứ DUY NHẤT AI agent đọc để quyết định dùng skill hay không.
-
-### Khi nào chạy Phase 8?
-
-- Sau khi skill hoàn chỉnh (Phase 5 hoặc Phase 7 xong)
-- Muốn tối ưu: skill trigger đúng lúc, không trigger sai
-- Skill sẽ dùng trong production lâu dài
-
----
-
-### 8.1. Hiểu cách Skill Triggering hoạt động
-
-AI Agent đọc danh sách skills (name + description) → quyết định có dùng không.
-
-**Quan trọng:**
-- AI có xu hướng **under-trigger** — không dùng skill dù nên dùng
-- Giải pháp: viết description "pushy" hơn
-- AI chỉ consult skill cho task phức tạp — query đơn giản ("đọc file X") sẽ
-  không trigger skill dù description match
-
----
-
-### 8.2. Trigger Eval — Kiểm tra description
-
-**Bước 1: Viết 5 câu NÊN trigger**
-
-Đa dạng: formal/casual, dài/ngắn, trực tiếp/gián tiếp.
-
-Viết như user thật — có context, backstory, viết tắt, lowercase:
-
-```
-1. "Viết báo cáo tuần cho sếp"
-2. "weekly report từ Jira đi"
-3. "tóm tắt công việc tuần này gửi team"
-4. "ok sếp vừa nhắn gửi update, em xong 5 tasks rồi"
-5. "em cần summarize tuần 24/02, có 3 PRs merged"
-```
-
-**Bước 2: Viết 5 câu KHÔNG NÊN trigger**
-
-Chọn near-miss — giống nhưng KHÁC intent:
-
-```
-1. "Viết email cho khách hàng" (→ email skill, không phải report)
-2. "Phân tích data bán hàng Q4" (→ data analysis)
-3. "Tạo slide thuyết trình" (→ slide skill)
-4. "Review PR #123 cho em" (→ code review)
-5. "Deploy app lên production" (→ deploy skill)
-```
-
-⚠️ **Tránh**: Câu obviously khác ("write fibonacci") → không test được gì.
-Câu tốt nhất là near-miss — chia sẻ keyword nhưng intent khác.
-
-**Bước 3: Verify description**
-
-Đọc lại description → kiểm tra:
-
-| Câu NÊN trigger | Description cover? | Action |
-| --- | --- | --- |
-| "Viết báo cáo tuần cho sếp" | ✅ Có "báo cáo tuần" | OK |
-| "ok sếp vừa nhắn gửi update" | ❌ Thiếu "update" | Thêm vào description |
-
-| Câu KHÔNG NÊN | Description có thể trigger sai? | Action |
-| --- | --- | --- |
-| "Viết email cho khách hàng" | ⚠️ Có chữ "viết" | Thêm anti-trigger: "KHÔNG dùng cho email" |
-
----
-
-### 8.3. Viết Description "Pushy"
-
-**Trước optimization:**
-```yaml
-description: Tạo báo cáo tuần từ dữ liệu Jira.
-```
-
-**Sau optimization:**
-```yaml
-description: |
-  Tạo báo cáo công việc hàng tuần từ Jira, Git, hoặc dữ liệu user cung cấp.
-  Sinh báo cáo theo mẫu 4 phần: Đã làm, Đang làm, Vướng mắc, Tuần tới.
-  Dùng skill này khi user nhắc đến báo cáo tuần, weekly report, gửi update
-  cho sếp/team, tóm tắt công việc, kể cả khi họ không nói rõ "báo cáo tuần".
-  KHÔNG dùng cho: viết email, tạo slide, phân tích data chuyên sâu.
-```
-
-**Checklist description tối ưu:**
-
-- [ ] Trả lời: "Skill LÀM GÌ?" (hành động chính)
-- [ ] Trả lời: "Cho AI?" (đối tượng/context)
-- [ ] Trả lời: "Khi nào dùng?" (≥ 3 trigger phrases)
-- [ ] Trả lời: "Khi nào KHÔNG dùng?" (anti-triggers cho near-miss)
-- [ ] ≥ 50 ký tự (quá ngắn = thiếu trigger coverage)
-- [ ] ≤ 200 ký tự (quá dài = AI mất focus)
-- [ ] Có cả casual phrases ("gửi cho sếp") lẫn formal ("weekly report")
-
----
-
-### 8.4. Sửa Description & Verify
-
-1. Update YAML frontmatter với description mới
-2. Chạy lại Trigger Eval (Bước 1-3)
-3. Verify: 5/5 câu NÊN trigger đều covered
-4. Verify: 5/5 câu KHÔNG NÊN đều excluded
-
-> "Em đã tối ưu description cho skill `<tên>`. Trước/sau:
->
-> **Trước:** [description cũ]
-> **Sau:** [description mới]
->
-> Coverage: 5/5 trigger phrases, 0/5 false triggers."