ai-developer-skill-os 9.3.1 → 10.2.0

package/.agents/workflows/bug-resolution.yml

@@ -1,121 +1,155 @@
-name: bug-resolution
-version: 8.0.0
-description: "Pipeline chuẩn để diagnose và fix bugs theo chu trình: Observe → Hypothesize → Evidence → Patch → Verify."
-
-owner:
-  type: engineering
-  maintained_by: qk-team
-
-verification_profile: bug-fix
-
-triggers:
-  - "fix bug"
-  - "sửa lỗi"
-  - "error"
-  - "exception"
-  - "crash"
-  - "stack trace"
-  - "not working"
-  - "bị lỗi"
-
-ide_binding:
-  slash_command: "/fix-bug"
-  aliases: ["/bug", "/debug"]
-
-steps:
-  - id: observe
-    name: "Thu thập triệu chứng"
-    purpose: "Xác định chính xác bug xảy ra ở đâu và biểu hiện thế nào"
-    required: true
-    skip_if: "Stack trace + affected file đã được cung cấp đầy đủ"
-    inputs:
-      - error_message
-      - stack_trace
-      - user_description
-    outputs:
-      - affected_file
-      - affected_line_range
-      - error_signature
-    actions:
-      - "Đọc error message và stack trace"
-      - "Xác định file và line range bị ảnh hưởng"
-      - "Mô tả triệu chứng bằng ngôn ngữ kỹ thuật"
-    exit_on_fail: BLOCKED
-
-  - id: hypothesize
-    name: "Đặt giả thuyết nguyên nhân"
-    purpose: "Xác định top 3 nguyên nhân có thể, xếp theo xác suất"
-    required: true
-    skip_if: null
-    inputs:
-      - error_signature
-      - affected_file
-    outputs:
-      - hypothesis_list      # Ordered list: [H1 (most likely), H2, H3]
-      - selected_hypothesis  # H1 unless evidence suggests otherwise
-    min_confidence: HIGH
-    actions:
-      - "List 3 nguyên nhân có thể gây ra triệu chứng này"
-      - "Xếp hạng theo xác suất dựa trên stack trace"
-      - "Chọn H1 để kiểm chứng trước"
-
-  - id: evidence
-    name: "Tìm bằng chứng xác nhận"
-    purpose: "Xác nhận hoặc loại bỏ hypothesis bằng code thực tế"
-    required: true
-    skip_if: null
-    inputs:
-      - selected_hypothesis
-      - affected_file
-    outputs:
-      - confirmed_root_cause   # File + line + quoted code
-      - evidence_quote         # Exact code causing the bug
-    min_confidence: HIGH
-    context_budget: 150
-    actions:
-      - "Dùng grep_search để tìm pattern liên quan"
-      - "Dùng view_file[StartLine:EndLine] để đọc section cụ thể"
-      - "Quote chính xác đoạn code gây bug"
-    exit_on_fail: PARTIAL
-
-  - id: patch
-    name: "Áp dụng fix"
-    purpose: "Sửa root cause, không chỉ patch triệu chứng"
-    required: true
-    skip_if: null
-    inputs:
-      - confirmed_root_cause
-      - evidence_quote
-    outputs:
-      - patched_files    # List of files modified
-      - diff_summary     # What changed and why
-    actions:
-      - "Edit source file trực tiếp với replace_file_content hoặc multi_replace_file_content"
-      - "Không tạo wrapper script"
-      - "Không dùng ?. hoặc ! để silence lỗi"
-      - "Fix root cause, không patch bề mặt"
-    human_checkpoint:
-      condition: "file thuộc vùng auth/payment/permission/migration"
-      message: "Patch này chạm vào code nhạy cảm. Xác nhận an toàn trước khi thay đổi."
-  - id: verify
-    name: "Xác minh fix + quality gate"
-    purpose: "Xác nhận bug đã được fix, không có regression, code đạt quality threshold"
-    required: true
-    skip_if: null
-    inputs:
-      - patched_files
-    outputs:
-      - verification_result   # PASS | FAIL | PARTIAL
-      - evidence_of_fix
-      - quality_gate_result   # PASS | FAIL
-    actions:
-      - "Re-read patched code section"
-      - "Chạy test liên quan nếu có"
-      - "Áp dụng shared quality gate → xem: .agents/workflows/shared/quality-gate.yml"
-      - "  Checklist: universal_checks + bug-resolution specific checks"
-      - "Ghi log execution trace vào evals/traces/"
-    exit_on_fail: FAILED
-
-escalation:
-  max_retries: 2
-  on_failure: "Report với full evidence chain (observe→hypothesis→evidence), escalate to human với gợi ý bước tiếp theo"
+name: bug-resolution
+version: 10.2.0
+platforms: [antigravity, claude, opencode]
+runtime_version: 1
+description: "Pipeline chuẩn để diagnose và fix bugs theo chu trình: Observe → Hypothesize → Evidence → Patch → Verify."
+
+owner:
+  type: engineering
+  maintained_by: qk-team
+
+verification_profile: bug-fix
+
+triggers:
+  - "fix bug"
+  - "sửa lỗi"
+  - "error"
+  - "exception"
+  - "crash"
+  - "stack trace"
+  - "not working"
+  - "bị lỗi"
+
+ide_binding:
+  slash_command: "/fix-bug"
+  aliases: ["/bug", "/debug"]
+
+steps:
+  - id: observe
+    name: "Thu thập triệu chứng"
+    purpose: "Xác định chính xác bug xảy ra ở đâu và biểu hiện thế nào"
+    required: true
+    skip_if: "Stack trace + affected file đã được cung cấp đầy đủ"
+    inputs:
+      - error_message
+      - stack_trace
+      - user_description
+    outputs:
+      - affected_file
+      - affected_line_range
+      - error_signature
+    actions:
+      - "Đọc error message và stack trace"
+      - "Xác định file và line range bị ảnh hưởng"
+      - "Mô tả triệu chứng bằng ngôn ngữ kỹ thuật"
+    exit_on_fail: BLOCKED
+
+  - id: hypothesize
+    name: "Đặt giả thuyết nguyên nhân"
+    purpose: "Xác định top 3 nguyên nhân có thể, xếp theo xác suất"
+    required: true
+    skip_if: null
+    inputs:
+      - error_signature
+      - affected_file
+    outputs:
+      - hypothesis_list      # Ordered list: [H1 (most likely), H2, H3]
+      - selected_hypothesis  # H1 unless evidence suggests otherwise
+    min_confidence: HIGH
+    actions:
+      - "List 3 nguyên nhân có thể gây ra triệu chứng này"
+      - "Xếp hạng theo xác suất dựa trên stack trace"
+      - "Chọn H1 để kiểm chứng trước"
+
+  - id: evidence
+    name: "Tìm bằng chứng xác nhận"
+    purpose: "Xác nhận hoặc loại bỏ hypothesis bằng code thực tế"
+    required: true
+    skip_if: null
+    inputs:
+      - selected_hypothesis
+      - affected_file
+    outputs:
+      - confirmed_root_cause   # File + line + quoted code
+      - evidence_quote         # Exact code causing the bug
+    min_confidence: HIGH
+    context_budget: 150
+    actions:
+      - "Dùng grep_search để tìm pattern liên quan"
+      - "Dùng view_file[StartLine:EndLine] để đọc section cụ thể"
+      - "Quote chính xác đoạn code gây bug"
+    exit_on_fail: PARTIAL
+
+  - id: patch
+    name: "Áp dụng fix"
+    purpose: "Sửa root cause, không chỉ patch triệu chứng"
+    required: true
+    skip_if: null
+    inputs:
+      - confirmed_root_cause
+      - evidence_quote
+    outputs:
+      - patched_files    # List of files modified
+      - diff_summary     # What changed and why
+    actions:
+      - "Edit source file trực tiếp với replace_file_content hoặc multi_replace_file_content"
+      - "Không tạo wrapper script"
+      - "Không dùng ?. hoặc ! để silence lỗi"
+      - "Fix root cause, không patch bề mặt"
+    human_checkpoint:
+      condition: "file thuộc vùng auth/payment/permission/migration"
+      message: "Patch này chạm vào code nhạy cảm. Xác nhận an toàn trước khi thay đổi."
+  - id: verify
+    name: "Xác minh fix + quality gate"
+    purpose: "Xác nhận bug đã được fix, không có regression, code đạt quality threshold"
+    required: true
+    skip_if: null
+    inputs:
+      - patched_files
+    outputs:
+      - verification_result   # PASS | FAIL | PARTIAL
+      - evidence_of_fix
+      - quality_gate_result   # PASS | FAIL
+    actions:
+      - "Re-read patched code section"
+      - "Chạy test liên quan nếu có"
+      - "Áp dụng shared quality gate → xem: .agents/workflows/shared/quality-gate.yml"
+      - "  Checklist: universal_checks + bug-resolution specific checks"
+      - "Ghi log execution trace vào evals/traces/"
+    exit_on_fail: FAILED
+
+escalation:
+  max_retries: 2
+  on_failure: "Report với full evidence chain (observe→hypothesis→evidence), escalate to human với gợi ý bước tiếp theo"
+
+# ── 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/code-review.yml

@@ -1,93 +1,127 @@
-name: code-review
-version: 8.0.0
-description: "Pipeline kiểm tra chất lượng code theo SOLID, DRY, Clean Code và ngưỡng số liệu cụ thể."
-
-owner:
-  type: engineering
-  maintained_by: qk-team
-
-verification_profile: review
-
-triggers:
-  - "review code"
-  - "review this"
-  - "đánh giá code"
-  - "kiểm tra chất lượng code"
-  - "check this PR"
-  - "pull request review"
-
-ide_binding:
-  slash_command: "/review"
-  aliases: ["/code-review", "/pr-review"]
-
-steps:
-  - id: scope
-    name: "Xác định phạm vi review"
-    purpose: "Biết chính xác files/modules cần review"
-    required: true
-    skip_if: "Files đã được chỉ định rõ ràng"
-    inputs:
-      - target_files_or_module
-    outputs:
-      - file_list
-      - review_focus    # bug, quality, security, performance, all
-    exit_on_fail: BLOCKED
-
-  - id: static_analysis
-    name: "Phân tích tĩnh"
-    purpose: "Thu thập findings có bằng chứng rõ ràng"
-    required: true
-    skip_if: null
-    inputs:
-      - file_list
-      - review_focus
-    outputs:
-      - findings         # Each: severity + file + line + quote + reason + suggestion
-    min_confidence: HIGH
-    context_budget: 150
-    actions:
-      - "Đọc từng file theo budget (max 150 lines per read)"
-      - "Flag SOLID violations với ngưỡng cụ thể"
-      - "Flag DRY violations (≥ 2 duplications)"
-      - "Flag naming violations"
-      - "Flag error handling issues"
-
-  - id: severity_triage
-    name: "Phân loại mức độ"
-    purpose: "Xếp findings theo priority để human biết fix gì trước"
-    required: true
-    skip_if: null
-    inputs:
-      - findings
-    outputs:
-      - critical_findings    # Must fix: security, data loss risk
-      - high_findings        # Should fix: logic bugs, architecture violations
-      - medium_findings      # Consider: quality improvements
-      - low_findings         # Optional: style, minor naming
-    actions:
-      - "Áp dụng severity matrix: CRITICAL > HIGH > MEDIUM > LOW"
-      - "Không inflate severity để look impressive"
-
-  - id: report
-    name: "Tổng hợp báo cáo"
-    purpose: "Cung cấp báo cáo actionable cho developer"
-    required: true
-    skip_if: null
-    inputs:
-      - critical_findings
-      - high_findings
-      - medium_findings
-    outputs:
-      - review_report    # Structured markdown report
-      - health_score     # 0-100
-    actions:
-      - "Group findings theo file"
-      - "Mỗi finding: file:line + code quote + explanation + suggestion"
-      - "Đánh giá mức độ tuân thủ R-C-09 (Zero-Slop)"
-      - "Đánh giá rủi ro R-SEC-04"
-      - "Ghi log execution trace vào evals/traces/"
-      - "Tính health score: 100 - (critical×20 + high×10 + medium×3 + low×1)"
-
-escalation:
-  max_retries: 1
-  on_failure: "Report partial findings với số files đã review / tổng"
+name: code-review
+version: 10.2.0
+platforms: [antigravity, claude, opencode]
+runtime_version: 1
+description: "Pipeline kiểm tra chất lượng code theo SOLID, DRY, Clean Code và ngưỡng số liệu cụ thể."
+
+owner:
+  type: engineering
+  maintained_by: qk-team
+
+verification_profile: review
+
+triggers:
+  - "review code"
+  - "review this"
+  - "đánh giá code"
+  - "kiểm tra chất lượng code"
+  - "check this PR"
+  - "pull request review"
+
+ide_binding:
+  slash_command: "/review"
+  aliases: ["/code-review", "/pr-review"]
+
+steps:
+  - id: scope
+    name: "Xác định phạm vi review"
+    purpose: "Biết chính xác files/modules cần review"
+    required: true
+    skip_if: "Files đã được chỉ định rõ ràng"
+    inputs:
+      - target_files_or_module
+    outputs:
+      - file_list
+      - review_focus    # bug, quality, security, performance, all
+    exit_on_fail: BLOCKED
+
+  - id: static_analysis
+    name: "Phân tích tĩnh"
+    purpose: "Thu thập findings có bằng chứng rõ ràng"
+    required: true
+    skip_if: null
+    inputs:
+      - file_list
+      - review_focus
+    outputs:
+      - findings         # Each: severity + file + line + quote + reason + suggestion
+    min_confidence: HIGH
+    context_budget: 150
+    actions:
+      - "Đọc từng file theo budget (max 150 lines per read)"
+      - "Flag SOLID violations với ngưỡng cụ thể"
+      - "Flag DRY violations (≥ 2 duplications)"
+      - "Flag naming violations"
+      - "Flag error handling issues"
+
+  - id: severity_triage
+    name: "Phân loại mức độ"
+    purpose: "Xếp findings theo priority để human biết fix gì trước"
+    required: true
+    skip_if: null
+    inputs:
+      - findings
+    outputs:
+      - critical_findings    # Must fix: security, data loss risk
+      - high_findings        # Should fix: logic bugs, architecture violations
+      - medium_findings      # Consider: quality improvements
+      - low_findings         # Optional: style, minor naming
+    actions:
+      - "Áp dụng severity matrix: CRITICAL > HIGH > MEDIUM > LOW"
+      - "Không inflate severity để look impressive"
+
+  - id: report
+    name: "Tổng hợp báo cáo"
+    purpose: "Cung cấp báo cáo actionable cho developer"
+    required: true
+    skip_if: null
+    inputs:
+      - critical_findings
+      - high_findings
+      - medium_findings
+    outputs:
+      - review_report    # Structured markdown report
+      - health_score     # 0-100
+    actions:
+      - "Group findings theo file"
+      - "Mỗi finding: file:line + code quote + explanation + suggestion"
+      - "Đánh giá mức độ tuân thủ R-C-09 (Zero-Slop)"
+      - "Đánh giá rủi ro R-SEC-04"
+      - "Ghi log execution trace vào evals/traces/"
+      - "Tính health score: 100 - (critical×20 + high×10 + medium×3 + low×1)"
+
+escalation:
+  max_retries: 1
+  on_failure: "Report partial findings với số files đã review / tổng"
+
+# ── 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]