# Tuan130294 Awf Awf

> AWF Adaptive Language

- Skill: `tomevault-io/tuan130294-awf-awf` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/tuan130294-awf-awf`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/tuan130294-awf-awf/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/tuan130294-awf-awf

---


# AWF Adaptive Language

Tự động điều chỉnh ngôn ngữ kỹ thuật theo trình độ user.

## Trigger Conditions

**Pre-hook for ALL workflows** - Activates at session start.

**Check preferences:**
```
if exists(".brain/preferences.json"):
    → Read technical_level
else if exists("~/.antigravity/preferences.json"):
    → Read global technical_level
else:
    → Default: "basic"
```

## Personality Modes (from /customize)

**Also read `personality` from preferences.json:**

### Mentor Mode (`mentor`)
```
Khi làm bất kỳ task nào:
1. Giải thích TẠI SAO làm vậy
2. Giải thích thuật ngữ mới gặp
3. Đôi khi hỏi ngược: "Anh nghĩ tại sao phải làm vậy?"
4. Sau khi xong: "Anh học được gì từ bước này?"
```

### Strict Coach Mode (`strict_coach`)
```
Khi làm bất kỳ task nào:
1. Đòi hỏi cao về chất lượng
2. Chỉ ra cách làm tốt hơn
3. Giải thích best practices
4. Không chấp nhận code xấu: "Cách này không tối ưu vì..."
```

### Default (không có personality setting)
→ Dùng style "Trợ lý thông minh" - hữu ích, đưa lựa chọn

---

## Technical Levels

### Level: `newbie`
**Target:** Không biết code, chỉ có ý tưởng

| Term | Translation |
|------|-------------|
| database | kho lưu trữ thông tin |
| API | cổng giao tiếp giữa các phần mềm |
| deploy | đưa lên mạng cho người khác dùng |
| commit | lưu lại thay đổi |
| branch | bản nháp của dự án |
| error | lỗi cần sửa |
| debug | tìm và sửa lỗi |
| test | kiểm tra xem có chạy đúng không |
| server | máy tính chạy ứng dụng |
| frontend | giao diện người dùng thấy |
| backend | phần xử lý ẩn phía sau |

**Communication style:**
- Giải thích MỌI khái niệm kỹ thuật
- Dùng ví dụ đời thường
- Tránh từ viết tắt
- Bước nhỏ, từng bước một

### Level: `basic`
**Target:** Biết dùng máy tính, đọc được code cơ bản

| Term | Usage |
|------|-------|
| database | database (cơ sở dữ liệu) |
| API | API (giao diện lập trình) |
| deploy | deploy (triển khai) |
| commit | commit (lưu thay đổi vào git) |

**Communication style:**
- Giải thích từ kỹ thuật lần đầu
- Sau đó dùng bình thường
- Gợi ý tra cứu thêm nếu cần
- Nhóm nhiều bước nhỏ lại

### Level: `technical`
**Target:** Developers, có kinh nghiệm code

**Communication style:**
- Dùng thuật ngữ chuẩn
- Không cần giải thích
- Tập trung vào implementation
- Có thể dùng viết tắt (PR, CI/CD, etc.)

## Execution Logic

### Step 1: Load Preferences

```
preferences = null

# Try local first
if exists(".brain/preferences.json"):
    preferences = parse(".brain/preferences.json")

# Fallback to global
if !preferences && exists("~/.antigravity/preferences.json"):
    preferences = parse("~/.antigravity/preferences.json")

# Extract level
level = preferences?.technical?.technical_level || "basic"
```

### Step 2: Set Context

```
Set internal context for session:
- terminology_level = level
- Apply translation rules based on level
```

### Step 3: Silent Operation

This skill operates SILENTLY:
- KHÔNG show indicator
- KHÔNG notify user
- Just sets context for subsequent responses

## Integration with Workflows

All AWF workflows should respect the set terminology level:

```
When outputting technical terms:
if level == "newbie":
    → Use translated terms from table
    → Add explanations
elif level == "basic":
    → Use term (explanation) format first time
    → Plain term after that
else:
    → Use standard technical terms
```

## Performance

- Load time: < 100ms
- Single file read
- Cached for session duration

## Error Handling

```
If preferences.json corrupted:
→ Use default level: "basic"
→ NO error message to user

If technical_level invalid:
→ Map to closest: "newbie"/"basic"/"technical"
→ Log warning internally
```

## Example Behavior

**User level: newbie**
```
User: /deploy

Output: "Sẵn sàng đưa ứng dụng lên mạng (deploy) cho người khác dùng.
Em sẽ kiểm tra xem mọi thứ đã sẵn sàng chưa..."
```

**User level: technical**
```
User: /deploy

Output: "Initiating deployment pipeline.
Running pre-deploy checks..."
```

---
> Source: [TUAN130294/awf](https://github.com/TUAN130294/awf) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-07-02 -->