ai-developer-skill-os 7.5.1 → 8.1.5

package/.agents/skills/_template/SKILL.md

@@ -0,0 +1,132 @@
+---
+# ── Identity ───────────────────────────────────────────────
+name: qk-[skill-name]
+version: 8.0.0
+status: stable
+description: "[Một câu — skill này làm gì và dành cho ai]"
+platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
+
+# ── V8: Classification ─────────────────────────────────────
+type: capability                    # capability | utility | orchestrator
+
+intent:
+  - [primary-intent]               # e.g. bug-fixing, feature-building, code-review
+  - [secondary-intent]
+
+complexity:
+  level: medium                    # low | medium | high | critical
+  criteria:
+    files_affected: "2-5"
+    has_behavior_change: true
+    has_external_dependency: false
+    has_breaking_change: false
+
+triggers:                          # Keywords that route AI to this skill
+  - "[trigger phrase 1]"
+  - "[trigger phrase 2]"
+  - "[trigger phrase 3]"
+
+selection:
+  priority: medium                 # high | medium | low
+  confidence_threshold: 0.75       # 0.0 to 1.0
+  # fallback_skill: [skill-name]   # Optional fallback
+
+# ── V8: References ─────────────────────────────────────────
+workflow: [workflow-name]          # → workflows/[workflow-name].yml
+
+rules:
+  - global                         # Always include global
+  # - coding                       # Include if skill edits code
+  # - safety                       # Include if risk: medium or high
+
+tools:
+  - filesystem
+  # - git
+  # - browser
+  # - terminal
+
+related_skills:                    # Skills often used together
+  # - qk-context-loader
+  # - qk-validation-gate
+
+knowledge_scope:
+  owns:
+    - [topic this skill is authoritative for]
+  references:
+    - [topic this skill uses but doesn't own]
+
+# ── V8: Verification ───────────────────────────────────────
+verification:
+  required: true
+  strategy: [bug-fix|refactor|feature|documentation|review]
+  # Strategies defined in workflows/_schema.yml > verification_profiles
+
+# ── V8: Knowledge links ────────────────────────────────────
+examples: []                       # e.g. examples/good/[example].md
+learnings: []                      # e.g. learnings/validated/[learning].md
+
+# ── V7 Runtime (keep as-is) ────────────────────────────────
+execution_mode: deterministic
+cost: medium                       # low | medium | high
+latency: medium                    # fast | medium | slow
+risk: medium                       # low | medium | high
+side_effects: edit_files           # edit_files | run_commands | read_only | none
+produces: [code, report]           # code | report | schema | plan | tokens
+consumes: [user-description]       # context-graph | design-md | stack-trace | none
+
+token_budget:
+  max_files_read: 3
+  max_lines_per_read: 150
+  max_shell_commands: 2
+  stop_early: true
+
+exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
+---
+
+# qk-[skill-name] — [Short Title]
+
+> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
+
+---
+
+## Preconditions
+
+- [ ] [Required condition 1]
+- [ ] [Required condition 2]
+
+```
+On missing precondition → EXIT: BLOCKED
+Report: "Missing: [what is needed]"
+```
+
+---
+
+## Scope
+
+**This skill does:**
+- ✅ [What it does — be specific]
+- ✅ [Another thing it does]
+
+**This skill does NOT:**
+- ❌ [Explicit exclusion 1]
+- ❌ [Explicit exclusion 2 — avoid scope creep]
+
+---
+
+## Output Format
+
+```markdown
+## [Skill Name] Result
+
+**Status:** SUCCESS | BLOCKED | FAILED | PARTIAL
+**Exit:** [exit_code]
+
+### Summary
+[1-2 sentences]
+
+### Details
+[Main output content]
+
+### Verification
+[What was verified and how]
+```

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

@@ -1,9 +1,66 @@
 ---
+# ── Identity ───────────────────────────────────────────────
 name: qk-access-policy
-category: security
-version: 7.5.0
+version: 8.0.0
+status: stable
 description: "Quản lý RBAC, ABAC — định nghĩa role matrix trước, implement middleware sau."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
+
+# ── V8: Classification ─────────────────────────────────────
+type: capability
+
+intent:
+  - access-control
+  - security-policy
+
+complexity:
+  level: high
+  criteria:
+    files_affected: "1-5"
+    has_behavior_change: true
+    has_external_dependency: true
+    has_breaking_change: false
+
+triggers:
+  - "cấu hình rbac"
+  - "phân quyền"
+  - "bảo mật api"
+  - "auth middleware"
+
+# ── V8: References ─────────────────────────────────────────
+workflow: feature-delivery
+
+rules:
+  - global
+  - coding
+
+tools:
+  - filesystem
+  - terminal
+
+related_skills:
+  - qk-api-lifecycle
+
+knowledge_scope:
+  owns:
+    - security-policy
+    - role-matrix
+  references:
+    - architecture
+
+# ── V8: Verification ───────────────────────────────────────
+verification:
+  required: true
+  strategy: feature
+
+selection:
+  priority: high
+  confidence_threshold: 0.85
+
+examples: []
+learnings: []
+
+# ── V7 Runtime ─────────────────────────────────────────────
 execution_mode: deterministic
 cost: medium
 latency: medium
@@ -11,15 +68,14 @@ risk: high
 side_effects: edit_files
 produces: [code, report]
 consumes: [user-description]
+
 token_budget:
   max_files_read: 3
   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-access-policy — Access Control Designer

package/.agents/skills/qk-agent-observability/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: qk-agent-observability
+version: 8.1.3
+status: experimental
+description: "Lớp theo dõi (Observability) cho phép giám sát quyết định, luân chuyển và các mô hình lỗi."
+platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
+
+type: capability
+
+intent:
+  - observability
+  - agent-metrics
+  - decision-trace
+
+triggers:
+  - "agent observability"
+  - "routing logs"
+  - "skill failure"
+
+workflow: skill-evolution
+
+knowledge_scope:
+  domain:
+    - agent-telemetry
+    - decision-tracking
+    - routing-accuracy
+  concepts:
+    - observability-patterns
+    - evaluation-metrics
+  references:
+    - architecture
+
+decision_boundary:
+  owns:
+    - agent_decision_trace
+    - routing_accuracy_metrics
+    - skill_success_rate
+    - failure_pattern_detection
+    - feedback_loop
+  does_not_own:
+    - application_monitoring
+    - infrastructure_monitoring
+    - log_aggregation
+    - uptime_monitoring
+  conflicts_with: []
+
+verification:
+  required: true
+  strategy: feature
+
+lifecycle:
+  promotion_gate:
+    tests:
+      minimum_pass_rate: 0.9
+    usage:
+      minimum_runs: 20
+    conflicts:
+      zero_boundary_violation: true
+  demotion_gate:
+    triggers:
+      - repeated_failure
+      - boundary_violation
+      - outdated_reference
+    action:
+      change_status: "stable -> experimental"
+
+selection:
+  priority: medium
+  confidence_threshold: 0.85
+---
+
+# Agent Observability Capability
+This skill enables tracking and observing the AI agent's own behavior, decisions, and accuracy metrics without interfering with application or infrastructure observability systems.

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

@@ -1,9 +1,67 @@
 ---
+# ── Identity ───────────────────────────────────────────────
 name: qk-ai-builder
-category: core
-version: 7.5.0
+version: 8.0.0
+status: stable
 description: "Thiết kế AI logic, Prompts, RAG pipelines với bảo mật chống Injection — structured output bắt buộc."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
+
+# ── V8: Classification ─────────────────────────────────────
+type: capability
+
+intent:
+  - ai-integration
+  - agent-behavior
+
+complexity:
+  level: high
+  criteria:
+    files_affected: "1-5"
+    has_behavior_change: true
+    has_external_dependency: true
+    has_breaking_change: false
+
+triggers:
+  - "build ai"
+  - "viết prompt"
+  - "thiết kế bot"
+  - "ai logic"
+  - "tạo skill"
+
+# ── V8: References ─────────────────────────────────────────
+workflow: feature-delivery
+
+rules:
+  - global
+  - coding
+
+tools:
+  - filesystem
+  - terminal
+
+related_skills:
+  - qk-system-evolution
+
+knowledge_scope:
+  owns:
+    - agent-architecture
+    - skill-generation
+  references:
+    - architecture
+
+# ── V8: Verification ───────────────────────────────────────
+verification:
+  required: true
+  strategy: feature
+
+selection:
+  priority: high
+  confidence_threshold: 0.85
+
+examples: []
+learnings: []
+
+# ── V7 Runtime ─────────────────────────────────────────────
 execution_mode: deterministic
 cost: high
 latency: slow
@@ -11,14 +69,13 @@ risk: high
 side_effects: edit_files
 produces: [code, schema]
 consumes: [user-description]
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
+
 token_budget:
   max_files_read: 3
   max_lines_per_read: 100
   max_shell_commands: 0
   stop_early: true
+
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
 ---
 

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

@@ -1,11 +1,67 @@
 ---
+# ── Identity ───────────────────────────────────────────────
 name: qk-api-lifecycle
-category: fullstack
-version: 7.5.0
+version: 8.0.0
+status: stable
 description: "Thiết kế, triển khai API endpoints với Zero-Trust — contract trước, code sau."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
-execution_mode: deterministic
 
+# ── V8: Classification ─────────────────────────────────────
+type: capability
+
+intent:
+  - api-design
+  - backend-development
+
+complexity:
+  level: medium
+  criteria:
+    files_affected: "1-5"
+    has_behavior_change: true
+    has_external_dependency: true
+    has_breaking_change: false
+
+triggers:
+  - "viết api"
+  - "tạo endpoint"
+  - "build api"
+  - "thiết kế api"
+
+# ── V8: References ─────────────────────────────────────────
+workflow: feature-delivery
+
+rules:
+  - global
+  - coding
+
+tools:
+  - filesystem
+  - terminal
+
+related_skills:
+  - qk-data-lifecycle
+
+knowledge_scope:
+  owns:
+    - api-contracts
+    - endpoints
+  references:
+    - architecture
+
+# ── V8: Verification ───────────────────────────────────────
+verification:
+  required: true
+  strategy: api-change
+
+selection:
+  priority: high
+  confidence_threshold: 0.85
+
+examples: []
+learnings: []
+
+# ── V7 Runtime ─────────────────────────────────────────────
+execution_mode: deterministic
 cost: medium
 latency: medium
 risk: medium
@@ -20,9 +76,6 @@ token_budget:
   stop_early: true
 
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
 ---
 
 # qk-api-lifecycle — API Design & Implementation

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

@@ -1,11 +1,72 @@
 ---
+# ── Identity ───────────────────────────────────────────────
 name: qk-bug-resolution
-category: maintenance
-version: 7.5.0
+version: 8.0.0
+status: stable
 description: "Sửa lỗi (bugs) bằng chu trình khép kín: Quan sát → Giả thuyết → Bằng chứng → Sửa."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
-execution_mode: deterministic
 
+# ── V8: Classification ─────────────────────────────────────
+type: capability
+
+intent:
+  - bug-fixing
+  - debugging
+  - error-resolution
+
+complexity:
+  level: medium
+  criteria:
+    files_affected: "2-5"
+    has_behavior_change: true
+    has_external_dependency: false
+    has_breaking_change: false
+
+triggers:
+  - "fix bug"
+  - "sửa lỗi"
+  - "crash"
+  - "error"
+  - "not working"
+
+selection:
+  priority: high
+  confidence_threshold: 0.65
+
+# ── V8: References ─────────────────────────────────────────
+workflow: bug-resolution
+
+rules:
+  - global
+  - coding
+
+tools:
+  - filesystem
+  - terminal
+
+related_skills:
+  - qk-context-loader
+  - qk-validation-gate
+
+knowledge_scope:
+  owns:
+    - bug-diagnosis
+    - fix-strategies
+    - root-cause-analysis
+  references:
+    - testing
+    - language-specific-features
+
+# ── V8: Verification ───────────────────────────────────────
+verification:
+  required: true
+  strategy: bug-fix
+
+examples: []
+learnings: []
+
+# ── V7 Runtime ─────────────────────────────────────────────
+execution_mode: deterministic
 cost: medium
 latency: medium
 risk: medium
@@ -20,9 +81,6 @@ token_budget:
   stop_early: true
 
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
 ---
 
 # qk-bug-resolution — Diagnose & Repair

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

@@ -1,11 +1,70 @@
 ---
+# ── Identity ───────────────────────────────────────────────
 name: qk-context-loader
-category: utilities
-version: 7.5.0
+version: 8.0.0
+status: stable
 description: "Tải context và vẽ dependency graph chính xác trước khi code — ngăn hallucination kiến trúc."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
-execution_mode: deterministic
 
+# ── V8: Classification ─────────────────────────────────────
+type: utility
+
+intent:
+  - context-loading
+  - project-understanding
+  - repository-analysis
+
+complexity:
+  level: low
+  criteria:
+    files_affected: "1-5"
+    has_behavior_change: false
+    has_external_dependency: false
+    has_breaking_change: false
+
+triggers:
+  - "load context"
+  - "understand project"
+  - "analyze architecture"
+  - "vẽ dependency graph"
+  - "build context"
+
+selection:
+  priority: high
+  confidence_threshold: 0.75
+
+# ── V8: References ─────────────────────────────────────────
+workflow: research
+
+rules:
+  - global
+
+tools:
+  - filesystem
+  - terminal
+
+related_skills:
+  - qk-feature-delivery
+  - qk-orchestrator
+
+knowledge_scope:
+  owns:
+    - project-context
+    - architecture-discovery
+  references:
+    - coding
+    - repository-structure
+
+# ── V8: Verification ───────────────────────────────────────
+verification:
+  required: true
+  strategy: review
+
+examples: []
+learnings: []
+
+# ── V7 Runtime ─────────────────────────────────────────────
+execution_mode: deterministic
 cost: low
 latency: fast
 risk: low
@@ -20,19 +79,12 @@ token_budget:
   stop_early: true
 
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
 ---
 
 # qk-context-loader — Dependency Graph Builder
 
-> **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
 - [ ] Entry point file or module name is specified