ai-developer-skill-os 8.2.1 → 8.3.1

package/.agents/workflows/security-audit.yml

@@ -1,72 +1,115 @@
-name: security-audit
-description: "Workflow kiểm toán an toàn mã nguồn và chống xâm nhập (Security Audit)."
-version: 1.0.0
-
-steps:
-  - id: observe
-    name: "Observe System"
-    purpose: "Thu thập metadata về cấu trúc và các thành phần"
-    required: true
-    inputs: [source_code]
-    outputs: [system_context]
-    actions:
-      - "Xác định tech stack, boundaries và các third-party libs"
-
-  - id: dependency_scan
-    name: "Dependency Scan"
-    purpose: "Kiểm tra rủi ro từ package bên ngoài"
-    required: true
-    inputs: [system_context, package_files]
-    outputs: [dependency_vulnerabilities]
-    actions:
-      - "Kiểm tra version cũ, thư viện có CVE"
-
-  - id: secret_scan
-    name: "Secret Scan"
-    purpose: "Tìm kiếm thông tin nhạy cảm bị rò rỉ"
-    required: true
-    inputs: [source_code]
-    outputs: [leaked_secrets]
-    actions:
-      - "Quét hardcoded API keys, tokens, passwords trong code"
-
-  - id: permission_review
-    name: "Permission Review"
-    purpose: "Rà soát mô hình phân quyền và RBAC"
-    required: true
-    inputs: [system_context, access_control_code]
-    outputs: [permission_flaws]
-    actions:
-      - "Kiểm tra nguyên tắc least privilege"
-      - "Tìm lỗ hổng authentication/authorization bypass"
-
-  - id: risk_classification
-    name: "Risk Classification"
-    purpose: "Đánh giá mức độ nghiêm trọng"
-    required: true
-    inputs: [dependency_vulnerabilities, leaked_secrets, permission_flaws]
-    outputs: [classified_risks]
-    actions:
-      - "Phân loại LOW/MEDIUM/HIGH/CRITICAL"
-
-  - id: recommendation
-    name: "Recommendation"
-    purpose: "Đề xuất giải pháp khắc phục"
-    required: true
-    inputs: [classified_risks]
-    outputs: [security_report]
-    actions:
-      - "Tạo báo cáo chi tiết kèm actionable steps"
-
-  - id: verify
-    name: "Verify Fixes"
-    purpose: "Đảm bảo lỗ hổng đã được vá"
-    required: false
-    inputs: [source_code, security_report]
-    outputs: [final_audit_status]
-    actions:
-      - "Check lại các vị trí đã report"
-
-escalation:
-  max_retries: 0
-  on_failure: "Báo động đỏ (CRITICAL) nếu phát hiện secret leak"
+name: security-audit
+version: 8.0.0
+description: "Workflow kiểm toán an toàn mã nguồn và chống xâm nhập (Security Audit)."
+
+owner:
+  type: security
+  maintained_by: qk-team
+
+verification_profile: security-audit
+
+triggers:
+  - "security audit"
+  - "kiểm toán bảo mật"
+  - "check for vulnerabilities"
+  - "scan for secrets"
+  - "is this secure"
+  - "audit an toàn"
+
+ide_binding:
+  slash_command: "/security-audit"
+  aliases: ["/audit", "/sec-scan"]
+
+steps:
+  - id: observe
+    name: "Observe System"
+    purpose: "Thu thập metadata về cấu trúc và các thành phần"
+    required: true
+    inputs:
+      - source_code
+    outputs:
+      - system_context
+    actions:
+      - "Xác định tech stack, boundaries và các third-party libs"
+
+  - id: dependency_scan
+    name: "Dependency Scan"
+    purpose: "Kiểm tra rủi ro từ package bên ngoài"
+    required: true
+    inputs:
+      - system_context
+      - package_files
+    outputs:
+      - dependency_vulnerabilities
+    actions:
+      - "Kiểm tra version cũ, thư viện có CVE"
+
+  - id: secret_scan
+    name: "Secret Scan"
+    purpose: "Tìm kiếm thông tin nhạy cảm bị rò rỉ"
+    required: true
+    inputs:
+      - source_code
+    outputs:
+      - leaked_secrets
+    actions:
+      - "Quét hardcoded API keys, tokens, passwords trong code"
+
+  - id: permission_review
+    name: "Permission Review"
+    purpose: "Rà soát mô hình phân quyền và RBAC"
+    required: true
+    inputs:
+      - system_context
+      - access_control_code
+    outputs:
+      - permission_flaws
+    actions:
+      - "Kiểm tra nguyên tắc least privilege"
+      - "Tìm lỗ hổng authentication/authorization bypass"
+
+  - id: risk_classification
+    name: "Risk Classification"
+    purpose: "Đánh giá mức độ nghiêm trọng"
+    required: true
+    inputs:
+      - dependency_vulnerabilities
+      - leaked_secrets
+      - permission_flaws
+    outputs:
+      - classified_risks
+    actions:
+      - "Phân loại LOW/MEDIUM/HIGH/CRITICAL"
+
+  - id: recommendation
+    name: "Recommendation"
+    purpose: "Đề xuất giải pháp khắc phục"
+    required: true
+    inputs:
+      - classified_risks
+    outputs:
+      - security_report
+    actions:
+      - "Tạo báo cáo chi tiết kèm actionable steps"
+      - "Đề xuất giải pháp phải enforce R-SEC-04"
+    human_checkpoint:
+      condition: "classified_risks chứa bất kỳ mục nào ở mức CRITICAL"
+      message: "Phát hiện lỗ hổng CRITICAL. Xác nhận trước khi tiến hành áp dụng fix."
+  - id: verify
+    name: "Verify Fixes"
+    purpose: "Đảm bảo lỗ hổng đã được vá"
+    required: true
+    skip_if: "Không có remediation nào được apply trong phiên làm việc này"
+    inputs:
+      - source_code
+      - security_report
+    outputs:
+      - final_audit_status
+    actions:
+      - "Check lại các vị trí đã report"
+      - "Ghi log execution trace vào evals/traces/"
+    exit_on_fail: PARTIAL
+
+escalation:
+  max_retries: 0
+  on_failure: "Báo động đỏ (CRITICAL) nếu phát hiện secret leak"

package/.agents/workflows/skill-evolution.yml

@@ -1,65 +1,97 @@
-name: skill-evolution
-description: "Workflow vòng lặp tiến hóa và tối ưu hóa skill (Skill Evolution)."
-version: 1.0.0
-
-steps:
-  - id: observe_usage
-    name: "Observe Usage"
-    purpose: "Theo dõi cách skill được sử dụng"
-    required: true
-    inputs: [skill_logs]
-    outputs: [usage_metrics]
-    actions:
-      - "Thống kê trigger rate và token usage"
-
-  - id: measure_success
-    name: "Measure Success"
-    purpose: "Đánh giá tỷ lệ thành công"
-    required: true
-    inputs: [usage_metrics, execution_results]
-    outputs: [success_rate]
-    actions:
-      - "Xác định các lần exit SUCCESS vs FAILED/PARTIAL"
-
-  - id: detect_failure
-    name: "Detect Failure Patterns"
-    purpose: "Phát hiện lý do thất bại"
-    required: true
-    inputs: [execution_results]
-    outputs: [failure_patterns]
-    actions:
-      - "Phân tích log lỗi, hallucination, out of budget"
-
-  - id: improve_skill
-    name: "Improve Skill"
-    purpose: "Đề xuất tối ưu skill"
-    required: true
-    inputs: [failure_patterns, skill_body]
-    outputs: [improved_skill_proposal]
-    actions:
-      - "Giảm noise trong instruction"
-      - "Cập nhật examples và learnings"
-      - "Tinh chỉnh token budget"
-
-  - id: validate_improvement
-    name: "Validate Improvement"
-    purpose: "Xác thực bản nâng cấp"
-    required: true
-    inputs: [improved_skill_proposal]
-    outputs: [validation_result]
-    actions:
-      - "Chạy qua validate-skills.js"
-      - "Kiểm tra schema compliance"
-
-  - id: promote
-    name: "Promote Skill"
-    purpose: "Đưa bản cải tiến vào sử dụng"
-    required: true
-    inputs: [validation_result]
-    outputs: [stable_skill]
-    actions:
-      - "Chuyển status thành stable"
-
-escalation:
-  max_retries: 1
-  on_failure: "Hủy bỏ bản cải tiến nếu validation thất bại"
+name: skill-evolution
+version: 8.0.0
+description: "Workflow vòng lặp tiến hóa và tối ưu hóa skill (Skill Evolution)."
+
+owner:
+  type: engineering
+  maintained_by: qk-team
+
+verification_profile: skill-evolution
+
+triggers:
+  - "improve this skill"
+  - "tối ưu skill"
+  - "why does this skill keep failing"
+  - "optimize this workflow"
+  - "phân tích usage skill"
+
+ide_binding:
+  slash_command: "/evolve-skill"
+  aliases: ["/skill-tune"]
+
+steps:
+  - id: observe_usage
+    name: "Observe Usage"
+    purpose: "Theo dõi cách skill được sử dụng"
+    required: true
+    inputs:
+      - skill_logs
+    outputs:
+      - usage_metrics
+    actions:
+      - "Thống kê trigger rate và token usage"
+
+  - id: measure_success
+    name: "Measure Success"
+    purpose: "Đánh giá tỷ lệ thành công"
+    required: true
+    inputs:
+      - usage_metrics
+      - execution_results
+    outputs:
+      - success_rate
+    actions:
+      - "Xác định các lần exit SUCCESS vs FAILED/PARTIAL"
+
+  - id: detect_failure
+    name: "Detect Failure Patterns"
+    purpose: "Phát hiện lý do thất bại"
+    required: true
+    inputs:
+      - execution_results
+    outputs:
+      - failure_patterns
+    actions:
+      - "Phân tích log lỗi, hallucination, out of budget"
+
+  - id: improve_skill
+    name: "Improve Skill"
+    purpose: "Đề xuất tối ưu skill"
+    required: true
+    inputs:
+      - failure_patterns
+      - skill_body
+    outputs:
+      - improved_skill_proposal
+    actions:
+      - "Giảm noise trong instruction"
+      - "Cập nhật examples và learnings"
+      - "Tinh chỉnh token budget"
+
+  - id: validate_improvement
+    name: "Validate Improvement"
+    purpose: "Xác thực bản nâng cấp"
+    required: true
+    inputs:
+      - improved_skill_proposal
+    outputs:
+      - validation_result
+    actions:
+      - "Chạy qua validate-skills.js"
+      - "Đảm bảo skill không vi phạm R-C-09"
+      - "Kiểm tra schema compliance"
+
+  - id: promote
+    name: "Promote Skill"
+    purpose: "Đưa bản cải tiến vào sử dụng"
+    required: true
+    inputs:
+      - validation_result
+    outputs:
+      - stable_skill
+    actions:
+      - "Chuyển status thành stable"
+
+escalation:
+  max_retries: 1
+  on_failure: "Hủy bỏ bản cải tiến nếu validation thất bại"

package/.agents/workflows/spec-driven-development.yml

@@ -1,57 +1,87 @@
-name: spec-driven-development
-description: "Workflow phát triển dựa trên đặc tả (Specification-Driven Development)."
-version: 1.0.0
-
-steps:
-  - id: clarify_requirement
-    name: "Clarify Requirements"
-    purpose: "Làm rõ yêu cầu từ ý tưởng ban đầu"
-    required: true
-    inputs: [user_idea]
-    outputs: [clarified_requirement]
-    actions:
-      - "Hỏi các câu hỏi làm rõ scope và constraints"
-      - "Xác định rõ outcome mong muốn"
-
-  - id: create_spec
-    name: "Create Specification"
-    purpose: "Viết tài liệu đặc tả kỹ thuật"
-    required: true
-    inputs: [clarified_requirement]
-    outputs: [technical_spec]
-    actions:
-      - "Thiết kế API contracts, data models"
-      - "Xác định UI/UX heuristics"
-      - "Xác định edge cases"
-
-  - id: create_plan
-    name: "Create Plan"
-    purpose: "Lên kế hoạch triển khai"
-    required: true
-    inputs: [technical_spec]
-    outputs: [implementation_plan]
-    actions:
-      - "Chia nhỏ spec thành các task cụ thể"
-      - "Đánh giá rủi ro và thứ tự ưu tiên"
-
-  - id: implement
-    name: "Implement"
-    purpose: "Triển khai mã nguồn"
-    required: true
-    inputs: [implementation_plan, technical_spec]
-    outputs: [source_code]
-    actions:
-      - "Code theo đúng spec"
-
-  - id: verify
-    name: "Verify Implementation"
-    purpose: "Kiểm tra mã nguồn với đặc tả"
-    required: true
-    inputs: [source_code, technical_spec]
-    outputs: [verification_result]
-    actions:
-      - "Đối chiếu kết quả code với acceptance criteria"
-
-escalation:
-  max_retries: 2
-  on_failure: "Báo cáo lệch spec và xin chỉ thị"
+name: spec-driven-development
+version: 8.0.0
+description: "Workflow phát triển dựa trên đặc tả (Specification-Driven Development)."
+
+owner:
+  type: engineering
+  maintained_by: qk-team
+
+verification_profile: spec-driven
+
+triggers:
+  - "write a spec"
+  - "viết đặc tả"
+  - "spec this out"
+  - "design before implementing"
+  - "technical spec for"
+
+ide_binding:
+  slash_command: "/spec"
+  aliases: ["/spec-driven"]
+
+steps:
+  - id: clarify_requirement
+    name: "Clarify Requirements"
+    purpose: "Làm rõ yêu cầu từ ý tưởng ban đầu"
+    required: true
+    inputs:
+      - user_idea
+    outputs:
+      - clarified_requirement
+    actions:
+      - "Hỏi các câu hỏi làm rõ scope và constraints"
+      - "Xác định rõ outcome mong muốn"
+
+  - id: create_spec
+    name: "Create Specification"
+    purpose: "Viết tài liệu đặc tả kỹ thuật"
+    required: true
+    inputs:
+      - clarified_requirement
+    outputs:
+      - technical_spec
+    actions:
+      - "Thiết kế API contracts, data models"
+      - "Xác định UI/UX heuristics"
+      - "Spec phải quy định rõ boundary validation (R-SEC-04)"
+      - "Xác định edge cases"
+
+  - id: create_plan
+    name: "Create Plan"
+    purpose: "Lên kế hoạch triển khai"
+    required: true
+    inputs:
+      - technical_spec
+    outputs:
+      - implementation_plan
+    actions:
+      - "Chia nhỏ spec thành các task cụ thể"
+      - "Đánh giá rủi ro và thứ tự ưu tiên"
+
+  - id: implement
+    name: "Implement"
+    purpose: "Triển khai mã nguồn"
+    required: true
+    inputs:
+      - implementation_plan
+      - technical_spec
+    outputs:
+      - source_code
+    actions:
+      - "Code theo đúng spec"
+
+  - id: verify
+    name: "Verify Implementation"
+    purpose: "Kiểm tra mã nguồn với đặc tả"
+    required: true
+    inputs:
+      - source_code
+      - technical_spec
+    outputs:
+      - verification_result
+    actions:
+      - "Đối chiếu kết quả code với acceptance criteria"
+
+escalation:
+  max_retries: 2
+  on_failure: "Báo cáo lệch spec và xin chỉ thị"

package/CHANGELOG.md

@@ -5,6 +5,33 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 
 ---
 
+## [8.3.1] — 2026-07 — EDAOS v8.3.1: Eval Pipeline & Agentic Governance
+
+### Added
+- **evals/runner.js**: Automated evaluation pipeline script to parse `scorecard.yaml`, run linting, verify agent traces, and calculate total scores against thresholds.
+- **Eval Scripts**: Added `npm run eval` and `npm run eval:all` in `package.json` for running automated validations.
+- **Scorecards**: Created comprehensive, quantitative AI-eval `evals/scorecard.yaml` for all 31 standard skills.
+- **.agents/rules/anti-patterns.md (R-C-09)**: Strict global rule prohibiting AI-slop, God Files, Circular Dependencies, and poor code quality practices.
+
+## [8.3.0] — 2026-07 — EDAOS v8.3: Design System, IDE Config & Infrastructure Fixes
+
+### Added
+- **DESIGN.md**: Design system contract with HSL color tokens, spacing scale, typography, border radius, shadows, animation tokens, dark mode support, and z-index layers
+- **vite.config.js**: Vitest configuration with coverage (v8 provider), reporter setup, and test isolation
+- **bin/lint.js**: Lint script for validating SKILL.md spec compliance, workflow structure, and rule files
+- **.kilo/kilo.json**: Kilo IDE configuration with project paths, commands, agent model settings, and skin design token reference
+- **.kilo/command/ and .kilo/agent/ directories**: Standardized Kilo command and agent configuration directories
+- **qk-context-loader/references/**: Loading patterns document for context dependency graph construction
+
+### Fixed
+- **.agentsignore**: Removed `schemas/` from rogue artifacts list; legitimate schema files at `.agents/docs/schemas/` are now accessible to AI agents
+- **ADR-008 renamed to ADR-005**: Corrected decision sequence to remove gap between ADR-004 and ADR-005
+- **qk-design-system-engineering status**: Changed from `experimental` to `stable` to reflect full V8.2 review compliance
+- **Source .agentsignore**: Fixed same `schemas/` issue in root `.agentsignore` (not just worktree copy)
+
+### Removed
+- **Legacy agent-skills dirs**: Removed obsolete `khanhmcp-server/agent-skills-eval/` and `khanhmcp-server/agent-skills-tool/` directories (pre-V8 artifacts)
+
 ## [8.2.1] — 2026-07 — Token Optimization Patch
 
 ### Fixed