docs/SKILLS.md

Skills Documentation

Nexus Coder v0.2 có 15 skills chuyên môn, được tổ chức theo 5 categories.

Categories

Category	Skills
CODE	code_generation, code_review, code_refactor, debugging, documentation, testing
REASONING	algorithm_design, reasoning, math_skill
LANGUAGE	translation, summarization
DATA	data_analysis, sql_generation
SECURITY	security_audit
DEVOPS	performance_optimization

Skill List

1. code_generation

• Category: CODE
• Priority: HIGH
• Description: Sinh code từ mô tả tự nhiên
• Languages: Python, JavaScript, TypeScript, Go, Rust, C++, Java, SQL
• Example: "Viết hàm Python tính fibonacci"

2. code_review

• Category: CODE
• Priority: HIGH
• Description: Review code toàn diện
• Checks: bugs, security, performance, style, error handling, type safety
• Example: "Review đoạn code này giúp tôi"

3. code_refactor

• Category: CODE
• Priority: MEDIUM
• Description: Refactor code an toàn
• Patterns: Extract Method/Class, Rename, Move, Replace Conditional, etc.
• Example: "Refactor hàm này cho clean hơn"

4. debugging

• Category: CODE
• Priority: CRITICAL
• Description: Debug code với 7-step protocol
• Supports: Python, JavaScript, Java, Go, Rust, C++, Ruby
• Example: "Fix lỗi IndexError trong hàm này"

5. documentation

• Category: CODE
• Priority: MEDIUM
• Description: Sinh tài liệu tự động
• Types: Docstrings (Google/NumPy/Sphinx), README, API ref, tutorials
• Example: "Sinh docstring cho hàm này"

6. testing

• Category: CODE
• Priority: HIGH
• Description: Sinh tests
• Types: unit, integration, E2E, property-based, mutation, fuzz, snapshot
• Frameworks: pytest, unittest, jest, vitest, mocha, cargo test, JUnit
• Example: "Viết unit tests cho class User"

7. algorithm_design

• Category: REASONING
• Priority: MEDIUM
• Description: Thiết kế thuật toán
• Approaches: Brute force, Greedy, D&C, DP, Backtracking, Graph algorithms
• Example: "Tối ưu thuật toán này từ O(n²) xuống O(n log n)"

8. data_analysis

• Category: DATA
• Priority: MEDIUM
• Description: Phân tích dữ liệu
• Steps: Loading, cleaning, statistics, correlation, outliers, visualization
• Libraries: pandas, numpy, scipy, matplotlib, seaborn, plotly
• Example: "Phân tích dataset này và tìm insights"

9. translation

• Category: LANGUAGE
• Priority: MEDIUM
• Description: Dịch song ngữ Việt-Anh
• Pairs: vi↔en, vi↔zh, vi↔ja, vi↔ko, vi↔fr
• Example: "Dịch đoạn văn này sang tiếng Anh"

10. summarization

• Category: LANGUAGE
• Priority: MEDIUM
• Description: Tóm tắt văn bản
• Methods: extractive, abstractive, key phrase, topic modeling
• Example: "Tóm tắt bài viết này trong 3 câu"

11. reasoning

• Category: REASONING
• Priority: HIGH
• Description: Suy luận đa bước
• Strategies: CoT, ToT, Self-Consistency, Reflexion, ReAct, Least-to-Most
• Example: "Tại sao bầu trời màu xanh?"

12. math_skill

• Category: REASONING
• Priority: HIGH
• Description: Giải toán đa cấp
• Domains: arithmetic, algebra, calculus, linear algebra, probability, statistics
• Tools: sympy, numpy, scipy
• Example: "Tính đạo hàm của x³ + 2x²"

13. sql_generation

• Category: DATA
• Priority: HIGH
• Description: Sinh SQL queries
• Dialects: PostgreSQL, MySQL, SQLite, SQL Server, Oracle, BigQuery, Snowflake
• Example: "Viết SQL tìm top 10 khách hàng"

14. security_audit

• Category: SECURITY
• Priority: CRITICAL
• Description: Audit bảo mật
• Standards: OWASP Top 10, SAST, dependency vulnerabilities
• Tools: bandit, semgrep, safety, pip-audit, trufflehog
• Example: "Audit code này cho security issues"

15. performance_optimization

• Category: DEVOPS
• Priority: MEDIUM
• Description: Tối ưu hiệu năng
• Categories: algorithmic, memory, concurrency, caching, I/O, Python-specific
• Tools: cProfile, line_profiler, memory_profiler, py-spy
• Example: "Tối ưu hàm này đang chạy chậm"

Usage

from nexus.skills import get_global_registry
from nexus.skills.base import SkillContext

registry = get_global_registry()

# List all skills
print(registry.list_skills())

# Route prompt to best skill
skill = registry.route("Viết hàm Python tính giai thừa")
print(f"Selected: {skill.name}")

# Execute skill
context = SkillContext(prompt="Viết hàm Python tính giai thừa")
result = skill.execute(context)
print(result.output)

Custom Skills

Tạo skill tùy chỉnh:

from nexus.skills.base import Skill, SkillResult, SkillContext, SkillCategory, SkillPriority

class MyCustomSkill(Skill):
    category = SkillCategory.CODE
    priority = SkillPriority.MEDIUM
    keywords = ["custom", "riêng"]
    
    @property
    def name(self) -> str:
        return "my_custom_skill"
    
    @property
    def description(self) -> str:
        return "My custom skill description"
    
    def execute(self, context: SkillContext) -> SkillResult:
        return SkillResult(success=True, output="Custom result")

# Register
from nexus.skills import get_global_registry
get_global_registry().register(MyCustomSkill())