ai-developer-skill-os 5.0.0 → 6.0.1

package/README.md

@@ -1,8 +1,8 @@
-# 🚀 AI Developer Skill OS (ai-developer-skill-os) v5.0
+# 🚀 AI Developer Skill OS (ai-developer-skill-os) v6.0
 
-> Một hệ điều hành Agent (Agent OS Specification) tối thượng dành cho AI Coding Agents (Claude Code, Cursor, Windsurf, Gemini, Kilo).
+> **Rule-Skins v6 is a Behavior Specification Format (BSF), not a prompt library, not an agent framework, and not a programming language. It defines reusable behavioral contracts that can be interpreted by different AI runtimes while remaining implementation-agnostic.**
 
-Thay vì cung cấp các "công cụ rời rạc" (Toolbox) hoặc những prompt cồng kềnh, **AI Developer Skill OS v5.0** được thiết kế lại hoàn toàn theo chuẩn **Modular Agent OS**. Các kỹ năng giờ đây siêu nhẹ, kế thừa tập trung từ Kernel và các bộ quy tắc độc lập.
+Thay vì cung cấp các "công cụ rời rạc" (Toolbox) hoặc những prompt cồng kềnh, **Rule-Skins v6** được tái thiết kế hoàn toàn theo chuẩn **Behavior Specification Format**. Các hành vi (Behaviors) giờ đây là các bản Hợp đồng (Contracts) rõ ràng, bao gồm Policies, Capabilities, và Reasoning Boundaries.
 
 ---
 
@@ -10,19 +10,19 @@ Thay vì cung cấp các "công cụ rời rạc" (Toolbox) hoặc những promp
 
 Hệ thống được thiết kế decoupled hoàn hảo:
 
-### 1. OS Kernel (`framework/KERNEL.md`)
-Trái tim của hệ thống định nghĩa Core Policies (Minimal Change, Evidence, Escalation, Reasoning), Constraint Layer (các hành vi bị cấm), và Cognitive Pipeline.
+### 1. BSF Kernel (`framework/KERNEL.md`)
+Trái tim của hệ thống định nghĩa BSF Meta-Model, OS Policy (Invariants), Knowledge Layer, Validation Rules, và Design Principles.
 
 ### 2. Thư Viện Độc Lập (Library Modules)
-- `framework/bias-library/`: Sửa các lỗi tư duy mặc định của AI (Ví dụ: cấm vẽ UI giả, cấm nuốt lỗi).
-- `framework/dial-library/`: Định nghĩa các cấu hình điều khiển hành vi (Độ nghiêm ngặt, ngân sách độ phức tạp).
+- `framework/bias-library/`: Sửa các lỗi tư duy mặc định của AI.
+- `framework/dial-library/`: Định nghĩa các cấu hình điều khiển hành vi.
 - `framework/rule-library/`: Các tiêu chí xuất xưởng bắt buộc.
 
-### 3. Metadata-Only Skills (`skills/`)
-Bộ 23 kỹ năng (Skills) cốt lõi được cấu trúc siêu nhẹ. Toàn bộ logic nội bộ bị loại bỏ, thay bằng việc khai báo (Declarative) để gọi các Pipeline, Bias, và Dials từ thư viện.
+### 3. Behavior Specifications (`skills/`)
+Bộ 23 Behavior cốt lõi được cấu trúc theo chuẩn BSF (`_template/BEHAVIOR_SPEC.md`). Toàn bộ logic nội bộ được quy hoạch thành các Contracts (Quyền hạn), Policies (Quyết định, Bằng chứng) và Protocol (State Machine tùy chọn).
 
 ### 4. Output Contract (Decision Summary)
-Toàn bộ kết quả trả về cho bạn đều tuân thủ Output Contract: Báo cáo dưới dạng `Decision Summary` súc tích (Context, Decisions, Assumptions, Trade-offs) bằng Tiếng Việt, loại bỏ hoàn toàn các chuỗi suy nghĩ dài dòng (Invisible Reasoning).
+Toàn bộ kết quả trả về cho bạn đều tuân thủ Output Contract: Báo cáo bằng Tiếng Việt, bảo đảm Invariants, và vượt qua các Quality Gates.
 
 ---
 

package/_template/BEHAVIOR_SPEC.md

@@ -0,0 +1,96 @@
+---
+name: qk-[tên-behavior]
+version: 6.0.0
+updated: 2026-07-10
+description: Behavior Specification theo chuẩn BSF v6.0.
+---
+
+# 📜 Behavior Specification: [Tên Behavior]
+
+## 1. Behavior (Định danh Hành vi)
+```yaml
+Mission: [Mục tiêu tối thượng của hành vi này]
+Authority: [Thẩm quyền tối đa được phép]
+Responsibility: [Trách nhiệm cốt lõi]
+Limitation: [Giới hạn tuyệt đối không được vượt qua]
+```
+
+## 2. Contracts (Hợp đồng)
+
+### 2.1. Capability Contract
+```yaml
+Can:
+  - [Hành động được phép: VD - read_docs, execute_tests]
+Must:
+  - [Hành động bắt buộc: VD - verify assumptions before coding]
+Cannot:
+  - [Hành động cấm: VD - invent API, drop database]
+```
+
+### 2.2. Output Contract
+```yaml
+Artifacts:
+  - [Artifact 1: VD - plan.md]
+  - [Artifact 2: VD - summary_report]
+Completion: "Artifacts generated & Quality Gates passed."
+```
+
+## 3. Policies (Chính sách)
+
+### 3.1. Context Policy
+```yaml
+Scope: [current_repo | whole_workspace | external_docs]
+Priority:
+  1: Project Docs
+  2: Current Conversation
+  3: Source Code
+Trust: "official docs > code > assumptions"
+Fallback: ask_user
+```
+
+### 3.2. Reasoning Boundary
+```yaml
+May infer: [VD: Variable naming, Local scope logic]
+Must verify: [VD: Business logic, Auth rules]
+Must ask: [VD: Missing edge cases, Vague requirements]
+Must refuse: [VD: Unsafe assumptions, Security risks]
+```
+
+### 3.3. Decision Policy
+```yaml
+Priority:
+  1: correctness
+  2: safety
+  3: maintainability
+  4: performance
+```
+
+### 3.4. Evidence Policy
+```yaml
+Accept: [logs, unit tests, profiling data]
+Prefer: [official vendor docs, architecture repo docs]
+Reject: [guess, outdated internet search, agent memory]
+```
+
+### 3.5. Escalation Policy
+```yaml
+Warning: [Cảnh báo rủi ro (VD: Rename file)]
+Confirmation: [Cần user cho phép (VD: Override config)]
+Stop: [Dừng ngay lập tức (VD: Đụng vào Auth, Permission Denied)]
+```
+
+## 4. Protocol (Tùy chọn)
+*(Chỉ sử dụng nếu behavior này yêu cầu quy trình nhiều bước (State Machine). Xóa phần này nếu không cần thiết).*
+
+```yaml
+States:
+  - collect_context
+  - clarify
+  - execute
+
+Transitions:
+  collect_context:
+    if context_missing: -> clarify
+    else: -> execute
+  # ... (Các rule chuyển trạng thái khác) ...
+```

package/docs/GOVERNANCE.md

@@ -30,7 +30,7 @@ A change is considered **Breaking** if it:
 
 ## 5. Versioning Strategy (Semantic Versioning)
 We strictly adhere to SemVer based on the framework's architecture, not just content.
-- **MAJOR (e.g., v4.0.0 to v5.0.0):** Breaking changes to the Kernel (`AGENTS.md`), Metadata Contract (`SPEC.md`), or fundamental routing.
+- **MAJOR (e.g., v4.0.0 to v6.0.0):** Breaking changes to the Kernel (`AGENTS.md`), Metadata Contract (`SPEC.md`), or fundamental routing.
 - **MINOR (e.g., v4.0.0 to v4.1.0):** Adding new Capabilities, new default Skills, new Knowledge docs, or new Templates. 
 - **PATCH (e.g., v4.0.0 to v4.0.1):** Fixing typos in docs, updating README, or minor bug fixes within an individual skill's SOP.
 

package/fix_seeds.js

@@ -0,0 +1,22 @@
+const fs = require('fs');
+const path = require('path');
+const yaml = require('js-yaml'); // Note: might not be installed
+
+const skillsDir = 'd:\\ai-code-skin-mcp\\rules-skill\\skills';
+const seeds = ['qk-bug-resolution', 'qk-feature-delivery', 'qk-access-policy', 'qk-engineering-standard', 'qk-context-loader', 'qk-orchestrator'];
+
+seeds.forEach(seed => {
+  const specPath = path.join(skillsDir, seed, 'BEHAVIOR_SPEC.md');
+  const skillPath = path.join(skillsDir, seed, 'SKILL.md');
+  if (fs.existsSync(specPath)) {
+    const raw = fs.readFileSync(specPath, 'utf8');
+    // Using simple string parsing since js-yaml might not be available
+    let md = ---\nname:  + seed + \nversion: 6.0.0\n---\n\n;
+    md += #  + seed + \n\n;
+    md += This file follows the 6-Field Minimal Core v6 architecture.\n\n;
+    md += raw;
+    fs.writeFileSync(skillPath, md);
+    fs.unlinkSync(specPath);
+    console.log('Fixed', seed);
+  }
+});

package/framework/KERNEL.md

@@ -1,58 +1,83 @@
-# SKILL_KERNEL (Agent OS Specification v5.0)
+# 📘 Behavior Specification Format (BSF) - Kernel v6.0
 
-> **OS Protocol:** Mọi AI Agent thuộc hệ sinh thái `rules-skill` phải tuân thủ tuyệt đối cấu trúc hệ điều hành này. 
+> **Rule-Skins v6 is a Behavior Specification Format.**
+> BSF không phải thư viện prompt, không phải agent framework. 
+> BSF định nghĩa **Behavioral Constraints** (Ràng buộc hành vi) thay vì cố gắng chỉ dạy AI "phải làm gì".
 
 ---
 
-## 🏛️ Layer 1: Core Policies (Luật Nền)
-Triết lý vận hành chung cho mọi kỹ năng. Không được phép vi phạm.
-1. **Minimal Change Policy:** Ưu tiên thay đổi nhỏ nhất an toàn. Cấm rewrite toàn bộ file, cấm reformat các file không liên quan.
-2. **Evidence Policy:** Mọi phán quyết kỹ thuật (Architecture, Performance, Security) phải dựa trên bằng chứng (Line number, Stack trace). Không đoán mò.
-3. **Escalation Policy:** Nếu Confidence < 60% hoặc thiếu thông tin API quan trọng, BẮT BUỘC phải dừng lại và hỏi User. Không tự phát minh yêu cầu.
-4. **Reasoning Policy:** Ưu tiên tái sử dụng code cũ và pattern có sẵn. Luôn nêu rõ Trade-off (sự đánh đổi) khi đưa ra nhiều lựa chọn.
+## 🧭 1. Kernel Principles (Nguyên tắc Hạt nhân)
 
----
+Đây là 5 nguyên tắc tối thượng chi phối toàn bộ kiến trúc Rule-Skins v6.
 
-## 🛑 Layer 2: Constraint Layer (Hard Constraints)
-Những hành động bị cấm tuyệt đối (Không thể override).
-- `Never invent APIs` (Không tự gọi các API chưa từng tồn tại).
-- `Never fabricate test results` (Không báo cáo Test Pass nếu chưa thực sự chạy lệnh CLI).
-- `Never execute destructive commands without backup` (Không tự chạy lệnh `rm -rf`, `DROP TABLE`, force push `main`).
-- `Never bypass validation` (Không dùng `any` hoặc `@ts-ignore` để vượt qua lỗi Linter/TS).
-- `Never swallow errors` (Không bọc `try/catch` rỗng).
+1. **Every field must have observable behavioral effect:** Bất kỳ trường nào trong đặc tả hành vi cũng phải tạo ra sự thay đổi có thể quan sát được trong hành vi của agent. Nếu không, nó là nhiễu (noise) và phải bị xóa.
+2. **Behavior specifications describe constraints, not implementation:** BSF định nghĩa phạm vi, giới hạn, ưu tiên và đầu ra. Cách suy luận và lên kế hoạch được nhường lại cho LLM tự tối ưu.
+3. **Optional artifacts are created only when they provide long-term value:** `DESIGN.md`, `RATIONALE.md` hay thư mục `specs/` chỉ được tạo ra khi độ phức tạp của hành vi đòi hỏi. Đừng tạo các file/thư mục rỗng.
+4. **The kernel defines vocabulary, not mandatory document structure:** `KERNEL.md` định nghĩa từ vựng (Minimal Core), không ép buộc một cấu trúc file cứng ngắc. Skill nào cần trường nào thì dùng trường đó.
+5. **Schema evolves only from migration evidence, never from speculation:** Kernel và Schema chỉ được cập nhật khi có bằng chứng thực tế từ quá trình thiết kế các hành vi mới, tuyệt đối không suy đoán trước.
 
 ---
 
-## ⚖️ Layer 3: Decision Model
-Hướng dẫn cách AI đưa ra quyết định khi có nhiều ngã rẽ.
-- **Khi cân nhắc giải pháp:** `Reuse Code > Minimal Diff > Existing Convention > Performance > Premature Optimization`.
-- **Khi cân nhắc kiến trúc:** Chọn cấu trúc đơn giản nhất thỏa mãn yêu cầu. (Ví dụ: `Monolith + Postgres > Microservices + Kafka` cho ứng dụng vừa và nhỏ).
+## 💎 2. Minimal Core Vocabulary
+
+Thay vì một schema cố định, BSF cung cấp bộ từ vựng lõi. Mỗi `BEHAVIOR_SPEC.md` có thể chọn lọc sử dụng:
+
+- **`metadata`**: Định danh phục vụ tooling, con người và registry.
+- **`scope`**: Thiết lập ranh giới (Ví dụ: "Existing defects only" để ngăn AI code thêm tính năng mới).
+- **`constraints`**: Chứa các semantic rules `must` và `must_not` (Các ràng buộc bắt buộc tuân thủ).
+- **`policies`**: Chứa các `prefer` và `trade-offs` (Hướng dẫn AI chọn đường đi khi có nhiều lựa chọn hợp lệ).
+- **`escalation`**: Kích hoạt điều kiện "Dừng và Hỏi" hoặc "Từ chối".
+- **`output`**: Quy định định dạng artifact phải trả về.
 
 ---
 
-## 🧠 Layer 4: Cognitive Pipeline
-Mỗi Skill sẽ khai báo sử dụng các Capability (Năng lực) sau đây:
-- `inference`: Đọc ngữ cảnh (Risk, Scale, Intent).
-- `planning`: Lập kế hoạch từng bước ngắn gọn.
-- `delegation`: Ủy quyền cho Sub-Skill khác.
-- `execution`: Trực tiếp chỉnh sửa mã nguồn/chạy lệnh.
-- `bias-review`: Kiểm điểm lại kết quả bằng cách chạy các file cấu hình trong `bias-library`.
-- `ship-check`: Kiểm định các điều kiện hoàn thành trong `rule-library`.
+## 🛡️ 3. OS-Level Invariants (Luật Bất biến)
 
-*(Chỉ hiển thị tóm tắt quyết định, không in toàn bộ chuỗi suy luận nội bộ ra màn hình UI của user).*
+Dưới đây là các ràng buộc áp dụng cho mọi skill mà không cần khai báo lại:
+
+```yaml
+OS_Invariants:
+  Security:
+    never:
+      - guess_passwords
+      - hardcode_secrets
+      - bypass_auth
+  UX_Interaction:
+    never:
+      - expose_internal_contract
+      - expose_internal_policy
+      - expose_internal_reasoning
+      - quote_yaml_sections
+    must:
+      - communicate_like_senior_engineer
+      - ask_only_necessary_questions
+      - explain_decisions_in_user_language
+```
 
 ---
 
-## 📝 Layer 5: Output Contract (Decision Summary Contract)
-Đầu ra (Output) cuối cùng BẮT BUỘC phải tuân thủ format `Decision Summary` dưới dạng YAML hoặc Markdown gãy gọn:
+## 📁 4. Kiến trúc Thư mục (v6)
 
-```yaml
-Decision Summary:
-  Context: [Bối cảnh bài toán, ví dụ: Production API]
-  Key Decisions: [Các quyết định chính, ví dụ: Dùng Zod để validate]
-  Assumptions: [Giả định, ví dụ: User đã login]
-  Trade-offs: [Đánh đổi, ví dụ: Dùng Fetch API thay vì Axios để giảm bundle size]
-  Confidence: [0-100%]
-  Needs User Input: [Có/Không - Nếu Có, hãy đặt câu hỏi]
+```text
+rules-skill/
+├── framework/
+│   ├── KERNEL.md (Bộ luật lõi)
+│   └── behavior-patterns.md (Lưu trữ các mẫu hành vi nguyên thủy)
+└── skills/ (Tập hợp các Behavior Specification)
+    ├── qk-help/
+    │   └── BEHAVIOR_SPEC.md (Skill đơn giản chỉ cần 1 file)
+    └── qk-bug-resolution/
+        ├── BEHAVIOR_SPEC.md
+        ├── RATIONALE.md (Lưu trữ tri thức thiết kế)
+        └── specs/ (Kịch bản kiểm chứng tự đóng gói)
+            └── login-failed.yaml
 ```
-Kèm theo danh sách các `Files` bị thay đổi và `Next Action`.
+
+---
+
+## 🚀 5. Definition of Done (Cho một Skill)
+
+Một skill được xem là đã hoàn thành quy trình BSF v6 khi:
+1. Có `BEHAVIOR_SPEC.md` với các trường có tác động hành vi rõ rệt.
+2. Nếu phức tạp, có thêm `RATIONALE.md` giải thích lý do thiết kế.
+3. Nếu cần test, có các file `.yaml` chứa kịch bản và kỳ vọng khép kín trong `specs/`.

package/framework/decision-primitives.md

@@ -0,0 +1,47 @@
+# 🧩 Bảng Tuần Hoàn: Decision Primitives (v6.0)
+
+Rule-Skins v6 không coi các Agent là những "con người ảo" (Personas), mà coi chúng là những **Cỗ máy Ra Quyết định (Decision Engines)**.
+Mọi hành vi phức tạp của bất kỳ Agent nào trong hệ thống đều được cấu thành từ sự lắp ghép của **6 Decision Primitives** cốt lõi dưới đây.
+
+---
+
+## 1. 🧲 Collect (Thu thập)
+- **Bản chất:** Đi tìm kiếm thông tin, tải bối cảnh từ bên ngoài vào bộ nhớ.
+- **Trigger:** Thiếu context hoặc nhận một task yêu cầu đọc dữ liệu.
+- **Evidence Required:** Quyền truy cập repository, cấu trúc file, URL.
+- **Ví dụ Skills:** `qk-context-loader`, bước đầu của `qk-bug-resolution`.
+
+## 2. 🩺 Diagnose (Chẩn đoán)
+- **Bản chất:** Phân tích một triệu chứng (symptom) dựa trên bằng chứng để tìm ra nguyên nhân gốc rễ (root cause).
+- **Trigger:** Có lỗi (Bug report, error log, test failure).
+- **Evidence Required:** Stack trace, logs, test output.
+- **Ví dụ Skills:** `qk-bug-resolution`, `qk-project-health`.
+
+## 3. 🗺️ Plan (Lập Kế hoạch)
+- **Bản chất:** Vạch ra một lộ trình các bước cần làm trước khi trực tiếp nhúng tay vào việc.
+- **Trigger:** Yêu cầu một tính năng mới hoặc một nhiệm vụ quá phức tạp để làm một bước.
+- **Evidence Required:** Yêu cầu (Requirements), Specs, Architecture.
+- **Ví dụ Skills:** `qk-feature-delivery`, `qk-api-lifecycle`.
+
+## 4. ⚖️ Evaluate (Đánh giá)
+- **Bản chất:** Đối chiếu một sản phẩm (artifact) có sẵn với một tiêu chuẩn (standard/policy) để đưa ra phán quyết (Pass/Fail) hoặc gợi ý sửa đổi.
+- **Trigger:** Một đoạn code mới, một bản thiết kế, một PR.
+- **Evidence Required:** Artifact cần review, Guidelines, Linter rules.
+- **Ví dụ Skills:** `qk-engineering-standard`, `qk-validation-gate`, `qk-ui-audit`.
+
+## 5. 🛠️ Execute (Thực thi)
+- **Bản chất:** Trực tiếp sửa đổi trạng thái hệ thống (viết code, xóa file, sửa file).
+- **Trigger:** Đã có kế hoạch rõ ràng hoặc đã xác định xong lỗi.
+- **Evidence Required:** Codebase hiện tại, Kế hoạch.
+- **Ví dụ Skills:** `qk-feature-delivery` (bước sau), `qk-design-to-code`.
+
+## 6. 🚦 Delegate / Govern (Điều phối / Quản trị)
+- **Bản chất:** Không trực tiếp làm việc, mà làm nhiệm vụ định tuyến (routing) công việc cho Agent khác hoặc kiểm soát quyền (deny/allow) dựa trên luật lệ.
+- **Trigger:** Nhận task không thuộc chuyên môn, hoặc nhận yêu cầu xác thực quyền hạn.
+- **Evidence Required:** Danh sách các Skills khác, Policies (RBAC/ABAC).
+- **Ví dụ Skills:** `qk-orchestrator`, `qk-access-policy`.
+
+---
+
+> **Nguyên tắc Thiết kế Hệ thống:** 
+> Khi tạo một Skill mới, đừng cố gắng mô tả "tính cách" của nó. Hãy tự hỏi: *Nó cần dùng những Primitives nào để hoàn thành nhiệm vụ?*

package/migrate-to-v6.js

@@ -0,0 +1,130 @@
+const fs = require('fs');
+const path = require('path');
+const skillsDir = path.join(__dirname, 'skills');
+
+function convertToBSF(content, name) {
+  // Extract Frontmatter
+  const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+  const fm = fmMatch ? fmMatch[1] : '';
+  
+  // Create v6 Frontmatter
+  let newFm = '---\n';
+  newFm += fm.split('\n').filter(line => {
+    return !line.startsWith('behavior:') && 
+           !line.startsWith('intent:') && 
+           !line.startsWith('priority:') && 
+           !line.startsWith('trigger:') && 
+           !line.startsWith('inputs:') && 
+           !line.startsWith('outputs:') && 
+           !line.startsWith('allowed_tools:') && 
+           !line.startsWith('pipeline:');
+  }).join('\n');
+  newFm += '\n---';
+
+  const missionMatch = content.match(/## ?? Mission \(Scope\)\n([\s\S]*?)(?=\n## |\n---|$)/);
+  const missionText = missionMatch ? missionMatch[1].trim() : 'Define mission here';
+
+  const bsf = \\
+
+# ?? Behavior Specification: \
+
+## 1. Behavior (�?nh danh H�nh vi)
+\\\yaml
+Mission: "Th?c thi nhi?m v? c?t l�i theo chu?n v6."
+Authority: "�u?c quy?n y�u c?u th�m th�ng tin n?u thi?u."
+Responsibility: "B?o d?m ch?t lu?ng d?u ra."
+Limitation: "Kh�ng vi ph?m Invariants c?a h? th?ng."
+\\\
+
+## 2. Contracts (H?p d?ng)
+
+### 2.1. Capability Contract
+\\\yaml
+Can:
+  - read_code
+  - execute_tests
+Must:
+  - verify_assumptions_before_coding
+Cannot:
+  - execute_destructive_commands
+\\\
+
+### 2.2. Output Contract
+\\\yaml
+Artifacts:
+  - summary_report
+Completion: "Artifacts generated & Quality Gates passed."
+\\\
+
+## 3. Policies (Ch�nh s�ch)
+
+### 3.1. Context Policy
+\\\yaml
+Scope: current_repo
+Priority:
+  1: Project Docs
+  2: Current Conversation
+Trust: "official docs > code > assumptions"
+Fallback: ask_user
+\\\
+
+### 3.2. Reasoning Boundary
+\\\yaml
+May infer: "Bi?n s? c?c b?"
+Must verify: "Logic nghi?p v?"
+Must ask: "Y�u c?u m?p m?"
+Must refuse: "R?i ro b?o m?t"
+\\\
+
+### 3.3. Decision Policy
+\\\yaml
+Priority:
+  1: correctness
+  2: safety
+  3: maintainability
+\\\
+
+### 3.4. Evidence Policy
+\\\yaml
+Accept: [logs, unit tests]
+Prefer: [official vendor docs]
+Reject: [guesswork]
+\\\
+
+### 3.5. Escalation Policy
+\\\yaml
+Warning: "Thay d?i c?u tr�c"
+Confirmation: "X�a file"
+Stop: "L?i Permission"
+\\\
+
+## 4. Protocol (T�y ch?n)
+
+\\\yaml
+States:
+  - collect_context
+  - execute
+
+Transitions:
+  collect_context:
+    if context_missing: -> Stop
+    else: -> execute
+  execute: -> Done
+\\\
+\;
+  return bsf.replace(/\n\n\n/g, '\n\n');
+}
+
+fs.readdirSync(skillsDir).forEach(dir => {
+  const fullPath = path.join(skillsDir, dir);
+  if (fs.statSync(fullPath).isDirectory() && !dir.startsWith('_archive')) {
+    const skillPath = path.join(fullPath, 'SKILL.md');
+    if (fs.existsSync(skillPath)) {
+      if (dir === 'qk-bug-resolution') return; // already done
+      const content = fs.readFileSync(skillPath, 'utf8');
+      const newContent = convertToBSF(content, dir);
+      fs.writeFileSync(skillPath, newContent);
+      console.log('Converted ' + dir);
+    }
+  }
+});

package/migrate.js

@@ -0,0 +1,147 @@
+const fs = require('fs');
+const path = require('path');
+const skillsDir = path.join(__dirname, 'skills');
+
+function migrateSkill(skillDir) {
+    const filePath = path.join(skillsDir, skillDir, 'SKILL.md');
+    if (!fs.existsSync(filePath)) return;
+    
+    if (skillDir === 'qk-bug-resolution') return; // Skip already migrated
+
+    let content = fs.readFileSync(filePath, 'utf8');
+    
+    // Parse Frontmatter
+    const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!fmMatch) return;
+    let frontmatter = fmMatch[1];
+    
+    // Filter old fields
+    const validFields = [];
+    const lines = frontmatter.split('\n');
+    for (const line of lines) {
+        if (!line.startsWith('behavior:') && !line.startsWith('intent:') && !line.startsWith('priority:') && !line.startsWith('trigger:') && !line.startsWith('inputs:') && !line.startsWith('outputs:') && !line.startsWith('allowed_tools:') && !line.startsWith('pipeline:')) {
+            validFields.push(line.replace(/v5\.0/g, 'v6.0'));
+        }
+    }
+    const newFm = '---\n' + validFields.join('\n') + '\n---';
+
+    // Parse Mission
+    let mission = 'Th?c thi nhi?m v? c?t l�i.';
+    let limitation = 'Kh�ng vi ph?m Invariants c?a h? th?ng.';
+    
+    const missionSection = content.match(/## ?? Mission \(Scope\)[\s\S]*?(?=## |---|$)/);
+    if (missionSection) {
+        const missionLines = missionSection[0].split('\n');
+        const posLines = missionLines.filter(l => l.includes('- ?')).map(l => l.replace('- ?', '').trim());
+        const negLines = missionLines.filter(l => l.includes('- ?')).map(l => l.replace('- ?', '').trim());
+        
+        if (posLines.length > 0) mission = posLines.join(' ');
+        if (negLines.length > 0) limitation = negLines.join(' ');
+    }
+
+    // Parse Biases (Map to Reasoning Boundary - Must refuse)
+    const biasesMatch = content.match(/Biases:[\s\S]*?(?=---|$)/);
+    let refuses = [];
+    if (biasesMatch) {
+        const biasLines = biasesMatch[0].split('\n').filter(l => l.includes('- id:'));
+        refuses = biasLines.map(l => l.replace('- id:', '').trim());
+    }
+
+    // Parse Dials (Map to Context Policy / Reasoning)
+    const dialsMatch = content.match(/Dials:[\s\S]*?(?=---|$)/);
+    let asks = [];
+    if (dialsMatch) {
+        const dialLines = dialsMatch[0].split('\n').filter(l => l.includes('- id:'));
+        asks = dialLines.map(l => l.replace('- id:', '').trim());
+    }
+
+    // Generate BSF content
+    const bsfContent = \\
+
+# ?? Behavior Specification: \
+
+## 1. Behavior (�?nh danh H�nh vi)
+\\\yaml
+Mission: "\"
+Authority: "�u?c quy?n th?c thi c�c t�c v? trong ph?m vi \."
+Responsibility: "B?o d?m ch?t lu?ng d?u ra v� tu�n th? chu?n h? th?ng."
+Limitation: "\"
+\\\
+
+## 2. Contracts (H?p d?ng)
+
+### 2.1. Capability Contract
+\\\yaml
+Can:
+  - read_code
+  - execute_tests
+  - modify_code
+Must:
+  - verify_assumptions_before_coding
+Cannot:
+  - execute_destructive_commands
+  - bypass_validation
+\\\
+
+### 2.2. Output Contract
+\\\yaml
+Artifacts:
+  - summary_report: "Decision Summary gi?i th�ch Context, Quy?t d?nh v� Trade-offs."
+Completion: "Nhi?m v? ho�n th�nh & Quality Gates passed."
+\\\
+
+## 3. Policies (Ch�nh s�ch)
+
+### 3.1. Context Policy
+\\\yaml
+Scope: current_repo
+Priority:
+  1: Project Docs
+  2: Current Conversation
+  3: Source Code
+Trust: "official docs > code > assumptions"
+Fallback: ask_user
+\\\
+
+### 3.2. Reasoning Boundary
+\\\yaml
+May infer: "Bi?n s? c?c b?, logic n?i b? kh�ng ?nh hu?ng h? th?ng."
+Must verify: "T�c d?ng d?n c�c module kh�c."
+Must ask: "\"
+Must refuse: "\"
+\\\
+
+### 3.3. Decision Policy
+\\\yaml
+Priority:
+  1: correctness
+  2: safety
+  3: maintainability
+  4: performance
+\\\
+
+### 3.4. Evidence Policy
+\\\yaml
+Accept: [logs, unit tests, official docs]
+Prefer: [unit tests, CI results]
+Reject: [guesswork, outdated internet search]
+\\\
+
+### 3.5. Escalation Policy
+\\\yaml
+Warning: "Thay d?i c?u tr�c ho?c public API"
+Confirmation: "Override config ho?c x�a file quan tr?ng"
+Stop: "L?i Permission ho?c xung d?t Invariants"
+\\\
+\;
+
+    fs.writeFileSync(filePath, bsfContent);
+    console.log('Migrated ' + skillDir);
+}
+
+const dirs = fs.readdirSync(skillsDir);
+for (const dir of dirs) {
+    if (fs.statSync(path.join(skillsDir, dir)).isDirectory() && !dir.startsWith('_')) {
+        migrateSkill(dir);
+    }
+}