ai-developer-skill-os 7.5.1 → 8.1.4

package/.agents/skills/qk-orchestrator/SKILL.md

@@ -1,11 +1,71 @@
 ---
+# ── Identity ───────────────────────────────────────────────
 name: qk-orchestrator
-category: core
-version: 7.5.0
+version: 8.0.0
+status: stable
 description: "Điều hướng yêu cầu của người dùng đến đúng skill với kỷ luật thép — kiểm tra preconditions và routing table."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
-execution_mode: deterministic
 
+# ── V8: Classification ─────────────────────────────────────
+type: orchestrator
+
+intent:
+  - task-routing
+  - skill-selection
+  - precondition-checking
+
+complexity:
+  level: low
+  criteria:
+    files_affected: "1"
+    has_behavior_change: false
+    has_external_dependency: false
+    has_breaking_change: false
+
+triggers:
+  - "which skill"
+  - "what should i use"
+  - "route this"
+  - "help me choose"
+  - "what skill for"
+  - "help"
+  - "list skills"
+  - "what can you do"
+
+selection:
+  priority: high
+  confidence_threshold: 0.80
+
+# ── V8: References ─────────────────────────────────────────
+workflow: research                  # Uses research workflow to understand request
+
+rules:
+  - global
+
+tools:
+  - filesystem
+
+related_skills:
+  - qk-context-loader
+
+knowledge_scope:
+  owns:
+    - task-routing
+    - skill-selection
+    - precondition-validation
+  references:
+    - all-skills                    # References registry to make decisions
+
+# ── V8: Verification ───────────────────────────────────────
+verification:
+  required: true
+  strategy: review
+
+examples: []
+learnings: []
+
+# ── V7 Runtime ─────────────────────────────────────────────
+execution_mode: deterministic
 cost: low
 latency: fast
 risk: low
@@ -20,19 +80,12 @@ token_budget:
   stop_early: true
 
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
 ---
 
 # qk-orchestrator — Request Routing
 
-> **Language rule:** Code, identifiers, file names ? English. Explanations, summaries ? Vietnamese.
+> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
 
 ## Preconditions
 - [ ] User request is provided (any language)

package/.agents/skills/qk-orchestrator/references/routing-table.md

@@ -24,9 +24,9 @@
 | design system, token, CSS variable, design tokens | `qk-ui-system-builder` | DESIGN.md check |
 | project audit, health, tech debt, kiểm toán dự án | `qk-project-health` | direct |
 | new project, bootstrap, init, khởi tạo dự án | `qk-project-bootstrap` | direct |
+| help, list skills, danh sách, trợ giúp | `qk-orchestrator` | direct |
 | memory, context, recall, lưu ngữ cảnh | `qk-project-memory` | direct |
 | security, policy, authorization, bảo mật | `qk-policy-engine` | → redirect to `qk-access-policy` |
-| help, danh sách, list skills, hướng dẫn | `qk-help` | direct |
 | consume API, tích hợp API backend, gọi API từ FE | `qk-fe-api-integration` | `qk-context-loader` first |
 | UI audit, kiểm tra giao diện, anti-slop check | `qk-ui-audit` | DESIGN.md check |
 

package/.agents/skills/qk-product-specification/SKILL.md

@@ -0,0 +1,130 @@
+---
+# ── Identity ───────────────────────────────────────────────
+name: qk-product-specification
+version: 8.1.0
+status: experimental
+description: "Product thinking (Idea → Requirement → Acceptance criteria → Technical spec)."
+platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
+
+# ── V8: Classification ─────────────────────────────────────
+type: capability
+
+intent:
+  - product-specification
+  - requirement-analysis
+  - acceptance-criteria
+  - technical-spec
+
+complexity:
+  level: medium
+  criteria:
+    files_affected: "1-3"
+    has_behavior_change: false
+    has_external_dependency: false
+    has_breaking_change: false
+
+triggers:
+  - "viết spec"
+  - "phân tích yêu cầu"
+  - "ý tưởng sản phẩm"
+  - "acceptance criteria"
+
+# ── V8: References ─────────────────────────────────────────
+workflow: spec-driven-development
+
+rules:
+  - global
+  - coding
+
+tools:
+  - filesystem
+
+related_skills:
+  - qk-feature-delivery
+
+knowledge_scope:
+  domain:
+    - product-requirements
+    - technical-specifications
+  concepts:
+    - user-story
+    - acceptance-criteria
+  references:
+    - architecture
+
+decision_boundary:
+  owns:
+    - technical-ready specification
+    - acceptance criteria
+  does_not_own:
+    - market research
+    - pricing
+    - roadmap
+  conflicts_with: []
+  delegates_to:
+    - qk-feature-delivery
+
+# ── V8: Verification ───────────────────────────────────────
+verification:
+  required: true
+  strategy: feature
+
+lifecycle:
+  promotion_gate:
+    requirements:
+      tests:
+        minimum_pass_rate: 0.95
+      usage:
+        minimum_runs: 20
+      conflicts:
+        zero_boundary_violation: true
+      evidence:
+        required:
+          - evaluation_report
+          - usage_history
+          - boundary_audit
+  demotion_gate:
+    triggers:
+      - repeated_failure
+      - boundary_violation
+      - outdated_reference
+    action:
+      change_status: "stable -> experimental"
+
+selection:
+  priority: medium
+  confidence_threshold: 0.80
+
+examples: []
+learnings: []
+
+# ── V7 Runtime ─────────────────────────────────────────────
+execution_mode: deterministic
+cost: medium
+latency: medium
+risk: low
+side_effects: read_only
+produces: [report, specification]
+consumes: [user-description]
+
+token_budget:
+  max_files_read: 3
+  max_lines_per_read: 150
+  max_shell_commands: 0
+  stop_early: false
+
+exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
+---
+
+# qk-product-specification — Product Specifier
+
+> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
+
+## Preconditions
+- [ ] Tuân thủ workflow `spec-driven-development`.
+
+## Scope
+- Tiếp nhận Idea ban đầu từ user, thực hiện phân tích yêu cầu (Requirement Analysis).
+- Xác định và làm rõ ranh giới của tính năng.
+- Lên danh sách Acceptance Criteria (Tiêu chí nghiệm thu).
+- Đóng gói thành Technical Spec (đặc tả kỹ thuật) để chuẩn bị cho quá trình code (Plan & Implementation).

package/.agents/skills/qk-production-release/SKILL.md

@@ -1,11 +1,67 @@
 ---
+# ── Identity ───────────────────────────────────────────────
 name: qk-production-release
-category: devops
-version: 7.5.0
+version: 8.0.0
+status: stable
 description: "Chuẩn bị release production với 8-gate checklist bắt buộc — không pass gate = không deploy."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
-execution_mode: deterministic
 
+# ── V8: Classification ─────────────────────────────────────
+type: capability
+
+intent:
+  - release-management
+  - production-deployment
+
+complexity:
+  level: high
+  criteria:
+    files_affected: "1-5"
+    has_behavior_change: false
+    has_external_dependency: true
+    has_breaking_change: false
+
+triggers:
+  - "release production"
+  - "deploy production"
+  - "chuẩn bị release"
+  - "kiểm tra release"
+
+# ── V8: References ─────────────────────────────────────────
+workflow: internal
+
+rules:
+  - global
+  - safety
+
+tools:
+  - filesystem
+  - terminal
+
+related_skills:
+  - qk-validation-gate
+
+knowledge_scope:
+  owns:
+    - release-checklist
+    - deployment-gate
+  references:
+    - architecture
+
+# ── V8: Verification ───────────────────────────────────────
+verification:
+  required: true
+  strategy: release-safety
+
+selection:
+  priority: high
+  confidence_threshold: 0.85
+
+examples: []
+learnings: []
+
+# ── V7 Runtime ─────────────────────────────────────────────
+execution_mode: deterministic
 cost: medium
 latency: slow
 risk: high
@@ -20,9 +76,6 @@ token_budget:
   stop_early: false
 
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
 ---
 
 # qk-production-release — Release Gate

package/.agents/skills/qk-project-bootstrap/SKILL.md

@@ -1,25 +1,85 @@
 ---
+# ── Identity ───────────────────────────────────────────────
 name: qk-project-bootstrap
-category: fullstack
-version: 7.5.0
+version: 8.0.0
+status: stable
 description: "Khởi tạo dự án mới với cấu trúc chuẩn, linters, DESIGN.md — không bao giờ thiếu foundation."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
+
+# ── V8: Classification ─────────────────────────────────────
+type: capability
+
+intent:
+  - project-initialization
+  - setup
+
+complexity:
+  level: high
+  criteria:
+    files_affected: "10+"
+    has_behavior_change: true
+    has_external_dependency: true
+    has_breaking_change: false
+
+triggers:
+  - "khởi tạo project"
+  - "tạo dự án mới"
+  - "bootstrap"
+  - "setup project"
+  - "init repo"
+
+# ── V8: References ─────────────────────────────────────────
+workflow: feature-delivery
+
+rules:
+  - global
+  - safety
+  - filesystem-boundary
+
+tools:
+  - filesystem
+  - terminal
+
+related_skills:
+  - qk-engineering-standard
+
+knowledge_scope:
+  owns:
+    - project-structure
+    - initial-setup
+  references:
+    - architecture
+
+# ── V8: Verification ───────────────────────────────────────
+verification:
+  required: true
+  strategy: bootstrap-validation
+
+selection:
+  priority: medium
+  confidence_threshold: 0.85
+
+examples: []
+learnings: []
+
+# ── V7 Runtime ─────────────────────────────────────────────
 execution_mode: deterministic
 cost: high
 latency: slow
 risk: low
-side_effects: edit_files
+side_effects: 
+  - create_files
+  - create_structure
 produces: [code, schema, plan]
 consumes: [user-description]
+
 token_budget:
   max_files_read: 1
   max_lines_per_read: 50
   max_shell_commands: 2
   stop_early: false
+
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
 ---
 
 # qk-project-bootstrap — Project Foundation Builder

package/.agents/skills/qk-project-health/SKILL.md

@@ -1,9 +1,67 @@
 ---
+# ── Identity ───────────────────────────────────────────────
 name: qk-project-health
-category: qa
-version: 7.5.0
+version: 8.0.0
+status: stable
 description: "Kiểm toán toàn diện Code Smells, Tech Debt, Architecture — health score 0–100 với actionable roadmap."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
+
+# ── V8: Classification ─────────────────────────────────────
+type: utility
+
+intent:
+  - project-audit
+  - codebase-health
+
+complexity:
+  level: high
+  criteria:
+    files_affected: "10+"
+    has_behavior_change: false
+    has_external_dependency: false
+    has_breaking_change: false
+
+triggers:
+  - "audit code"
+  - "check health"
+  - "tech debt"
+  - "code smell"
+  - "kiểm toán"
+
+# ── V8: References ─────────────────────────────────────────
+workflow: code-review
+
+rules:
+  - global
+  - coding
+
+tools:
+  - filesystem
+  - terminal
+
+related_skills:
+  - qk-engineering-standard
+
+knowledge_scope:
+  owns:
+    - tech-debt
+    - codebase-health
+  references:
+    - architecture
+
+# ── V8: Verification ───────────────────────────────────────
+verification:
+  required: true
+  strategy: review
+
+selection:
+  priority: medium
+  confidence_threshold: 0.75
+
+examples: []
+learnings: []
+
+# ── V7 Runtime ─────────────────────────────────────────────
 execution_mode: deterministic
 cost: high
 latency: slow
@@ -11,20 +69,19 @@ risk: low
 side_effects: read_only
 produces: [report]
 consumes: [source-code]
+
 token_budget:
   max_files_read: 5
   max_lines_per_read: 100
   max_shell_commands: 1
   stop_early: true
+
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
 ---
 
 # qk-project-health — Complete Codebase Audit
 
-> **Language rule:** Code, identifiers, file names ? English. Explanations, summaries ? Vietnamese.
+> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
 
 ---
 

package/.agents/skills/qk-project-memory/SKILL.md

@@ -1,9 +1,67 @@
 ---
+# ── Identity ───────────────────────────────────────────────
 name: qk-project-memory
-category: core
-version: 7.5.0
+version: 8.0.0
+status: stable
 description: "Lưu trữ và truy xuất ngữ cảnh dự án dài hạn — chỉ lưu fact đã xác minh, không lưu giả thuyết."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
+
+# ── V8: Classification ─────────────────────────────────────
+type: utility
+
+intent:
+  - context-management
+  - knowledge-retrieval
+
+complexity:
+  level: medium
+  criteria:
+    files_affected: "1-2"
+    has_behavior_change: false
+    has_external_dependency: false
+    has_breaking_change: false
+
+triggers:
+  - "lưu context"
+  - "nhớ lại"
+  - "project memory"
+  - "lưu vào bộ nhớ"
+  - "tìm lại fact"
+
+# ── V8: References ─────────────────────────────────────────
+workflow: documentation
+
+rules:
+  - global
+  - coding
+
+tools:
+  - filesystem
+  - terminal
+
+related_skills:
+  - qk-engineering-standard
+
+knowledge_scope:
+  owns:
+    - project-facts
+    - verified-context
+  references:
+    - architecture
+
+# ── V8: Verification ───────────────────────────────────────
+verification:
+  required: true
+  strategy: review
+
+selection:
+  priority: medium
+  confidence_threshold: 0.75
+
+examples: []
+learnings: []
+
+# ── V7 Runtime ─────────────────────────────────────────────
 execution_mode: deterministic
 cost: low
 latency: fast
@@ -11,20 +69,19 @@ risk: low
 side_effects: edit_files
 produces: [plan]
 consumes: [source-code, context-graph]
+
 token_budget:
   max_files_read: 2
   max_lines_per_read: 100
   max_shell_commands: 0
   stop_early: true
+
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
 ---
 
 # qk-project-memory — Long-Term Context Store
 
-> **Language rule:** Code, identifiers, file names ? English. Explanations, summaries ? Vietnamese.
+> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
 
 ---