codymaster 4.4.5 → 4.5.2

package/skills/skill-creator-ultra/examples/example_anthropic_frontend.md

@@ -1,109 +0,0 @@
-# Example: frontend-design (🟢 Đơn giản nhưng MẠNH — Complexity 5)
-
-> **Nguồn gốc:** Anthropic's official `frontend-design` skill — chỉ 43 dòng!
-> **Điểm hay:** Chứng minh skill tốt không cần dài. Tone "explain the why" tuyệt vời.
-> **Bài học:** Lean = AI follow tốt hơn. Viết ngắn nhưng truyền cảm hứng.
-
-## 📂 Cấu trúc (Anthropic thật)
-
-```
-skills/frontend-design/
-└── SKILL.md        ← CHỈ 43 DÒNG. Không resources, không scripts.
-```
-
----
-
-## 📄 File 1: SKILL.md (NGUYÊN VĂN từ Anthropic)
-
-```markdown
----
-name: frontend-design
-description: |
-  Create distinctive, production-grade frontend interfaces with high design
-  quality. Use this skill when the user asks to build web components, pages,
-  artifacts, posters, or applications (examples include websites, landing
-  pages, dashboards, React components, HTML/CSS layouts, or when styling/
-  beautifying any web UI). Generates creative, polished code and UI design
-  that avoids generic AI aesthetics.
----
-
-This skill guides creation of distinctive, production-grade frontend
-interfaces that avoid generic "AI slop" aesthetics. Implement real working
-code with exceptional attention to aesthetic details and creative choices.
-
-## Design Thinking
-
-Before coding, understand the context and commit to a BOLD aesthetic direction:
-- **Purpose**: What problem does this interface solve? Who uses it?
-- **Tone**: Pick an extreme: brutally minimal, maximalist chaos,
-  retro-futuristic, organic/natural, luxury/refined, playful/toy-like...
-- **Constraints**: Technical requirements (framework, performance).
-- **Differentiation**: What makes this UNFORGETTABLE?
-
-**CRITICAL**: Choose a clear conceptual direction and execute it with
-precision. Bold maximalism and refined minimalism both work — the key
-is intentionality, not intensity.
-
-## Frontend Aesthetics Guidelines
-
-Focus on:
-- **Typography**: Avoid generic fonts (Arial, Inter). Choose distinctive,
-  characterful fonts. Pair display + body font.
-- **Color & Theme**: Dominant colors with sharp accents outperform timid,
-  evenly-distributed palettes.
-- **Motion**: One well-orchestrated page load with staggered reveals
-  creates more delight than scattered micro-interactions.
-- **Backgrounds**: Create atmosphere — gradient meshes, noise textures,
-  layered transparencies, grain overlays.
-
-NEVER use: overused fonts (Inter, Roboto), cliched purple gradients,
-predictable layouts, cookie-cutter design.
-
-Remember: Claude is capable of extraordinary creative work. Don't hold
-back, show what can truly be created.
-```
-
----
-
-## 🔍 Phân tích: Tại sao 43 dòng mà mạnh?
-
-### ✅ Kỹ thuật Anthropic dùng
-
-| Kỹ thuật | Ví dụ cụ thể | Tại sao hiệu quả |
-|---|---|---|
-| **Role Priming qua tone** | "Don't hold back, show what can truly be created" | AI adopt persona sáng tạo, không generic |
-| **Negative Constraints (NEVER)** | "NEVER use: Inter, Roboto, purple gradients" | AI biết RÕ cái cấm → tránh được |
-| **Specificity thay vì rules** | "Pick an extreme: brutally minimal, maximalist chaos, retro-futuristic..." | Cho danh sách cụ thể > "hãy sáng tạo" |
-| **Explain the Why** | "Dominant colors with sharp accents OUTPERFORM timid palettes" | AI hiểu lý do → áp dụng linh hoạt |
-| **No formal sections** | Không có # Goal, # Instructions, # Examples, # Constraints rõ ràng | Skill creative không cần rigid structure |
-
-### ⚠️ Điều THIẾU (nếu dùng style của chúng ta)
-
-| Thiếu | Nên thêm? | Lý do |
-|---|---|---|
-| **Examples** | ✅ Nên | 2-3 screenshots/descriptions của UI tốt vs xấu |
-| **Constraints** | ⚠️ Optional | Skill creative — quá nhiều constraints = giết creativity |
-| **Verification** | ❌ Không cần | Output chủ quan, không grade được |
-| **Scripts** | ❌ Không cần | Skill này sinh code, không cần scripts |
-
-### 🎯 Key Insight
-
-**Lean ≠ Yếu.** 43 dòng Anthropic > 200 dòng quy tắc generic.
-
-Bí quyết:
-1. **Mỗi câu phải pull its weight** — không câu nào thừa
-2. **Inspire thay vì command** — "Don't hold back" > "MUST create beautiful UI"
-3. **Negative examples > positive rules** — "NEVER use Inter" > "use beautiful fonts"
-4. **Skill creative dùng tone khác skill technical** — ít structure hơn, nhiều inspiration hơn
-
-### 📊 So sánh: 2 phong cách viết skill
-
-| | Anthropic Style | Skill-Generator Style |
-|---|---|---|
-| **Tone** | Inspirational, creative | Structured, systematic |
-| **Length** | 30-50 dòng | 50-200 dòng |
-| **Sections** | Freeform | Goal + Instructions + Examples + Constraints |
-| **Best for** | Creative skills (design, writing) | Technical skills (code, data, automation) |
-| **Downside** | Ít guidance cho edge cases | Có thể over-structure |
-
-**→ Skill Creator Ultra dùng cả 2:** technical skills → structured, creative skills → lean.

package/skills/skill-creator-ultra/examples/example_anthropic_pdf.md

@@ -1,116 +0,0 @@
-# Example: pdf-processor (🟠 Phức tạp — Complexity 18)
-
-> **Nguồn gốc:** Dựa trên Anthropic's official `pdf` skill — 1 trong 16 skills chính thức.
-> **Điểm hay:** Description cực "pushy", progressive disclosure 3 tầng, reference docs dày.
-> **Bài học:** Skill phức tạp nhưng SKILL.md vẫn lean nhờ tách logic vào resources.
-
-## 📂 Cấu trúc (Anthropic thật)
-
-```
-skills/pdf/
-├── SKILL.md         ← 315 dòng — Guide + code snippets
-├── forms.md         ← 11KB — Chi tiết riêng về PDF forms/fill
-├── reference.md     ← 16KB — Advanced: pypdfium2, JavaScript libs
-└── scripts/
-    └── ...          ← Helper scripts
-```
-
----
-
-## 📄 File 1: SKILL.md (trích — Anthropic style)
-
-```markdown
----
-name: pdf
-description: |
-  Use this skill whenever the user wants to do anything with PDF files.
-  This includes reading or extracting text/tables from PDFs, combining or
-  merging multiple PDFs into one, splitting PDFs apart, rotating pages,
-  adding watermarks, creating new PDFs, filling PDF forms, encrypting/
-  decrypting PDFs, extracting images, and OCR on scanned PDFs to make
-  them searchable. If the user mentions a .pdf file or asks to produce
-  one, use this skill.
----
-
-# PDF Processing Guide
-
-## Overview
-
-This guide covers essential PDF processing operations using Python
-libraries and command-line tools. For advanced features, JavaScript
-libraries, and detailed examples, see REFERENCE.md. If you need to
-fill out a PDF form, read FORMS.md and follow its instructions.
-
-## Quick Start
-
-from pypdf import PdfReader, PdfWriter
-
-reader = PdfReader("document.pdf")
-print(f"Pages: {len(reader.pages)}")
-
-text = ""
-for page in reader.pages:
-    text += page.extract_text()
-
-## Python Libraries
-
-### pypdf - Basic Operations
-
-#### Merge PDFs
-[code snippets...]
-
-#### Split PDF
-[code snippets...]
-
-### pdfplumber - Text and Table Extraction
-[code snippets...]
-
-### reportlab - Create PDFs
-[code snippets...]
-
-## Quick Reference
-
-| Task             | Best Tool    | Command/Code               |
-|------------------|--------------|-----------------------------|
-| Merge PDFs       | pypdf        | writer.add_page(page)       |
-| Split PDFs       | pypdf        | One page per file           |
-| Extract text     | pdfplumber   | page.extract_text()         |
-| Extract tables   | pdfplumber   | page.extract_tables()       |
-| Create PDFs      | reportlab    | Canvas or Platypus          |
-| Fill PDF forms   | See FORMS.md | See FORMS.md                |
-
-## Next Steps
-- For advanced pypdfium2 usage, see REFERENCE.md
-- For JavaScript libraries (pdf-lib), see REFERENCE.md
-- If you need to fill out a PDF form, follow FORMS.md
-```
-
----
-
-## 🔍 Phân tích: Bài học từ Anthropic
-
-### ✅ Điểm hay — nên học
-
-| Pattern | Chi tiết | Áp dụng |
-|---|---|---|
-| **Description cực "pushy"** | Liệt kê TOÀN BỘ use cases: "reading, extracting, combining, merging, splitting, rotating, watermarks, creating, filling forms, encrypting, decrypting, extracting images, OCR" | Viết description cover mọi cách user có thể hỏi |
-| **Progressive Disclosure** | SKILL.md = quick reference, FORMS.md = deep dive, REFERENCE.md = advanced | Tách complexity ra resources/, SKILL.md giữ lean |
-| **Code-as-documentation** | Thay vì giải thích cách merge PDF, cho luôn code snippet | Cho AI copy paste, nhanh hơn đọc text |
-| **Quick Reference Table** | Bảng tổng hợp cuối: Task → Best Tool → Command | User scan nhanh, AI chọn đúng tool |
-| **Routing to resources** | "If you need to fill out a PDF form, read FORMS.md" | Lazy loading — chỉ đọc khi cần |
-
-### ⚠️ Điểm khác biệt với skill-generator
-
-| Anthropic style | Skill-generator style | Nên dùng |
-|---|---|---|
-| Không có Examples section | Có 2-3 ví dụ Input → Output | ✅ Giữ Examples — AI hiểu pattern tốt hơn |
-| Không có Constraints section | Có safety guardrails | ✅ Giữ Constraints — đặc biệt cho production |
-| Viết bằng tiếng Anh | Viết bằng tiếng Việt | 🔀 Tùy user |
-| Code snippets inline | Tách script riêng | 🔀 Tùy complexity |
-
-### 🎯 Key Insight
-
-Anthropic's description viết theo kiểu **"bắn phủ"** — liệt kê MỌI THỨ skill làm được.
-Đây là cách tốt nhất để AI trigger đúng, vì AI agent chỉ đọc description để quyết định.
-
-**Rule:** Description nên dài 50-200 ký tự và cover ≥ 80% use cases có thể xảy ra.

package/skills/skill-creator-ultra/examples/example_api_docs.md

@@ -1,189 +0,0 @@
-# Example: api-docs-writer (🟡 Trung bình — Complexity 9)
-
-> **Nguồn cảm hứng:** Tổng hợp từ Stripe API docs style + OpenAPI spec.
-> **Mức độ:** Trung bình — SKILL.md + resources/ + examples/ (không cần scripts).
-> **Tham khảo:** Anthropic's `doc-coauthoring` skill — tách templates ra resources.
-
-## 📂 Cấu trúc
-
-```
-skills/api-docs-writer/
-├── SKILL.md
-├── README.md
-├── resources/
-│   └── api_template.md         ← Template cho output
-└── examples/
-    └── example_rest_api.md     ← Ví dụ chi tiết Input → Output
-```
-
----
-
-## 📄 File 1: SKILL.md
-
-```markdown
----
-name: api-docs-writer
-description: |
-  Sinh tài liệu API chuyên nghiệp từ source code hoặc mô tả endpoint.
-  Hỗ trợ REST, GraphQL, gRPC. Output theo format Stripe-style hoặc OpenAPI.
-  Dùng khi user nói "viết API docs", "document API", "tạo tài liệu endpoint",
-  "swagger docs", "describe API", hoặc khi thấy code có route/controller.
-  KHÔNG dùng cho: viết code API mới, testing API, deploy.
----
-
-# Goal
-
-Sinh API documentation chuyên nghiệp (Stripe-quality) từ source code hoặc
-mô tả, giúp developer onboard nhanh hơn 80%.
-
-# Instructions
-
-1. Nhận input từ user — 1 trong 3 dạng:
-   - **Source code** (route file, controller) → parse endpoints
-   - **Mô tả text** ("API có 3 endpoint: GET /users, POST /users, ...")
-   - **OpenAPI/Swagger JSON** → parse và format lại
-2. Với MỖI endpoint, trích xuất:
-   - Method (GET/POST/PUT/DELETE/PATCH)
-   - Path + Path params
-   - Query params + Body params (type, required, default)
-   - Response (success + error codes)
-   - Authentication (bearer, API key, none)
-3. Hỏi bổ sung: "Có authentication không? Rate limit? Pagination?"
-   - Nếu user không biết → bỏ qua, ghi "TBD"
-4. Sinh docs theo template `resources/api_template.md`
-5. ✅ VERIFY: Mọi endpoint có ≥1 example request + response?
-   - Nếu thiếu → bổ sung example realistic
-
-📚 **Template chi tiết:** `resources/api_template.md`
-
-# Examples
-
-## Ví dụ 1: REST API đơn giản
-
-**Input:** "API quản lý user, có GET /users, POST /users, GET /users/:id"
-
-**Output:** (xem chi tiết trong `examples/example_rest_api.md`)
-
-```markdown
-## GET /users
-
-Lấy danh sách users.
-
-### Parameters
-
-| Param  | Type   | Required | Default | Description          |
-|--------|--------|----------|---------|----------------------|
-| page   | int    | No       | 1       | Trang hiện tại       |
-| limit  | int    | No       | 20      | Số records mỗi trang |
-
-### Example Request
-
-GET /users?page=1&limit=10
-
-### Example Response (200 OK)
-
-{
-  "data": [{"id": 1, "name": "Nguyễn Văn A", "email": "a@example.com"}],
-  "pagination": {"page": 1, "limit": 10, "total": 42}
-}
-
-### Error Responses
-
-| Code | Description            |
-|------|------------------------|
-| 401  | Unauthorized — missing token |
-| 500  | Internal Server Error  |
-```
-
-# Constraints
-
-- Mọi endpoint PHẢI có example request + response — dev đọc example trước doc
-- Ghi rõ field types (string, int, boolean) — tránh đoán sai
-- Luôn có error responses (≥ 401, 404, 500) — dev cần biết lỗi gì có thể xảy ra
-- Dùng realistic data trong examples — "John Doe" tốt hơn "string"
-
-<!-- Generated by Skill Creator Ultra v1.0 -->
-```
-
----
-
-## 📄 File 2: resources/api_template.md
-
-```markdown
-# API Documentation Template
-
-## {API Name} API
-
-### Base URL
-{base_url}
-
-### Authentication
-{auth_type}: {description}
-
----
-
-### {METHOD} {path}
-
-{description}
-
-#### Parameters
-
-| Param | Type | Required | Default | Description |
-|-------|------|----------|---------|-------------|
-
-#### Headers
-
-| Header        | Value             | Required |
-|---------------|-------------------|----------|
-
-#### Example Request
-{method} {path}
-{headers}
-{body}
-
-#### Example Response ({status_code})
-{response_json}
-
-#### Error Responses
-
-| Code | Message | Description |
-|------|---------|-------------|
-```
-
----
-
-## 📄 File 3: examples/example_rest_api.md
-
-```markdown
-# Ví dụ: REST API quản lý Users
-
-## Tình huống
-Developer mới join team, cần document 3 endpoint user management.
-
-## Input
-"API có 3 endpoint: GET /users (list, có pagination), POST /users (tạo mới,
-cần name + email), GET /users/:id (chi tiết 1 user)"
-
-## Output
-[Full API docs theo template — ~50 dòng cho 3 endpoints]
-(Xem SKILL.md Examples section cho shortform)
-
-## Tại sao output như vậy?
-- Có pagination params cho GET /users — vì GET list luôn cần paginate
-- POST body có validation rules — dev cần biết format
-- Error 404 cho GET /users/:id — user có thể không tồn tại
-```
-
----
-
-## 🔍 Phân tích: Tại sao skill này tốt?
-
-| Tiêu chí | Đánh giá | Ghi chú |
-|---|---|---|
-| **Progressive Disclosure** | ✅ | SKILL.md có tóm tắt, template tách ra resources/ |
-| **Description "pushy"** | ✅ | 6 trigger + 3 anti-trigger + cover cả "swagger" |
-| **Template-based output** | ✅ | Consistent format qua resources/api_template.md |
-| **Explain The Why** | ✅ | "dev đọc example trước doc" |
-| **Verification Step** | ✅ | Step 5: "mọi endpoint có ≥1 example?" |
-| **Realistic examples** | ✅ | Vietnamese names, real pagination |
-| **SKILL.md < 500 dòng** | ✅ | ~80 dòng, template tách riêng |

package/skills/skill-creator-ultra/examples/example_db_migration.md

@@ -1,253 +0,0 @@
-# Example: db-migration-checker (🟠 Phức tạp — Complexity 16)
-
-> **Nguồn cảm hứng:** Real-world DB migration risks + Anthropic's pdf skill (scripts + resources).
-> **Mức độ:** Phức tạp — SKILL.md + resources/ + examples/ + scripts/.
-> **Tham khảo:** Anthropic's `pdf` skill có SKILL.md 315 dòng + reference.md + forms.md + scripts/.
-
-## 📂 Cấu trúc
-
-```
-skills/db-migration-checker/
-├── SKILL.md                        ← Logic chính (~100 dòng)
-├── README.md
-├── resources/
-│   ├── dangerous_patterns.md      ← Danh sách patterns nguy hiểm
-│   └── rollback_strategies.md     ← Chiến thuật rollback theo DB type
-├── examples/
-│   ├── example_safe_migration.md  ← Case an toàn
-│   └── example_risky_migration.md ← Case nguy hiểm
-└── scripts/
-    └── analyze_migration.py       ← Script parse SQL file
-```
-
----
-
-## 📄 File 1: SKILL.md
-
-```markdown
----
-name: db-migration-checker
-description: |
-  Review và đánh giá độ an toàn của file migration SQL/ORM trước khi chạy
-  trên production. Phát hiện breaking changes, data loss risks, locking issues.
-  Dùng khi user nói "review migration", "check migration", "migration safe
-  không", "database migration", "alter table", "schema change", hoặc khi
-  thấy file migration (*.sql, *_migration.py, *.up.sql). KHÔNG dùng cho:
-  viết migration mới, backup database, schema design.
----
-
-# Goal
-
-Phát hiện 100% migration nguy hiểm TRƯỚC KHI deploy — tránh downtime
-và data loss trên production.
-
-# Mindset
-
-Bạn là **DBA nghiêm khắc** với kinh nghiệm xử lý 50+ production incidents.
-Mặc định mọi migration đều nguy hiểm cho đến khi chứng minh an toàn.
-
-# Instructions
-
-1. Nhận file migration (.sql, .py, .ts, hoặc paste text).
-2. Xác định DB type: PostgreSQL / MySQL / SQLite / MongoDB.
-   - Nếu không rõ → hỏi user
-3. Parse migration → liệt kê operations:
-   - CREATE TABLE, ALTER TABLE, DROP TABLE
-   - ADD COLUMN, DROP COLUMN, RENAME COLUMN
-   - CREATE INDEX, DROP INDEX
-   - INSERT, UPDATE, DELETE (data migration)
-4. Với MỖI operation, check `resources/dangerous_patterns.md`:
-   - 🔴 **CRITICAL**: Data loss, table drop, column rename không backward-compatible
-   - 🟡 **WARNING**: Lock nguy hiểm (ALTER TABLE trên bảng >1M rows)
-   - 🟢 **SAFE**: Additive changes (thêm column nullable, thêm index)
-5. Ước tính lock time:
-   - Table size nếu biết → lock time ≈ f(rows, operation type)
-   - Nếu không biết table size → hỏi user: "Bảng X có bao nhiêu rows?"
-6. Sinh báo cáo theo format:
-
-   ## Migration Review Report
-   
-   | # | Operation | Risk | Lock? | Ghi chú |
-   |---|-----------|------|-------|---------|
-   
-   **Overall Risk: 🔴/🟡/🟢**
-   
-   ### Đề xuất:
-   - [Rollback strategy]
-   - [Safe deployment order]
-
-7. ✅ VERIFY: Mọi DROP/DELETE có rollback strategy?
-   - Nếu thiếu → thêm từ `resources/rollback_strategies.md`
-
-📚 Tham khảo: `resources/dangerous_patterns.md`, `resources/rollback_strategies.md`
-
-# Examples
-
-## Ví dụ 1: Migration an toàn
-**Input:**
-ALTER TABLE users ADD COLUMN avatar_url VARCHAR(255) DEFAULT NULL;
-CREATE INDEX idx_users_email ON users(email);
-
-**Output:**
-| # | Operation | Risk | Lock? | Ghi chú |
-|---|-----------|------|-------|---------|
-| 1 | ADD COLUMN nullable | 🟢 SAFE | ~0s | Additive, không lock |
-| 2 | CREATE INDEX | 🟡 WARN | ~5s (1M rows) | Dùng CONCURRENTLY |
-
-**Overall Risk: 🟢 SAFE** — Chạy được, nhưng nên dùng `CREATE INDEX CONCURRENTLY`.
-
-## Ví dụ 2: Migration nguy hiểm
-**Input:**
-ALTER TABLE orders DROP COLUMN customer_email;
-ALTER TABLE orders RENAME COLUMN total TO amount;
-
-**Output:**
-| # | Operation | Risk | Lock? | Ghi chú |
-|---|-----------|------|-------|---------|
-| 1 | DROP COLUMN | 🔴 CRITICAL | ~10s | DATA LOSS — không thể undo |
-| 2 | RENAME COLUMN | 🔴 CRITICAL | ~10s | App code đang dùng "total" sẽ crash |
-
-**Overall Risk: 🔴 CRITICAL** — KHÔNG CHẠY. Cần 3-phase deployment.
-
-# Constraints
-
-- Mặc định mọi migration = nguy hiểm — "innocent until proven safe" ngược lại
-- DROP/DELETE PHẢI có rollback strategy — vì production không có undo
-- Luôn hỏi table size khi ALTER TABLE — vì lock time phụ thuộc rows
-- Không tự chạy migration — chỉ review, KHÔNG execute
-
-<!-- Generated by Skill Creator Ultra v1.0 -->
-```
-
----
-
-## 📄 File 2: resources/dangerous_patterns.md
-
-```markdown
-# ⚠️ Dangerous Migration Patterns
-
-## 🔴 CRITICAL — Ngừng ngay, cần redesign
-
-| Pattern | Vì sao nguy hiểm | Giải pháp |
-|---|---|---|
-| `DROP TABLE` | Mất toàn bộ data | Rename → archive → drop sau 30 ngày |
-| `DROP COLUMN` | Mất data column đó | Backup column data trước |
-| `RENAME COLUMN` | App code đang reference tên cũ | 3-phase: add new → migrate → drop old |
-| `ALTER COLUMN type` | Implicit cast có thể fail | Test trên staging trước |
-| `TRUNCATE TABLE` | Mất toàn bộ data, không log | Dùng DELETE + WHERE nếu cần |
-
-## 🟡 WARNING — Xem xét kỹ
-
-| Pattern | Vì sao nguy hiểm | Giải pháp |
-|---|---|---|
-| `ALTER TABLE` on >1M rows | Table lock, downtime | Dùng pt-online-schema-change |
-| `ADD COLUMN NOT NULL` without default | Lock + rewrite toàn bộ table | Thêm DEFAULT hoặc nullable first |
-| `CREATE INDEX` | Lock table (MyISAM) hoặc slow (InnoDB) | Dùng CONCURRENTLY (PostgreSQL) |
-| `UPDATE` toàn bộ table | Lock rows, slow | Batch update 1000 rows/lần |
-
-## 🟢 SAFE — Thường an toàn
-
-| Pattern | Ghi chú |
-|---|---|
-| `ADD COLUMN nullable` | Nhanh, không lock |
-| `CREATE INDEX CONCURRENTLY` | Non-blocking (PostgreSQL only) |
-| `CREATE TABLE` | Bảng mới, không ảnh hưởng existing |
-| `INSERT` vào bảng trống | Không conflict |
-```
-
----
-
-## 📄 File 3: resources/rollback_strategies.md
-
-```markdown
-# 🔄 Rollback Strategies theo DB Type
-
-## PostgreSQL
-| Operation | Rollback | Command |
-|---|---|---|
-| ADD COLUMN | DROP COLUMN | `ALTER TABLE x DROP COLUMN y;` |
-| CREATE INDEX | DROP INDEX | `DROP INDEX IF EXISTS idx;` |
-| DROP TABLE | Restore from backup | `pg_restore -d db -t table backup.dump` |
-
-## MySQL
-| Operation | Rollback | Command |
-|---|---|---|
-| ADD COLUMN | DROP COLUMN | `ALTER TABLE x DROP COLUMN y;` |
-| CREATE INDEX | DROP INDEX | `DROP INDEX idx ON table;` |
-| DROP TABLE | Restore from backup | `mysqlimport` hoặc point-in-time recovery |
-
-## Quy tắc chung
-1. LUÔN backup trước migration
-2. Chạy migration trong transaction (nếu DB hỗ trợ)
-3. Test trên staging TRƯỚC production
-4. Deploy off-peak hours
-```
-
----
-
-## 📄 File 4: scripts/analyze_migration.py
-
-```python
-#!/usr/bin/env python3
-"""
-analyze_migration.py — Parse SQL migration file và phát hiện patterns nguy hiểm.
-
-Usage:
-    python analyze_migration.py migration.sql
-    python analyze_migration.py migration.sql --verbose
-    python analyze_migration.py --help
-"""
-
-import sys
-import re
-import argparse
-
-CRITICAL = ["DROP TABLE", "DROP COLUMN", "RENAME COLUMN", "TRUNCATE"]
-WARNING = ["ALTER TABLE", "CREATE INDEX", "UPDATE", "ADD COLUMN .* NOT NULL"]
-SAFE = ["ADD COLUMN .* NULL", "CREATE TABLE", "CREATE INDEX CONCURRENTLY"]
-
-def analyze(sql_content):
-    results = []
-    for line in sql_content.split(";"):
-        line = line.strip().upper()
-        if not line: continue
-        risk = "🟢 SAFE"
-        for p in CRITICAL:
-            if re.search(p, line): risk = "🔴 CRITICAL"; break
-        if risk == "🟢 SAFE":
-            for p in WARNING:
-                if re.search(p, line): risk = "🟡 WARNING"; break
-        results.append({"operation": line[:60], "risk": risk})
-    return results
-
-def main():
-    parser = argparse.ArgumentParser(description="Analyze SQL migration safety")
-    parser.add_argument("file", help="SQL migration file")
-    parser.add_argument("--verbose", "-v", action="store_true")
-    args = parser.parse_args()
-
-    with open(args.file) as f:
-        results = analyze(f.read())
-
-    for r in results:
-        print(f"{r['risk']} | {r['operation']}")
-
-if __name__ == '__main__':
-    main()
-```
-
----
-
-## 🔍 Phân tích: Tại sao skill này tốt?
-
-| Tiêu chí | Đánh giá | Ghi chú |
-|---|---|---|
-| **Progressive Disclosure** | ✅ | SKILL.md ~100 dòng, details in resources/ |
-| **Explain The Why** | ✅ | "vì production không có undo" |
-| **Role Priming** | ✅ | "DBA nghiêm khắc, 50+ incidents" |
-| **Domain resources** | ✅ | dangerous_patterns.md + rollback_strategies.md |
-| **Script hỗ trợ** | ✅ | analyze_migration.py có --help + --verbose |
-| **Black Box Script** | ✅ | AI dùng --help, không cần đọc source |
-| **Verification Step** | ✅ | "Mọi DROP có rollback strategy?" |
-| **Output Format Anchoring** | ✅ | Table format rõ ràng |
-| **3 mức risk** | ✅ | 🔴 CRITICAL / 🟡 WARNING / 🟢 SAFE |