ai-developer-skill-os 9.3.1 → 10.2.0

package/.agents/workflows/production-release.yml

@@ -1,173 +1,207 @@
-name: production-release
-version: 8.0.0
-description: "Chuẩn bị release production với 8-gate checklist bắt buộc — không pass gate = không deploy."
-
-owner:
-  type: engineering
-  maintained_by: qk-team
-
-verification_profile: release-safety
-
-triggers:
-  - "release production"
-  - "deploy production"
-  - "chuẩn bị release"
-  - "kiểm tra release"
-
-ide_binding:
-  slash_command: "/release"
-  aliases: ["/deploy", "/prod-release"]
-
-steps:
-  - id: gate_1_validation
-    name: "Gate 1: Validation Gate"
-    purpose: "Đảm bảo qk-validation-gate đã pass trước khi release"
-    required: true
-    skip_if: null
-    inputs: []
-    outputs:
-      - validation_result
-    actions:
-      - "Chạy npm run test:registry"
-      - "Chạy npm run lint"
-      - "Chạy npm run test:agent"
-      - "Chạy npm run test:graph"
-    exit_on_fail: FAILED
-    human_checkpoint:
-      condition: "any validation gate fails"
-      message: "Validation gate thất bại. Fix trước khi tiếp tục."
-
-  - id: gate_2_capability
-    name: "Gate 2: Capability Integrity"
-    purpose: "Kiểm tra tất cả capability.yaml hợp lệ và không trùng lặp"
-    required: true
-    skip_if: null
-    inputs: []
-    outputs:
-      - capability_check
-    actions:
-      - "Validate tất cả capability.yaml files có schema_version: 1"
-      - "Kiểm tra không có capability.yaml trùng id"
-      - "Verify mỗi skill có SKILL.md tương ứng"
-      - "Verify mỗi SKILL.md có capability.yaml tương ứng"
-    exit_on_fail: FAILED
-    human_checkpoint:
-      condition: "capability.yaml missing or invalid"
-      message: "Một số capability.yaml bị thiếu hoặc không hợp lệ."
-
-  - id: gate_3_registry
-    name: "Gate 3: Registry Consistency"
-    purpose: "Kiểm tra registry files nhất quán với filesystem"
-    required: true
-    skip_if: null
-    inputs: []
-    outputs:
-      - registry_check
-    actions:
-      - "Chạy node tooling/build-registry.js"
-      - "So sánh index.yaml với filesystem实际"
-      - "Kiểm tra graph.json không có cycles"
-      - "Kiểm tra không có orphan nodes"
-    exit_on_fail: FAILED
-    human_checkpoint:
-      condition: "registry inconsistency detected"
-      message: "Registry không nhất quán với filesystem."
-
-  - id: gate_4_workflows
-    name: "Gate 4: Workflow Validation"
-    purpose: "Kiểm tra tất cả workflow files hợp lệ"
-    required: true
-    skip_if: null
-    inputs: []
-    outputs:
-      - workflow_check
-    actions:
-      - "Validate tất cả workflow YAML files có schema hợp lệ"
-      - "Kiểm tra mỗi workflow có steps, triggers, exit_codes"
-      - "Verify mỗi skill reference workflow tồn tại"
-      - "Kiểm tra không có workflow reference đến internal"
-    exit_on_fail: FAILED
-    human_checkpoint:
-      condition: "workflow validation fails"
-      message: "Một hoặc nhiều workflow không hợp lệ."
-
-  - id: gate_5_security
-    name: "Gate 5: Security Scan"
-    purpose: "Quét bảo mật trước khi release"
-    required: true
-    skip_if: null
-    inputs: []
-    outputs:
-      - security_report
-    actions:
-      - "Chạy npm audit --production"
-      - "grep_search cho secrets, tokens, API keys trong code"
-      - "Kiểm tra không có hardcoded credentials"
-      - "Verify .env files không bị commit"
-    exit_on_fail: FAILED
-    human_checkpoint:
-      condition: "critical or high security issues found"
-      message: "Có vấn đề bảo mật nghiêm trọng. Cần fix trước khi release."
-
-  - id: gate_6_size
-    name: "Gate 6: Bundle & Size Check"
-    purpose: "Kiểm tra kích thước bundle và dependencies"
-    required: true
-    skip_if: null
-    inputs: []
-    outputs:
-      - size_report
-    actions:
-      - "Chạy npm run build (production mode)"
-      - "Kiểm tra bundle size trong giới hạn"
-      - "Kiểm tra không có devDependencies trong production"
-      - "Verify tree-shaking hoạt động đúng"
-    exit_on_fail: FAILED
-    human_checkpoint:
-      condition: "bundle size exceeds limit"
-      message: "Bundle size vượt hạn chế. Cần tối ưu trước khi deploy."
-
-  - id: gate_7_changelog
-    name: "Gate 7: Changelog & Documentation"
-    purpose: "Kiểm tra CHANGELOG.md và documentation đã cập nhật"
-    required: true
-    skip_if: null
-    inputs: []
-    outputs:
-      - docs_check
-    actions:
-      - "Kiểm tra CHANGELOG.md có entry cho version này"
-      - "Verify README.md phản ánh đúng capabilities hiện tại"
-      - "Kiểm tra SKILL.md descriptions không bị encoding issues"
-      - "Verify capability.yaml descriptions chính xác"
-    exit_on_fail: PARTIAL
-    human_checkpoint:
-      condition: "changelog missing or docs outdated"
-      message: "CHANGELOG hoặc documentation chưa cập nhật. Cần fix trước khi release."
-
-  - id: gate_8_report
-    name: "Gate 8: Release Report"
-    purpose: "Tạo báo cáo release có signed kết quả tất cả gates"
-    required: true
-    skip_if: null
-    inputs:
-      - validation_result
-      - capability_check
-      - registry_check
-      - workflow_check
-      - security_report
-      - size_report
-      - docs_check
-    outputs:
-      - release_report
-    actions:
-      - "Tổng hợp tất cả gate results"
-      - "Generate structured release report"
-      - "Include evidence format cho mỗi gate"
-      - "Record exit code và timestamp"
-      - "Sign report với qk-team key"
-    exit_on_fail: FAILED
-
-escalation:
-  max_retries: 1
-  on_failure: "Report which gates failed and exact fix required. Do NOT deploy."
+name: production-release
+version: 10.2.0
+platforms: [antigravity, claude, opencode]
+runtime_version: 1
+description: "Chuẩn bị release production với 8-gate checklist bắt buộc — không pass gate = không deploy."
+
+owner:
+  type: engineering
+  maintained_by: qk-team
+
+verification_profile: release-safety
+
+triggers:
+  - "release production"
+  - "deploy production"
+  - "chuẩn bị release"
+  - "kiểm tra release"
+
+ide_binding:
+  slash_command: "/release"
+  aliases: ["/deploy", "/prod-release"]
+
+steps:
+  - id: gate_1_validation
+    name: "Gate 1: Validation Gate"
+    purpose: "Đảm bảo qk-code-review đã pass trước khi release"
+    required: true
+    skip_if: null
+    inputs: []
+    outputs:
+      - validation_result
+    actions:
+      - "Chạy npm run test:registry"
+      - "Chạy npm run lint"
+      - "Chạy npm run test:agent"
+      - "Chạy npm run test:graph"
+    exit_on_fail: FAILED
+    human_checkpoint:
+      condition: "any validation gate fails"
+      message: "Validation gate thất bại. Fix trước khi tiếp tục."
+
+  - id: gate_2_capability
+    name: "Gate 2: Capability Integrity"
+    purpose: "Kiểm tra tất cả capability.yaml hợp lệ và không trùng lặp"
+    required: true
+    skip_if: null
+    inputs: []
+    outputs:
+      - capability_check
+    actions:
+      - "Validate tất cả capability.yaml files có schema_version: 1"
+      - "Kiểm tra không có capability.yaml trùng id"
+      - "Verify mỗi skill có SKILL.md tương ứng"
+      - "Verify mỗi SKILL.md có capability.yaml tương ứng"
+    exit_on_fail: FAILED
+    human_checkpoint:
+      condition: "capability.yaml missing or invalid"
+      message: "Một số capability.yaml bị thiếu hoặc không hợp lệ."
+
+  - id: gate_3_registry
+    name: "Gate 3: Registry Consistency"
+    purpose: "Kiểm tra registry files nhất quán với filesystem"
+    required: true
+    skip_if: null
+    inputs: []
+    outputs:
+      - registry_check
+    actions:
+      - "Chạy node tooling/build-registry.js"
+      - "So sánh index.yaml với filesystem实际"
+      - "Kiểm tra graph.json không có cycles"
+      - "Kiểm tra không có orphan nodes"
+    exit_on_fail: FAILED
+    human_checkpoint:
+      condition: "registry inconsistency detected"
+      message: "Registry không nhất quán với filesystem."
+
+  - id: gate_4_workflows
+    name: "Gate 4: Workflow Validation"
+    purpose: "Kiểm tra tất cả workflow files hợp lệ"
+    required: true
+    skip_if: null
+    inputs: []
+    outputs:
+      - workflow_check
+    actions:
+      - "Validate tất cả workflow YAML files có schema hợp lệ"
+      - "Kiểm tra mỗi workflow có steps, triggers, exit_codes"
+      - "Verify mỗi skill reference workflow tồn tại"
+      - "Kiểm tra không có workflow reference đến internal"
+    exit_on_fail: FAILED
+    human_checkpoint:
+      condition: "workflow validation fails"
+      message: "Một hoặc nhiều workflow không hợp lệ."
+
+  - id: gate_5_security
+    name: "Gate 5: Security Scan"
+    purpose: "Quét bảo mật trước khi release"
+    required: true
+    skip_if: null
+    inputs: []
+    outputs:
+      - security_report
+    actions:
+      - "Chạy npm audit --production"
+      - "grep_search cho secrets, tokens, API keys trong code"
+      - "Kiểm tra không có hardcoded credentials"
+      - "Verify .env files không bị commit"
+    exit_on_fail: FAILED
+    human_checkpoint:
+      condition: "critical or high security issues found"
+      message: "Có vấn đề bảo mật nghiêm trọng. Cần fix trước khi release."
+
+  - id: gate_6_size
+    name: "Gate 6: Bundle & Size Check"
+    purpose: "Kiểm tra kích thước bundle và dependencies"
+    required: true
+    skip_if: null
+    inputs: []
+    outputs:
+      - size_report
+    actions:
+      - "Chạy npm run build (production mode)"
+      - "Kiểm tra bundle size trong giới hạn"
+      - "Kiểm tra không có devDependencies trong production"
+      - "Verify tree-shaking hoạt động đúng"
+    exit_on_fail: FAILED
+    human_checkpoint:
+      condition: "bundle size exceeds limit"
+      message: "Bundle size vượt hạn chế. Cần tối ưu trước khi deploy."
+
+  - id: gate_7_changelog
+    name: "Gate 7: Changelog & Documentation"
+    purpose: "Kiểm tra CHANGELOG.md và documentation đã cập nhật"
+    required: true
+    skip_if: null
+    inputs: []
+    outputs:
+      - docs_check
+    actions:
+      - "Kiểm tra CHANGELOG.md có entry cho version này"
+      - "Verify README.md phản ánh đúng capabilities hiện tại"
+      - "Kiểm tra SKILL.md descriptions không bị encoding issues"
+      - "Verify capability.yaml descriptions chính xác"
+    exit_on_fail: PARTIAL
+    human_checkpoint:
+      condition: "changelog missing or docs outdated"
+      message: "CHANGELOG hoặc documentation chưa cập nhật. Cần fix trước khi release."
+
+  - id: gate_8_report
+    name: "Gate 8: Release Report"
+    purpose: "Tạo báo cáo release có signed kết quả tất cả gates"
+    required: true
+    skip_if: null
+    inputs:
+      - validation_result
+      - capability_check
+      - registry_check
+      - workflow_check
+      - security_report
+      - size_report
+      - docs_check
+    outputs:
+      - release_report
+    actions:
+      - "Tổng hợp tất cả gate results"
+      - "Generate structured release report"
+      - "Include evidence format cho mỗi gate"
+      - "Record exit code và timestamp"
+      - "Sign report với qk-team key"
+    exit_on_fail: FAILED
+
+escalation:
+  max_retries: 1
+  on_failure: "Report which gates failed and exact fix required. Do NOT deploy."
+
+# ── V10.2 Additions ──────────────────────────────
+# Confidence Model
+# | Level  | Condition              | Action       |
+# |--------|------------------------|--------------|
+# | HIGH   | Step inputs provided   | Proceed      |
+# | MEDIUM | Some assumptions needed | Note assumptions |
+# | LOW    | Insufficient evidence  | EXIT: BLOCKED|
+#
+# Exit Codes
+# | Code    | Meaning                       | When                    |
+# |---------|-------------------------------|-------------------------|
+# | SUCCESS | Step completed and verified   | All criteria met        |
+# | PARTIAL | Step done with minor gaps    | Some checks skipped     |
+# | BLOCKED | Missing precondition         | Ask user                |
+# | FAILED  | Step failed after max retries | Report error            |
+#
+# Evidence Format:
+#   [SEVERITY] step_id: [step-name]
+#   Reason:     [why this matters]
+#   Confidence: [HIGH|MEDIUM|LOW]
+#   Fix:        [suggestion]
+#
+# Compliance:
+#   Runtime Standard: 11/11
+#   Frontmatter Complete: yes
+#   References Valid: yes
+#   Decision Trees: PASS
+#   Thresholds Defined: PASS
+#   schema_version: 10.2.0
+#   runtime_version: 1
+#   platforms: [antigravity, claude, opencode]

package/.agents/workflows/prompt-compilation.yml

@@ -0,0 +1,126 @@
+name: prompt-compilation
+version: 10.2.0
+platforms: [antigravity, claude, opencode]
+runtime_version: 1
+description: "Pipeline biên dịch prompt tự nhiên thành Compiled Execution Prompt với 4 cổng kiểm soát."
+
+owner:
+  type: engineering
+  maintained_by: qk-team
+
+verification_profile: spec-driven
+
+triggers:
+  - "viết prompt"
+  - "compile prompt"
+  - "chuẩn hóa prompt"
+  - "prompt compiler"
+
+ide_binding:
+  slash_command: "/compile-prompt"
+  aliases: ["/prompt", "/cp"]
+
+steps:
+  - id: understand
+    name: "Hiểu yêu cầu"
+    purpose: "Nhận diện mục tiêu cốt lõi từ câu lệnh tự nhiên"
+    required: true
+    outputs:
+      - actual_goal
+      - implied_requirements
+    actions:
+      - "Phân tích câu lệnh user để xác định Actual Goal"
+      - "Xác định scope ban đầu"
+    min_confidence: HIGH
+
+  - id: compile
+    name: "Biên dịch Compiled Prompt"
+    purpose: "Tạo Execution Prompt minh bạch với 9 thành phần"
+    required: true
+    outputs:
+      - compiled_prompt
+      - prompt_delta
+      - change_budget
+    actions:
+      - "Sinh Role, Objective, Context, Source of Truth"
+      - "Xác định IN-SCOPE và OUT-OF-SCOPE"
+      - "Tính Complexity (L0-L4) và Risk (R0-R4)"
+    human_checkpoint:
+      condition: "Complexity >= L3 hoặc Risk >= R2"
+      message: "Compiled Prompt có complexity/risk cao. Xác nhận trước khi thực thi."
+
+  - id: gate_check
+    name: "Gateway Check"
+    purpose: "Xác nhận qua 4 cổng kiểm soát"
+    required: true
+    outputs:
+      - quality_gate_result
+      - risk_gate_result
+      - budget_gate_result
+      - scope_gate_result
+    actions:
+      - "Prompt Quality Gate: 8 tiêu chí hợp đồng"
+      - "Risk Gate: Complexity + Risk assessment"
+      - "Change Budget: Files ≤ 5, Dependencies = 0"
+      - "Scope Expansion Gate: Không có bành trướng"
+    exit_on_fail: BLOCKED
+
+  - id: execute
+    name: "Thực thi"
+    purpose: "Chạy theo Compiled Prompt đã approved"
+    required: true
+    outputs:
+      - execution_results
+      - changed_files
+    actions:
+      - "Thực thi theo compiled prompt"
+      - "Monitor scope expansion trong quá trình thực thi"
+    exit_on_fail: PARTIAL
+
+  - id: evidence_report
+    name: "Evidence Gate & Report"
+    purpose: "Xác minh bằng chứng và báo cáo kết quả"
+    required: true
+    outputs:
+      - claim_level
+      - execution_report
+    actions:
+      - "CLAIM LEVEL <= EVIDENCE LEVEL check"
+      - "Generate Execution Report"
+    exit_on_fail: FAILED
+
+escalation:
+  max_retries: 2
+  on_failure: "Recompile prompt with expanded scope and ask user CONFIRM"
+
+# ── V10.2 Additions ──────────────────────────────
+# Confidence Model
+# | Level  | Condition              | Action       |
+# |--------|------------------------|--------------|
+# | HIGH   | Step inputs provided   | Proceed      |
+# | MEDIUM | Some assumptions needed | Note assumptions |
+# | LOW    | Insufficient evidence  | EXIT: BLOCKED|
+#
+# Exit Codes
+# | Code    | Meaning                       | When                    |
+# |---------|-------------------------------|-------------------------|
+# | SUCCESS | Step completed and verified   | All criteria met        |
+# | PARTIAL | Step done with minor gaps    | Some checks skipped     |
+# | BLOCKED | Missing precondition         | Ask user                |
+# | FAILED  | Step failed after max retries | Report error            |
+#
+# Evidence Format:
+#   [SEVERITY] step_id: [step-name]
+#   Reason:     [why this matters]
+#   Confidence: [HIGH|MEDIUM|LOW]
+#   Fix:        [suggestion]
+#
+# Compliance:
+#   Runtime Standard: 11/11
+#   Frontmatter Complete: yes
+#   References Valid: yes
+#   Decision Trees: PASS
+#   Thresholds Defined: PASS
+#   schema_version: 10.2.0
+#   runtime_version: 1
+#   platforms: [antigravity, claude, opencode]