codymaster 4.1.3 → 4.3.0

package/skills/skill-creator-ultra/scripts/skill_scaffold.py

@@ -0,0 +1,403 @@
+#!/usr/bin/env python3
+"""
+skill_scaffold.py — Tạo skeleton thư mục + files cho Skill mới
+
+Sử dụng:
+    python skill_scaffold.py my-new-skill
+    python skill_scaffold.py my-new-skill --output ./path/to/skills/
+    python skill_scaffold.py my-new-skill --with-scripts
+    python skill_scaffold.py my-new-skill --full
+    python skill_scaffold.py my-new-skill --interactive
+
+Modes:
+    (default)       → Chỉ tạo SKILL.md cơ bản
+    --with-scripts  → Thêm scripts/ với template
+    --full          → Tạo đầy đủ: SKILL.md + scripts/ + resources/ + examples/
+    --interactive   → Hỏi từng bước tên, mô tả, trigger...
+
+Developed by Thân Công Hải — Skill Generator v3.2 Expert
+"""
+
+import sys
+import os
+import re
+from datetime import datetime
+
+
+class Colors:
+    PASS = '\033[92m'
+    FAIL = '\033[91m'
+    WARN = '\033[93m'
+    INFO = '\033[96m'
+    BOLD = '\033[1m'
+    DIM = '\033[2m'
+    RESET = '\033[0m'
+
+    @staticmethod
+    def enable_windows():
+        if os.name == 'nt':
+            try:
+                import ctypes
+                kernel32 = ctypes.windll.kernel32
+                kernel32.SetConsoleMode(kernel32.GetStdHandle(-11), 7)
+            except Exception:
+                pass
+
+
+Colors.enable_windows()
+
+
+# ============================================================
+# TEMPLATES
+# ============================================================
+
+SKILL_TEMPLATE = '''---
+name: {name}
+description: |
+  {description}
+  Kích hoạt khi user yêu cầu "{trigger}".
+---
+
+# Goal
+
+{goal}
+
+# Instructions
+
+## Bước 1: Tiếp nhận yêu cầu
+
+Phân tích yêu cầu của user:
+- Xác định input chính
+- Xác nhận output mong muốn
+- Hỏi lại nếu thiếu thông tin
+
+## Bước 2: Xử lý
+
+1. [Mô tả bước xử lý cụ thể]
+2. [Bước tiếp theo]
+3. [Bước cuối]
+
+> 🛡️ **Error Recovery:**
+> - Nếu input không hợp lệ → Hỏi lại user
+> - Nếu kết quả không chắc chắn → Hiển thị cảnh báo
+
+## Bước 3: Trả kết quả
+
+Hiển thị kết quả theo format trong Examples.
+
+# Examples
+
+## Ví dụ 1: Happy Path
+
+**Input:**
+```
+[Mô tả input mẫu]
+```
+
+**Thought Process:**
+- Phân tích: [...]
+- Quyết định: [...]
+
+**Output:**
+```
+[Mô tả output mẫu]
+```
+
+## Ví dụ 2: Edge Case
+
+**Input:**
+```
+[Input đặc biệt / thiếu thông tin]
+```
+
+**Output:**
+```
+[Cách xử lý edge case]
+```
+
+# Constraints
+
+## DOs (Luôn luôn)
+- LUÔN LUÔN xác nhận lại yêu cầu trước khi xử lý
+- LUÔN LUÔN hiển thị kết quả theo format trong Examples
+- LUÔN LUÔN thông báo nếu có uncertainty
+
+## DON'Ts (Không được)
+- KHÔNG ĐƯỢC bịa dữ liệu khi thiếu input
+- KHÔNG ĐƯỢC bỏ qua edge cases
+- KHÔNG ĐƯỢC thay đổi format output
+
+<!-- Generated by Skill Generator v3.2 -->
+'''
+
+SCRIPT_TEMPLATE = '''#!/usr/bin/env python3
+"""
+{filename} — [Mô tả script]
+
+Sử dụng:
+    python {filename} [arguments]
+    python {filename} --help
+    python {filename} --dry-run [arguments]
+"""
+
+import sys
+import os
+import argparse
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="{name} — Script hỗ trợ cho skill",
+        formatter_class=argparse.RawDescriptionHelpFormatter
+    )
+    parser.add_argument('input', nargs='?', help='Input file hoặc data')
+    parser.add_argument('--dry-run', action='store_true', help='Chạy thử không thực thi')
+    parser.add_argument('--verbose', '-v', action='store_true', help='Hiển thị chi tiết')
+
+    args = parser.parse_args()
+
+    if args.dry_run:
+        print("[DRY RUN] Sẽ xử lý:", args.input)
+        return
+
+    # TODO: Implement logic
+    print(f"Processing: {{args.input}}")
+
+
+if __name__ == '__main__':
+    main()
+'''
+
+RESOURCE_TEMPLATE = '''# {title}
+
+> Tài liệu tham khảo cho skill `{name}`
+
+## Nội dung
+
+[Thêm nội dung tham khảo ở đây]
+
+## Nguồn tham khảo
+
+- [Link 1]
+- [Link 2]
+'''
+
+EXAMPLE_TEMPLATE = '''# Ví dụ: {title}
+
+> Ví dụ chi tiết cho skill `{name}`
+
+## Tình huống
+
+[Mô tả tình huống]
+
+## Input
+
+```
+[Dữ liệu input]
+```
+
+## Expected Output
+
+```
+[Kết quả mong đợi]
+```
+
+## Giải thích
+
+[Tại sao output là như vậy]
+'''
+
+
+# ============================================================
+# INTERACTIVE MODE
+# ============================================================
+
+def interactive_mode():
+    """Hỏi user từng bước để tạo skill."""
+    print()
+    print(f"{Colors.BOLD}  🧩 Skill Scaffold — Chế độ tương tác{Colors.RESET}")
+    print(f"  {Colors.DIM}Trả lời các câu hỏi để tạo skill mới{Colors.RESET}")
+    print()
+
+    name = input(f"  📌 Tên skill (kebab-case, ví dụ: price-quoter): ").strip()
+    if not name:
+        print(f"  {Colors.FAIL}❌ Tên không được trống!{Colors.RESET}")
+        return None
+
+    # Validate name
+    if not re.match(r'^[a-z0-9][a-z0-9-]*$', name):
+        print(f"  {Colors.WARN}⚠️ Tên nên dùng kebab-case (ví dụ: my-skill-name){Colors.RESET}")
+        name = re.sub(r'[^a-z0-9-]', '-', name.lower()).strip('-')
+        print(f"  {Colors.INFO}   → Đã sửa thành: {name}{Colors.RESET}")
+
+    description = input(f"  📝 Mô tả ngắn (1-2 câu): ").strip() or f"Skill {name}"
+    trigger = input(f"  🎯 Trigger phrase (user nói gì để kích hoạt?): ").strip() or name
+    goal = input(f"  🏁 Goal (skill làm gì — 1 câu): ").strip() or f"Thực hiện {name}"
+
+    with_scripts = input(f"  🔧 Có cần scripts không? (y/n, mặc định n): ").strip().lower() == 'y'
+    with_resources = input(f"  📚 Có cần resources không? (y/n, mặc định n): ").strip().lower() == 'y'
+    with_examples = input(f"  🎯 Có cần example files không? (y/n, mặc định n): ").strip().lower() == 'y'
+
+    return {
+        'name': name,
+        'description': description,
+        'trigger': trigger,
+        'goal': goal,
+        'with_scripts': with_scripts,
+        'with_resources': with_resources,
+        'with_examples': with_examples,
+    }
+
+
+# ============================================================
+# SCAFFOLD
+# ============================================================
+
+def scaffold_skill(name, output_dir=None, full=False, with_scripts=False,
+                   interactive_data=None):
+    """Tạo skeleton skill."""
+
+    if output_dir is None:
+        output_dir = '.'
+
+    skill_dir = os.path.join(output_dir, name)
+
+    if os.path.exists(skill_dir):
+        print(f"{Colors.FAIL}❌ Thư mục đã tồn tại: {skill_dir}{Colors.RESET}")
+        print(f"   Xóa hoặc đổi tên thư mục cũ trước khi tạo mới.")
+        return False
+
+    # Get data
+    if interactive_data:
+        data = interactive_data
+    else:
+        data = {
+            'name': name,
+            'description': f'Skill {name} — [Mô tả ngắn]',
+            'trigger': name.replace('-', ' '),
+            'goal': f'[Mô tả goal cho {name}]',
+            'with_scripts': with_scripts or full,
+            'with_resources': full,
+            'with_examples': full,
+        }
+
+    created_files = []
+
+    # Create directories
+    os.makedirs(skill_dir, exist_ok=True)
+
+    # SKILL.md
+    skill_content = SKILL_TEMPLATE.format(
+        name=data['name'],
+        description=data['description'],
+        trigger=data['trigger'],
+        goal=data['goal'],
+    )
+    skill_path = os.path.join(skill_dir, 'SKILL.md')
+    with open(skill_path, 'w', encoding='utf-8') as f:
+        f.write(skill_content)
+    created_files.append(('SKILL.md', 'Bộ não chính của skill'))
+
+    # Scripts
+    if data.get('with_scripts') or full:
+        scripts_dir = os.path.join(skill_dir, 'scripts')
+        os.makedirs(scripts_dir, exist_ok=True)
+
+        script_content = SCRIPT_TEMPLATE.format(
+            filename=f'{name.replace("-", "_")}_helper.py',
+            name=name,
+        )
+        script_path = os.path.join(scripts_dir, f'{name.replace("-", "_")}_helper.py')
+        with open(script_path, 'w', encoding='utf-8') as f:
+            f.write(script_content)
+        created_files.append((f'scripts/{name.replace("-", "_")}_helper.py', 'Script hỗ trợ (template)'))
+
+    # Resources
+    if data.get('with_resources') or full:
+        resources_dir = os.path.join(skill_dir, 'resources')
+        os.makedirs(resources_dir, exist_ok=True)
+
+        resource_content = RESOURCE_TEMPLATE.format(title='Tài liệu tham khảo', name=name)
+        resource_path = os.path.join(resources_dir, 'reference.md')
+        with open(resource_path, 'w', encoding='utf-8') as f:
+            f.write(resource_content)
+        created_files.append(('resources/reference.md', 'Tài liệu tham khảo (template)'))
+
+    # Examples
+    if data.get('with_examples') or full:
+        examples_dir = os.path.join(skill_dir, 'examples')
+        os.makedirs(examples_dir, exist_ok=True)
+
+        example_content = EXAMPLE_TEMPLATE.format(title='Happy Path', name=name)
+        example_path = os.path.join(examples_dir, 'example_happy_path.md')
+        with open(example_path, 'w', encoding='utf-8') as f:
+            f.write(example_content)
+        created_files.append(('examples/example_happy_path.md', 'Ví dụ Happy Path (template)'))
+
+    # Output
+    print()
+    print(f"{Colors.BOLD}{'=' * 50}{Colors.RESET}")
+    print(f"{Colors.BOLD}  🧩 SKILL SCAFFOLD — Tạo skill mới{Colors.RESET}")
+    print(f"{Colors.BOLD}{'=' * 50}{Colors.RESET}")
+    print()
+    print(f"  {Colors.PASS}✅ Đã tạo skill: {Colors.BOLD}{name}{Colors.RESET}")
+    print(f"  {Colors.DIM}📁 Vị trí: {os.path.abspath(skill_dir)}{Colors.RESET}")
+    print()
+
+    # File tree
+    print(f"  {Colors.BOLD}📂 Cấu trúc:{Colors.RESET}")
+    print(f"  {name}/")
+    for i, (filepath, desc) in enumerate(created_files):
+        is_last = i == len(created_files) - 1
+        prefix = '└──' if is_last else '├──'
+        print(f"  {prefix} {Colors.INFO}{filepath}{Colors.RESET} — {Colors.DIM}{desc}{Colors.RESET}")
+    print()
+
+    # Next steps
+    print(f"  {Colors.BOLD}💡 Tiếp theo:{Colors.RESET}")
+    print(f"     1. Mở {Colors.INFO}{skill_dir}/SKILL.md{Colors.RESET} và điền nội dung")
+    print(f"     2. Chạy: {Colors.INFO}python skill_audit.py {skill_dir}/{Colors.RESET} để kiểm tra")
+    print(f"     3. Chạy: {Colors.INFO}python simulate_skill.py {skill_dir}/{Colors.RESET} để test")
+    print()
+    print(f"{Colors.BOLD}{'=' * 50}{Colors.RESET}")
+    print()
+
+    return True
+
+
+if __name__ == '__main__':
+    if len(sys.argv) < 2:
+        print("Sử dụng: python skill_scaffold.py <skill-name> [options]")
+        print()
+        print("Options:")
+        print("  --output <dir>     Thư mục output (mặc định: ./)")
+        print("  --with-scripts     Thêm scripts/ với template")
+        print("  --full             Tạo đầy đủ (scripts + resources + examples)")
+        print("  --interactive      Chế độ tương tác hỏi từng bước")
+        print()
+        print("Ví dụ:")
+        print("  python skill_scaffold.py price-quoter")
+        print("  python skill_scaffold.py price-quoter --full")
+        print("  python skill_scaffold.py price-quoter --interactive")
+        print("  python skill_scaffold.py my-skill --output ./skills/")
+        sys.exit(1)
+
+    name = sys.argv[1]
+    output = None
+    full = '--full' in sys.argv
+    with_scripts = '--with-scripts' in sys.argv
+    interactive = '--interactive' in sys.argv
+
+    for i, arg in enumerate(sys.argv):
+        if arg == '--output' and i + 1 < len(sys.argv):
+            output = sys.argv[i + 1]
+
+    if interactive:
+        data = interactive_mode()
+        if data is None:
+            sys.exit(1)
+        success = scaffold_skill(data['name'], output, interactive_data=data)
+    else:
+        success = scaffold_skill(name, output, full=full, with_scripts=with_scripts)
+
+    sys.exit(0 if success else 1)