ai-developer-skill-os 5.0.0 → 6.0.1

package/migrate.py

@@ -0,0 +1,133 @@
+import os
+import re
+
+skills_dir = os.path.join(os.getcwd(), 'skills')
+
+def migrate_skill(skill_dir):
+    file_path = os.path.join(skills_dir, skill_dir, 'SKILL.md')
+    if not os.path.exists(file_path): return
+    if skill_dir in ['qk-bug-resolution', 'qk-access-policy']: return
+
+    with open(file_path, 'r', encoding='utf-8') as f:
+        content = f.read()
+
+    fm_match = re.search(r'^---\n(.*?)\n---', content, re.DOTALL)
+    if not fm_match: return
+    frontmatter = fm_match.group(1)
+
+    valid_fields = []
+    for line in frontmatter.split('\n'):
+        if not any(line.startswith(prefix) for prefix in ['behavior:', 'intent:', 'priority:', 'trigger:', 'inputs:', 'outputs:', 'allowed_tools:', 'pipeline:']):
+            valid_fields.append(line.replace('v5.0', 'v6.0'))
+
+    new_fm = '---\n' + '\n'.join(valid_fields) + '\n---'
+
+    mission = f'Th?c thi nhi?m v? c?t l�i c?a {skill_dir}'
+    limitation = 'Kh�ng vi ph?m Invariants c?a h? th?ng.'
+    
+    mission_section = re.search(r'## .*?Mission \(Scope\)(.*?)(?=## |---|$)', content, re.DOTALL)
+    if mission_section:
+        lines = mission_section.group(1).split('\n')
+        pos = [l.split('- ?')[-1].strip() for l in lines if '- ?' in l]
+        neg = [l.split('- ?')[-1].strip() for l in lines if '- ?' in l]
+        if pos: mission = ' '.join(pos)
+        if neg: limitation = ' '.join(neg)
+
+    biases_match = re.search(r'Biases:(.*?)(?=---|$)', content, re.DOTALL)
+    refuses = []
+    if biases_match:
+        refuses = [l.replace('- id:', '').strip() for l in biases_match.group(1).split('\n') if '- id:' in l]
+
+    dials_match = re.search(r'Dials:(.*?)(?=---|$)', content, re.DOTALL)
+    asks = []
+    if dials_match:
+        asks = [l.replace('- id:', '').strip() for l in dials_match.group(1).split('\n') if '- id:' in l]
+
+    must_ask = ', '.join(asks) if asks else 'Y�u c?u m?p m?, thi?u th�ng tin.'
+    must_refuse = ', '.join(refuses) if refuses else 'R?i ro b?o m?t, ph� v? ki?n tr�c.'
+
+    bsf_content = f'''{new_fm}
+
+# ?? Behavior Specification: {skill_dir}
+
+## 1. Behavior (�?nh danh H�nh vi)
+`yaml
+Mission: "{mission.replace('"', "'")}"
+Authority: "�u?c quy?n th?c thi c�c t�c v? trong ph?m vi {skill_dir}."
+Responsibility: "B?o d?m ch?t lu?ng d?u ra v� tu�n th? chu?n h? th?ng."
+Limitation: "{limitation.replace('"', "'")}"
+`
+
+## 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_ask.replace('"', "'")}"
+Must refuse: "{must_refuse.replace('"', "'")}"
+`
+
+### 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"
+`
+'''
+    with open(file_path, 'w', encoding='utf-8') as f:
+        f.write(bsf_content)
+    print(f'Migrated {skill_dir}')
+
+for d in os.listdir(skills_dir):
+    if os.path.isdir(os.path.join(skills_dir, d)) and not d.startswith('_'):
+        migrate_skill(d)

package/migrate_all.cjs

@@ -0,0 +1,96 @@
+const fs = require('fs');
+const path = require('path');
+const skillsDir = path.join(__dirname, 'skills');
+
+const template = `---
+name: {NAME}
+version: 6.0.0
+updated: 2026-07-10
+description: Behavior Specification for {NAME} in BSF v6.0 format.
+category: orchestration
+tags: [bsf, v6]
+platforms: [claude-code, cursor, windsurf, gemini-cli]
+---
+
+# Behavior Specification: {NAME}
+
+## 1. Behavior
+\`\`\`yaml
+Mission: "Execute core tasks for {NAME}."
+Authority: "Full authority within the scope of {NAME}."
+Responsibility: "Ensure the system complies with v6 standards."
+Limitation: "Do not violate System Invariants."
+\`\`\`
+
+## 2. Contracts
+
+### 2.1. Capability Contract
+\`\`\`yaml
+Can:
+  - read_code
+  - modify_code
+Must:
+  - verify_assumptions_before_coding
+Cannot:
+  - bypass_validation
+\`\`\`
+
+### 2.2. Output Contract
+\`\`\`yaml
+Artifacts:
+  - summary_report: "Progress and decision report."
+Completion: "Feature works & Quality Gates passed."
+\`\`\`
+
+## 3. Policies
+
+### 3.1. Context Policy
+\`\`\`yaml
+Scope: whole_workspace
+Priority:
+  1: Project Guidelines
+  2: Current Code
+Trust: "official docs > code > user assumptions"
+Fallback: ask_user
+\`\`\`
+
+### 3.2. Reasoning Boundary
+\`\`\`yaml
+May infer: "Local variables and obvious logic."
+Must verify: "Cross-module impacts."
+Must ask: "Vague requirements, missing context."
+Must refuse: "Security risks, baseless guesses."
+\`\`\`
+
+### 3.3. Decision Policy
+\`\`\`yaml
+Priority:
+  1: correctness
+  2: safety
+  3: maintainability
+\`\`\`
+
+### 3.4. Evidence Policy
+\`\`\`yaml
+Accept: [unit tests, CI logs]
+Prefer: [end-to-end tests]
+Reject: [guesswork]
+\`\`\`
+
+### 3.5. Escalation Policy
+\`\`\`yaml
+Warning: "Changing task scope."
+Confirmation: "Overriding config or deleting files."
+Stop: "Critical security error."
+\`\`\`
+`;
+
+const dirs = fs.readdirSync(skillsDir);
+for (const dir of dirs) {
+    if (dir.startsWith('_') || dir === 'qk-bug-resolution' || dir === 'qk-access-policy') continue;
+    const p = path.join(skillsDir, dir, 'SKILL.md');
+    if (fs.existsSync(p)) {
+        fs.writeFileSync(p, template.replace(/{NAME}/g, dir), 'utf8');
+        console.log('Updated ' + dir);
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ai-developer-skill-os",
-  "version": "5.0.0",
-  "description": "Multi-agent skill package cho AI coding agents (Claude, Cursor, Windsurf, Antigravity) với 23 skills chuyên nghiệp.",
+  "version": "6.0.1",
+  "description": "Behavior Specification Format Framework, AI coding agents (Claude, Cursor, Windsurf, Antigravity) với 23 skills chuyên nghiệp.",
   "main": "bin/install.js",
   "bin": {
     "ai-developer-skill-os": "bin/install.js",

package/skills/qk-access-policy/SKILL.md

@@ -1,57 +1,35 @@
 ---
 name: qk-access-policy
-version: 5.0.0
-updated: 2026-07-03
-description: Quản lý RBAC, ABAC và các ranh giới bảo mật.
 category: security
-tags: [security, rbac, abac, auth]
-platforms: [claude-code, cursor, windsurf, gemini-cli]
+version: 6.0.0
 ---
 
-# 🛠️ qk-access-policy
+# qk-access-policy
 
-> **Inheritance:** Kỹ năng này tuân thủ Kiến trúc v5.0 của `framework/KERNEL.md`.
-> Output bắt buộc là Decision Summary.
+## Scope
+- Security boundaries and policies (Govern)
 
----
-
-## 🎯 Mission (Scope)
-- ✅ Thiết kế và triển khai phân quyền hệ thống.
-- ❌ Do NOT bỏ qua các lỗ hổng bảo mật hiển nhiên (như lộ mật khẩu, thiếu mã hóa).
-
----
-
-## ⚙️ Capabilities (Cognitive Pipeline)
+## Constraints
 ```yaml
-Pipeline:
-  - inference
-  - planning
-  - execution
-  - bias-review
-  - ship-check
+must:
+  - Enforce access controls at API level
+  - Check security rules
+must_not:
+  - Rely on UI-only security
 ```
 
----
-
-## 🎛️ Dials (Hành vi)
+## Policies
 ```yaml
-Dials:
-  - id: granularity # (Coarse vs Fine-grained)
-  - id: strictness
+prefer:
+  - Deny-by-default
 ```
 
----
-
-## 🛡️ Biases (Sửa lỗi mặc định)
+## Escalation
 ```yaml
-Biases:
-  - id: ui-only-security # (Chỉ ẩn nút ở frontend mà quên chặn API backend)
+stop:
+  - Policy is missing or ambiguous
 ```
 
----
-
-## 🛫 Ship Criteria
-```yaml
-Rules:
-  - id: end-to-end-validation
+## Output
+- Policy enforcement decision
 ```

package/skills/qk-ai-builder/SKILL.md

@@ -1,57 +1,37 @@
 ---
 name: qk-ai-builder
-version: 5.0.0
-updated: 2026-07-03
-description: Thiết kế AI Logic, Prompts, RAG pipelines, và các Agents.
 category: ai
-tags: [ai, llm, prompt-engineering, rag, agents]
-platforms: [claude-code, cursor, windsurf, gemini-cli]
+version: 6.0.0
 ---
 
-# 🛠️ qk-ai-builder
+# qk-ai-builder
 
-> **Inheritance:** Kỹ năng này tuân thủ Kiến trúc v5.0 của `framework/KERNEL.md`.
-> Output bắt buộc là Decision Summary.
+## Scope
+- AI logic, prompts, RAG pipelines, and Agents (Plan & Execute)
 
----
-
-## 🎯 Mission (Scope)
-- ✅ Xây dựng luồng AI/LLM, viết Prompts chuyên nghiệp.
-- ❌ Do NOT dùng LLM để thay thế các logic cứng có thể giải quyết bằng Code (như tính toán).
-
----
-
-## ⚙️ Capabilities (Cognitive Pipeline)
+## Constraints
 ```yaml
-Pipeline:
-  - inference
-  - planning
-  - execution
-  - bias-review
-  - ship-check
+must:
+  - Validate prompt changes against actual model outputs
+  - Handle API rate limits and failures gracefully
+must_not:
+  - Use LLMs for deterministic logic (e.g. math, exact matching)
+  - Fabricate non-existent models or APIs
 ```
 
----
-
-## 🎛️ Dials (Hành vi)
+## Policies
 ```yaml
-Dials:
-  - id: complexity-budget
+prefer:
+  - System prompts over user prompts for constraints
+  - Few-shot examples over complex instructions
 ```
 
----
-
-## 🛡️ Biases (Sửa lỗi mặc định)
+## Escalation
 ```yaml
-Biases:
-  - id: swallow-errors # (Bỏ qua lỗi API gọi LLM thất bại)
-  - id: hallucinated-tools # (Tự bịa model không tồn tại)
+stop:
+  - Model context window limits are exceeded
 ```
 
----
-
-## 🛫 Ship Criteria
-```yaml
-Rules:
-  - id: end-to-end-validation
+## Output
+- Prompts, pipelines, or Agent configuration
 ```

package/skills/qk-api-lifecycle/SKILL.md

@@ -1,57 +1,38 @@
 ---
 name: qk-api-lifecycle
-version: 5.0.0
-updated: 2026-07-03
-description: Thiết kế, triển khai, và tích hợp các API endpoints.
-category: backend
-tags: [api, rest, graphql, integration]
-platforms: [claude-code, cursor, windsurf, gemini-cli]
+category: fullstack
+version: 6.0.0
 ---
 
-# 🛠️ qk-api-lifecycle
+# qk-api-lifecycle
 
-> **Inheritance:** Kỹ năng này tuân thủ Kiến trúc v5.0 của `framework/KERNEL.md`.
-> Output bắt buộc là Decision Summary.
+## Scope
+- API design, endpoints, contracts, and lifecycle management (Plan & Execute)
 
----
-
-## 🎯 Mission (Scope)
-- ✅ Thiết kế RESTful hoặc GraphQL API chuẩn mực.
-- ❌ Do NOT trả về mã `200 OK` cho các response bị lỗi `error: true`.
-
----
-
-## ⚙️ Capabilities (Cognitive Pipeline)
+## Constraints
 ```yaml
-Pipeline:
-  - inference
-  - planning
-  - execution
-  - bias-review
-  - ship-check
+must:
+  - Define clear request/response contracts (OpenAPI/Swagger)
+  - Ensure backward compatibility on existing endpoints
+must_not:
+  - Introduce breaking changes without versioning
+  - Bypass authentication or authorization checks
 ```
 
----
-
-## 🎛️ Dials (Hành vi)
+## Policies
 ```yaml
-Dials:
-  - id: rest-strictness
+prefer:
+  - RESTful resource naming conventions
+  - Meaningful HTTP status codes
 ```
 
----
-
-## 🛡️ Biases (Sửa lỗi mặc định)
+## Escalation
 ```yaml
-Biases:
-  - id: swallow-errors
-  - id: enterprise-crud # (Dùng gRPC/Kafka cho API quá nhỏ)
+stop:
+  - Required API contracts or models are missing
+  - Major breaking change detected on production APIs
 ```
 
----
-
-## 🛫 Ship Criteria
-```yaml
-Rules:
-  - id: minimal-diff
+## Output
+- API endpoints, controllers, and documentation
 ```

package/skills/qk-bug-resolution/SKILL.md

@@ -1,57 +1,39 @@
 ---
 name: qk-bug-resolution
-version: 5.0.0
-updated: 2026-07-03
-description: Xử lý và sửa các lỗi (bugs), đồng thời ngăn ngừa lỗi hồi quy.
 category: maintenance
-tags: [bugfix, debugging, troubleshooting]
-platforms: [claude-code, cursor, windsurf, gemini-cli]
+version: 6.0.0
 ---
 
-# 🛠️ qk-bug-resolution
+# qk-bug-resolution
 
-> **Inheritance:** Kỹ năng này tuân thủ Kiến trúc v5.0 của `framework/KERNEL.md`.
-> Output bắt buộc là Decision Summary.
+## Scope
+- Existing defects only (Diagnose)
 
----
-
-## 🎯 Mission (Scope)
-- ✅ Tìm ra nguyên nhân gốc rễ (root cause) và sửa lỗi.
-- ❌ Do NOT viết lại (rewrite) toàn bộ file thay vì sửa đúng dòng gây lỗi (The Rewrite Trap).
-
----
-
-## ⚙️ Capabilities (Cognitive Pipeline)
+## Constraints
 ```yaml
-Pipeline:
-  - inference
-  - planning
-  - execution
-  - bias-review
-  - ship-check
+must:
+  - Collect evidence (stack trace/logs) before diagnosis
+  - Verify fix before completion
+must_not:
+  - Rewrite modules
+  - Guess root cause without evidence
 ```
 
----
-
-## 🎛️ Dials (Hành vi)
+## Policies
 ```yaml
-Dials:
-  - id: strictness
+prefer:
+  - Minimal patch
+  - Regression prevention
 ```
 
----
-
-## 🛡️ Biases (Sửa lỗi mặc định)
+## Escalation
 ```yaml
-Biases:
-  - id: swallow-errors
-  - id: cosmetic-refactor # (Tuyệt đối cấm refactor khi đang fix bug)
+stop:
+  - Missing logs/evidence
+  - Fix requires major architectural changes
 ```
 
----
-
-## 🛫 Ship Criteria
-```yaml
-Rules:
-  - id: minimal-diff # (Chỉ sửa dòng cần sửa)
+## Output
+- Minimal patch
+- Risk summary
 ```

package/skills/qk-context-loader/SKILL.md

@@ -1,56 +1,36 @@
 ---
 name: qk-context-loader
-version: 5.0.0
-updated: 2026-07-03
-description: Tải các file liên quan và vẽ biểu đồ phụ thuộc (dependency graph) cho một tác vụ.
 category: utilities
-tags: [context, filesystem, dependencies, graph]
-platforms: [claude-code, cursor, windsurf, gemini-cli]
+version: 6.0.0
 ---
 
-# 🛠️ qk-context-loader
+# qk-context-loader
 
-> **Inheritance:** Kỹ năng này tuân thủ Kiến trúc v5.0 của `framework/KERNEL.md`.
-> Output bắt buộc là Decision Summary.
+## Scope
+- Context collection and dependency mapping (Collect)
 
----
-
-## 🎯 Mission (Scope)
-- ✅ Tìm và nạp các file phụ thuộc (Dependencies, Imports).
-- ❌ Do NOT nạp toàn bộ repo hoặc thư mục `node_modules` gây phình Context Window.
-
----
-
-## ⚙️ Capabilities (Cognitive Pipeline)
+## Constraints
 ```yaml
-Pipeline:
-  - inference
-  - planning
-  - execution
-  - bias-review
-  - ship-check
+must:
+  - Find and load related dependency files
+must_not:
+  - Modify code
+  - Load entire repo or node_modules
+  - Hallucinate filenames
 ```
 
----
-
-## 🎛️ Dials (Hành vi)
+## Policies
 ```yaml
-Dials:
-  - id: complexity-budget
+prefer:
+  - Build dependency graph
 ```
 
----
-
-## 🛡️ Biases (Sửa lỗi mặc định)
+## Escalation
 ```yaml
-Biases:
-  - id: hallucinated-tools # (Đoán mò tên file thay vì tìm kiếm thật)
+stop:
+  - Repo or files are inaccessible
 ```
 
----
-
-## 🛫 Ship Criteria
-```yaml
-Rules:
-  - id: delegation-only # (Chỉ thu thập thông tin, cấm chỉnh sửa code)
+## Output
+- Context mapping
 ```