ai-developer-skill-os 10.1.0 → 10.2.0

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]

package/.agents/workflows/context-discovery.yml

@@ -1,94 +1,128 @@
-name: context-discovery
-version: 9.2.0
-description: "Pipeline load context dự án và vẽ dependency graph trước khi thực hiện task — ngăn hallucination kiến trúc."
-
-owner:
-  type: engineering
-  maintained_by: qk-team
-
-verification_profile: review
-
-triggers:
-  - "load context"
-  - "tìm hiểu codebase"
-  - "explore architecture"
-  - "explain the codebase"
-  - "trace dependency"
-  - "hiểu project"
-  - "which skill should i use"
-  - "help me choose"
-
-ide_binding:
-  slash_command: "/discover"
-  aliases: ["/context", "/explore", "/research"]
-
-steps:
-  - id: define_scope
-    name: "Xác định phạm vi cần khám phá"
-    purpose: "Biết chính xác cần tìm hiểu gì để phục vụ task tiếp theo"
-    required: true
-    inputs:
-      - task_goal            # Task người dùng muốn làm sau context load
-    outputs:
-      - discovery_questions  # Các câu hỏi cụ thể cần trả lời
-      - entry_points         # Files/folders bắt đầu đọc
-    actions:
-      - "Đặt 3-5 câu hỏi cụ thể cần trả lời (không đọc mọi thứ)"
-      - "Ưu tiên: package.json / go.mod / pyproject.toml → biết stack"
-      - "Sau đó: src/ structure → biết architecture pattern"
-    exit_on_fail: BLOCKED
-
-  - id: detect_stack
-    name: "Phát hiện Stack & Architecture"
-    purpose: "Xác định tech stack, project type, và conventions đang dùng"
-    required: true
-    inputs:
-      - entry_points
-    outputs:
-      - detected_stack       # language, framework, DB, CSS, test runner...
-      - project_type         # web-app / api / data-pipeline / monorepo / ai-agent
-      - architecture_pattern # feature-based / domain / layered / atomic
-    actions:
-      - "Đọc package.json / requirements.txt / go.mod / Cargo.toml"
-      - "Đọc cấu trúc thư mục src/ (1 level sâu)"
-      - "Tìm config files: tsconfig, prisma/schema, docker-compose, .env.example"
-      - "Đọc tối đa 2-3 file entry point để xác nhận pattern"
-
-  - id: map_dependencies
-    name: "Vẽ Dependency Map"
-    purpose: "Hiểu component nào phụ thuộc vào component nào"
-    required: false
-    skip_if: "Task không cần hiểu cross-component dependencies"
-    inputs:
-      - detected_stack
-      - entry_points
-    outputs:
-      - dependency_map       # Key components + their relationships
-      - critical_paths       # Paths hay bị ảnh hưởng khi thay đổi
-    context_budget: 100
-    actions:
-      - "Dùng grep_search để trace imports, không đọc toàn bộ file"
-      - "Đọc targeted sections (≤ 100 lines per read)"
-      - "Ghi lại circular deps hay God File nếu phát hiện"
-
-  - id: synthesize
-    name: "Tổng hợp Context"
-    purpose: "Đóng gói kết quả sẵn sàng inject vào skill thực thi tiếp theo"
-    required: true
-    inputs:
-      - detected_stack
-      - dependency_map
-      - discovery_questions
-    outputs:
-      - context_summary      # Stack + Architecture + Key files
-      - skill_recommendation # Skill phù hợp nhất cho task hiện tại
-      - warnings             # Deprecated patterns, risks, anti-patterns phát hiện
-    actions:
-      - "Viết summary dạng bullet (không dài hơn 10 dòng)"
-      - "Đề xuất skill phù hợp nhất nếu chưa được chọn"
-      - "Flag pattern cũ hoặc vi phạm convention"
-      - "Ghi log execution trace vào evals/traces/ nếu có"
-
-escalation:
-  max_retries: 1
-  on_failure: "Report partial findings với confidence level, list files chưa đọc được"
+name: context-discovery
+version: 10.2.0
+platforms: [antigravity, claude, opencode]
+runtime_version: 1
+description: "Pipeline load context dự án và vẽ dependency graph trước khi thực hiện task — ngăn hallucination kiến trúc."
+
+owner:
+  type: engineering
+  maintained_by: qk-team
+
+verification_profile: review
+
+triggers:
+  - "load context"
+  - "tìm hiểu codebase"
+  - "explore architecture"
+  - "explain the codebase"
+  - "trace dependency"
+  - "hiểu project"
+  - "which skill should i use"
+  - "help me choose"
+
+ide_binding:
+  slash_command: "/discover"
+  aliases: ["/context", "/explore", "/research"]
+
+steps:
+  - id: define_scope
+    name: "Xác định phạm vi cần khám phá"
+    purpose: "Biết chính xác cần tìm hiểu gì để phục vụ task tiếp theo"
+    required: true
+    inputs:
+      - task_goal            # Task người dùng muốn làm sau context load
+    outputs:
+      - discovery_questions  # Các câu hỏi cụ thể cần trả lời
+      - entry_points         # Files/folders bắt đầu đọc
+    actions:
+      - "Đặt 3-5 câu hỏi cụ thể cần trả lời (không đọc mọi thứ)"
+      - "Ưu tiên: package.json / go.mod / pyproject.toml → biết stack"
+      - "Sau đó: src/ structure → biết architecture pattern"
+    exit_on_fail: BLOCKED
+
+  - id: detect_stack
+    name: "Phát hiện Stack & Architecture"
+    purpose: "Xác định tech stack, project type, và conventions đang dùng"
+    required: true
+    inputs:
+      - entry_points
+    outputs:
+      - detected_stack       # language, framework, DB, CSS, test runner...
+      - project_type         # web-app / api / data-pipeline / monorepo / ai-agent
+      - architecture_pattern # feature-based / domain / layered / atomic
+    actions:
+      - "Đọc package.json / requirements.txt / go.mod / Cargo.toml"
+      - "Đọc cấu trúc thư mục src/ (1 level sâu)"
+      - "Tìm config files: tsconfig, prisma/schema, docker-compose, .env.example"
+      - "Đọc tối đa 2-3 file entry point để xác nhận pattern"
+
+  - id: map_dependencies
+    name: "Vẽ Dependency Map"
+    purpose: "Hiểu component nào phụ thuộc vào component nào"
+    required: false
+    skip_if: "Task không cần hiểu cross-component dependencies"
+    inputs:
+      - detected_stack
+      - entry_points
+    outputs:
+      - dependency_map       # Key components + their relationships
+      - critical_paths       # Paths hay bị ảnh hưởng khi thay đổi
+    context_budget: 100
+    actions:
+      - "Dùng grep_search để trace imports, không đọc toàn bộ file"
+      - "Đọc targeted sections (≤ 100 lines per read)"
+      - "Ghi lại circular deps hay God File nếu phát hiện"
+
+  - id: synthesize
+    name: "Tổng hợp Context"
+    purpose: "Đóng gói kết quả sẵn sàng inject vào skill thực thi tiếp theo"
+    required: true
+    inputs:
+      - detected_stack
+      - dependency_map
+      - discovery_questions
+    outputs:
+      - context_summary      # Stack + Architecture + Key files
+      - skill_recommendation # Skill phù hợp nhất cho task hiện tại
+      - warnings             # Deprecated patterns, risks, anti-patterns phát hiện
+    actions:
+      - "Viết summary dạng bullet (không dài hơn 10 dòng)"
+      - "Đề xuất skill phù hợp nhất nếu chưa được chọn"
+      - "Flag pattern cũ hoặc vi phạm convention"
+      - "Ghi log execution trace vào evals/traces/ nếu có"
+
+escalation:
+  max_retries: 1
+  on_failure: "Report partial findings với confidence level, list files chưa đọc được"
+
+# ── 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]